buttonInput: Button and link inputs
In yonder: A Reactive Web Framework Built on 'shiny'

Description Usage Arguments Details See Also Examples

Button inputs are useful as triggers for reactive or observer expressions. The reactive value of a button input begins as NULL, but subsequently is the number of clicks.

buttonInput(id, label, ..., stretch = FALSE, download = FALSE, tooltip = NULL)

updateButtonInput(
  id,
  label = NULL,
  value = NULL,
  disable = NULL,
  enable = NULL,
  tooltip = NULL,
  session = getDefaultReactiveDomain()
)

linkInput(id, label, ..., stretch = FALSE, download = FALSE, tooltip = NULL)

updateLinkInput(
  id,
  label = NULL,
  value = NULL,
  enable = NULL,
  disable = NULL,
  tooltip = NULL,
  session = getDefaultReactiveDomain()
)

tooltip(..., placement = "top", fade = TRUE)

`id`	A character string specifying the id of the reactive input.
`label`	A character string specifying the label text on the button or link input.
`...`	Additional named arguments passed as HTML attributes to the parent element.
`stretch`	One of `TRUE` or `FALSE` specifying stretched behaviour for the button or link input, defaults to `FALSE`. If `TRUE`, the button or link will receive clicks from its containing block element. For example, a stretched button or link inside a `card()` would update whenever the user clicked on the card.
`download`	One of `TRUE` or `FALSE` specifying if the button or link input is used to trigger a download, defaults to `FALSE`.
`tooltip`	A call to `tooltip()` specifying a tooltip for the button or link input, defaults to `NULL`.
`value`	A number specifying a new value for the button, defaults to `NULL`.
`disable`	if `TRUE` the button is disabled and will not react to clicks from the user, default to `NULL`.
`enable`	If `TRUE` the button is enabled and will react to clicks from the user, defaults to `NULL`.
`session`	A reactive context, defaults to `getDefaultReactiveDomain()`.
`placement`	One of `"top"`, `"right"`, `"bottom"`, or `"left"` specifying what side of the tag element the tooltip appears on.
`fade`	One of `TRUE` or `FALSE` specifying if the tooltip fades in when shown and fades out when hidden, defaults to `TRUE`.

Tooltips

To remove a button or link input's tooltip pass an empty tooltip, tooltip(), to updateButtonInput() or updateLinkInput().

Other inputs: buttonGroupInput(), checkbarInput(), checkboxInput(), chipInput(), fileInput(), formInput(), listGroupInput(), menuInput(), navInput(), radioInput(), radiobarInput(), rangeInput(), selectInput(), textInput()

### A simple button

buttonInput(
  id = "button1",
  label = "Simple"
)

# Alternatively, a button can fill the width of its parent element.

buttonInput(
  id = "button2",
  label = "Full-width",
  fill = TRUE  # <-
) %>%
  background("red")

# Use design utilities to further adjust the width of a button.

buttonInput(
  id = "button3",
  label = "Full and back again",
  fill = TRUE  # <-
) %>%
  background("red") %>%
  width("3/4")  # <-

### Possible colors

colors <- c(
  "red", "purple", "indigo", "blue", "cyan", "teal", "green",
  "yellow", "amber", "orange", "grey"
)

lapply(
  colors,
  function(color) {
    buttonInput(
      id = color,
      label = color
    ) %>%
      background(color) %>%
      margin(2)
  }
) %>%
  div() %>%
  display("flex") %>%
  flex(wrap = TRUE)

### Reactive links

div("Curabitur ", linkInput("link1", "vulputate"), " vestibulum lorem.")

### Stretched buttons and links

card(
  header = "Card with stretched button",
  p("Notice when you hover over the card, the button also detects ",
    "the hover."),
  buttonInput(
    id = "go",
    label = "Go go go",
    stretch = TRUE
  ) %>%
    background("blue")
) %>%
  width(20)

### Download button

buttonInput(
  download = TRUE,
  id = "download1",
  label = "Download",
  icon("download")
)