Description Usage Arguments Details Value See Also Examples
Create a submit button for an app. Apps that include a submit
button do not automatically update their outputs when inputs change,
rather they wait until the user explicitly clicks the submit button.
The use of submitButton
is generally discouraged in favor of
the more versatile actionButton
(see details below).
1 |
text |
Button caption |
icon |
Optional |
width |
The width of the button, e.g. |
Submit buttons are unusual Shiny inputs, and we recommend using
actionButton
instead of submitButton
when you
want to delay a reaction.
See this
article for more information (including a demo of how to "translate"
code using a submitButton
to code using an actionButton
).
In essence, the presence of a submit button stops all inputs from
sending their values automatically to the server. This means, for
instance, that if there are two submit buttons in the same app,
clicking either one will cause all inputs in the app to send their
values to the server. This is probably not what you'd want, which is
why submit button are unwieldy for all but the simplest apps. There
are other problems with submit buttons: for example, dynamically
created submit buttons (for example, with renderUI
or insertUI
) will not work.
A submit button that can be added to a UI definition.
Other input elements: actionButton
,
checkboxGroupInput
,
checkboxInput
, dateInput
,
dateRangeInput
, fileInput
,
numericInput
, passwordInput
,
radioButtons
, selectInput
,
sliderInput
, textAreaInput
,
textInput
, varSelectInput
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | if (interactive()) {
shinyApp(
ui = basicPage(
numericInput("num", label = "Make changes", value = 1),
submitButton("Update View", icon("refresh")),
helpText("When you click the button above, you should see",
"the output below update to reflect the value you",
"entered at the top:"),
verbatimTextOutput("value")
),
server = function(input, output) {
# submit buttons do not have a value of their own,
# they control when the app accesses values of other widgets.
# input$num is the value of the number widget.
output$value <- renderPrint({ input$num })
}
)
}
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.