shinyApp
shinyApp(ui = NULL, server = NULL, onStart = NULL, options = list(),
uiPattern = "/")
shinyAppDir(appDir, options = list())
as.shiny.appobj(x)
# S3 method for shiny.appobj
as.shiny.appobj(x)
# S3 method for list
as.shiny.appobj(x)
# S3 method for character
as.shiny.appobj(x)
is.shiny.appobj(x)
# S3 method for shiny.appobj
print(x, ...)
# S3 method for shiny.appobj
as.tags(x, ...)
Arguments
ui | The UI definition of the app (for example, a call to
fluidPage() with nested controls) |
---|---|
server | A server function |
onStart | A function that will be called before the app is actually run.
This is only needed for shinyAppObj , since in the shinyAppDir
case, a global.R file can be used for this purpose. |
options | Named options that should be passed to the `runApp` call. You
can also specify width and height parameters which provide a
hint to the embedding environment about the ideal height/width for the app. |
uiPattern | A regular expression that will be applied to each GET
request to determine whether the ui should be used to handle the
request. Note that the entire request path must match the regular
expression in order for the match to be considered successful. |
appDir | Path to directory that contains a Shiny app (i.e. a server.R file and either ui.R or www/index.html) |
x | Object to convert to a Shiny app. |
... | Additional parameters to be passed to print. |
Value
-
An object that represents the app. Printing the object or passing it
to
runApp
will run the app.
Description
These functions create Shiny app objects from either an explicit UI/server
pair (shinyApp
), or by passing the path of a directory that contains a
Shiny app (shinyAppDir
). You generally shouldn't need to use these
functions to create/run applications; they are intended for interoperability
purposes, such as embedding Shiny apps inside a knitr document.
Details
Normally when this function is used at the R console, the Shiny app object is
automatically passed to the print()
function, which runs the app. If
this is called in the middle of a function, the value will not be passed to
print()
and the app will not be run. To make the app run, pass the app
object to print()
or runApp()
.
Examples
## Only run this example in interactive R sessions
if (interactive()) {
shinyApp(
ui = fluidPage(
numericInput("n", "n", 1),
plotOutput("plot")
),
server = function(input, output) {
output$plot <- renderPlot( plot(head(cars, input$n)) )
}
)
shinyAppDir(system.file("examples/01_hello", package="shiny"))
# The object can be passed to runApp()
app <- shinyApp(
ui = fluidPage(
numericInput("n", "n", 1),
plotOutput("plot")
),
server = function(input, output) {
output$plot <- renderPlot( plot(head(cars, input$n)) )
}
)
runApp(app)
}