yonder (version 0.1.0)

chipInput: Chip input, selectize alternative

Description

The chip input is a selectize alternative. Choices are selected from a dropdown menu and appear as chips below the input's text box. Chips do not appear in the order they are selected. Instead chips are shown in the order specified by the choices argument. Use the max argument to limit the number of choices a user may select.

Usage

chipInput(id, choices, values = choices, selected = NULL, ...,
  max = NULL, inline = TRUE)

Arguments

id

A character string specifying the id of the reactive input.

choices

A character vector or list specifying the possible choices.

values

A character vector or list of strings specifying the input's values, defaults to choices.

selected

One or more of values specifying which values are selected by default.

...

Additional named arguments passed as HTML attributes to the parent element.

max

A number specifying the maximum number of items a user may select.

inline

One of TRUE or FALSE specifying if chips are rendered inline. If TRUE multiple chips may fit onto a single row, otherwise, if FALSE, chips expand to fill the width of their parent element, one chip per row.

<strong>Example</strong> simple application

ui <- container(
  chipInput(
    id = "chips",
    choices = paste("Option number", 1:10),
    values = 1:10,
    inline = TRUE
  ) %>%
    width("1/2")
)
server <- function(input, output) {
}
shinyApp(ui, server)

<strong>Example</strong> inline chips

ui <- container(
  chipInput(
    id = "chips",
    choices = c(
      "A rather long option, isn't it?",
      "Shorter",
      "A middle-size option",
      "One more"
    ),
    values = 1:4,
    fill = FALSE
  ) %>%
    width("1/2") %>%
    background("blue") %>%
    shadow("small")
)
server <- function(input, output) {
}
shinyApp(ui, server)

See Also

Other inputs: buttonGroupInput, buttonInput, checkboxInput, fileInput, formInput, groupInput, listGroupInput, menuInput, navInput, radioInput, rangeInput, selectInput, sliderInput, textInput

Examples

# NOT RUN {
### Default input

chipInput(
  id = "chip1",
  choices = paste("Choice", 1:5)
)

# }