selectInput: Create a select list input control

Description Usage Arguments Details Value Note See Also Examples

View source: R/input-select.R

Description

Create a select list that can be used to choose a single or multiple items from a list of values.

Usage

1
2
3
4
selectInput(inputId, label, choices, selected = NULL, multiple = FALSE,
  selectize = TRUE, width = NULL)

selectizeInput(inputId, ..., options = NULL, width = NULL)

Arguments

inputId

Input variable to assign the control's value to

label

Display label for the control, or NULL

choices

List of values to select from. If elements of the list are named then that name rather than the value is displayed to the user.

selected

The initially selected value (or multiple values if multiple = TRUE). If not specified then defaults to the first value for single-select lists and no values for multiple select lists.

multiple

Is selection of multiple items allowed?

selectize

Whether to use selectize.js or not.

width

The width of the input, e.g. '400px', or '100%'; see validateCssUnit.

...

Arguments passed to selectInput().

options

A list of options. See the documentation of selectize.js for possible options (character option values inside I() will be treated as literal JavaScript code; see renderDataTable() for details).

Details

By default, selectInput() and selectizeInput() use the JavaScript library selectize.js (https://github.com/brianreavis/selectize.js) to instead of the basic select input element. To use the standard HTML select input element, use selectInput() with selectize=FALSE.

Value

A select list control that can be added to a UI definition.

Note

The selectize input created from selectizeInput() allows deletion of the selected option even in a single select input, which will return an empty string as its value. This is the default behavior of selectize.js. However, the selectize input created from selectInput(..., selectize = TRUE) will ignore the empty string value when it is a single choice input and the empty string is not in the choices argument. This is to keep compatibility with selectInput(..., selectize = FALSE).

See Also

updateSelectInput

Other input.elements: animationOptions, sliderInput; checkboxGroupInput; checkboxInput; dateInput; dateRangeInput; numericInput; radioButtons; submitButton; textInput

Examples

1
2
3
4
selectInput("variable", "Variable:",
            c("Cylinders" = "cyl",
              "Transmission" = "am",
              "Gears" = "gear"))

Example output

You probably do not want to attach this package (with library() or require()). Instead, you should use shinybootstrap2::withBootstrap2(). You can hide this message with suppressPackageStartupMessages().
<label class="control-label" for="variable">Variable:</label>
<select id="variable"><option value="cyl" selected>Cylinders</option>
<option value="am">Transmission</option>
<option value="gear">Gears</option></select>
<script type="application/json" data-for="variable" data-nonempty="">{}</script>

shinybootstrap2 documentation built on May 2, 2019, 4:05 p.m.