listGroupInput: List group inputs

In nteetor/dull: A Reactive Web Framework Built on 'shiny'

List group inputs

Description

List group inputs are an actionable list of items. They behave similarly to checkboxes or radios, that is, users may select one or more items from the list. However, list group items may include highly variable content.

Usage

listGroupInput(
  ...,
  id,
  choices = NULL,
  values = choices,
  selected = NULL,
  layout = "vertical",
  flush = FALSE
)

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

Arguments

...	Additional named arguments passed as HTML attributes to the parent element or tag elements passed as child elements to the parent element.
id	A character string specifying the id of the reactive input.
choices	A vector of character strings or list of tag elements specifying the content of the list group's items.
values	A character vector specifying the values of the list items, defaults to choices.
selected	One or more of values specifying which choices are selected by default, defaults to NULL, in which case no choice is selected.
layout	A responsive argument. One of "vertical" or "horizontal" specifying how list items are laid out, defaults to "vertical". Note, if layout is "horizontal" and the flush argument is ignored.
flush	One of TRUE or FALSE specifying if the list group is rendered without an outside border, defaults to FALSE. Removing the list group border is useful when rendering a list group inside a custom parent container, e.g. inside a card().
enable	One of values specifying particular choices to enable or TRUE specifying the entire input is enabled, defaults to NULL.
disable	One of values specifying particular choices to disable or TRUE specifying the entire input is disabled, defaults to NULL.
session	A reactive context, defaults to getDefaultReactiveDomain().

Details

Getting started

Action lists.

listGroupInput(
  id = "list1",
  choices = paste("Item", 1:5)
)

Item 1 Item 2 Item 3 Item 4 Item 5

Combining lists with other elements

card(
  header = h6("Card header"),
  listGroupInput(
    id = NULL,
    flush = TRUE,
    choices = c(
      "Item 1", "Item 2", "Item 3",
      "Item 4", "Item 5"
    )
  )
)

Card header

Item 1 Item 2 Item 3 Item 4 Item 5

Horizontal list groups

listGroupInput(
  layout = "horizontal",
  id = NULL,
  choices = c("Item 1", "Item 2", "Item 3")
)

Item 1 Item 2 Item 3

See Also

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

nteetor/dull documentation built on Nov. 7, 2024, 2:11 p.m.