chipInput: Chip inputs

View source: R/input-chip.R

chipInputR Documentation

Chip inputs

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 = NULL,
  values = choices,
  selected = NULL,
  ...,
  placeholder = NULL,
  max = Inf,
  inline = TRUE,
  sort = "stack"
)

updateChipInput(
  id,
  choices = NULL,
  values = choices,
  selected = NULL,
  max = NULL,
  enable = NULL,
  disable = NULL,
  session = getDefaultReactiveDomain()
)

Arguments

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.

placeholder

A character string specifying placeholder text of the chip input, defaults to NULL.

max

A number specifying the maximum number of items a user may select, defaults to Inf.

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.

sort

One of "stack", "queue", or "fixed" specifying how selected chips are ordered, defaults to "stack".

"stack", selected chips are placed ahead of other selected chips.

"queue", selected chips are placed behind other selected chips.

"fixed", selected chips appear in the order specified by choices and values. Use "fixed" and sort choices to keep selected chips in the same sorted order.

See Also

Other inputs: checkbarInput(), fileInput(), formInput(), input_button(), input_checkbox(), listGroupInput(), menuInput(), radioInput(), radiobarInput(), rangeInput(), selectInput(), textInput()


nteetor/yonder documentation built on June 12, 2025, 3:49 a.m.