R: Slider Input Widget

sliderInput {shiny}

R Documentation

Slider Input Widget

Description

Constructs a slider widget to select a number, date, or date-time from a range.

Usage

sliderInput(
  inputId,
  label,
  min,
  max,
  value,
  step = NULL,
  round = FALSE,
  ticks = TRUE,
  animate = FALSE,
  width = NULL,
  sep = ",",
  pre = NULL,
  post = NULL,
  timeFormat = NULL,
  timezone = NULL,
  dragRange = TRUE
)

animationOptions(
  interval = 1000,
  loop = FALSE,
  playButton = NULL,
  pauseButton = NULL
)

Arguments

`inputId`	The `input` slot that will be used to access the value.
`label`	Display label for the control, or `NULL` for no label.
`min`, `max`	The minimum and maximum values (inclusive) that can be selected.
`value`	The initial value of the slider, either a number, a date (class Date), or a date-time (class POSIXt). A length one vector will create a regular slider; a length two vector will create a double-ended range slider. Must lie between `min` and `max`.
`step`	Specifies the interval between each selectable value on the slider. Either `NULL`, the default, which uses a heuristic to determine the step size or a single number. If the values are dates, `step` is in days; if the values are date-times, `step` is in seconds.
`round`	`TRUE` to round all values to the nearest integer; `FALSE` if no rounding is desired; or an integer to round to that number of digits (for example, 1 will round to the nearest 10, and -2 will round to the nearest .01). Any rounding will be applied after snapping to the nearest step.
`ticks`	`FALSE` to hide tick marks, `TRUE` to show them according to some simple heuristics.
`animate`	`TRUE` to show simple animation controls with default settings; `FALSE` not to; or a custom settings list, such as those created using `animationOptions()`.
`width`	The width of the input, e.g. `'400px'`, or `'100%'`; see `validateCssUnit()`.
`sep`	Separator between thousands places in numbers.
`pre`	A prefix string to put in front of the value.
`post`	A suffix string to put after the value.
`timeFormat`	Only used if the values are Date or POSIXt objects. A time format string, to be passed to the Javascript strftime library. See https://github.com/samsonjs/strftime for more details. The allowed format specifications are very similar, but not identical, to those for R's `base::strftime()` function. For Dates, the default is `"%F"` (like `"2015-07-01"`), and for POSIXt, the default is `"%F %T"` (like `"2015-07-01 15:32:10"`).
`timezone`	Only used if the values are POSIXt objects. A string specifying the time zone offset for the displayed times, in the format `"+HHMM"` or `"-HHMM"`. If `NULL` (the default), times will be displayed in the browser's time zone. The value `"+0000"` will result in UTC time.
`dragRange`	This option is used only if it is a range slider (with two values). If `TRUE` (the default), the range can be dragged. In other words, the min and max can be dragged together. If `FALSE`, the range cannot be dragged.
`interval`	The interval, in milliseconds, between each animation step.
`loop`	`TRUE` to automatically restart the animation when it reaches the end.
`playButton`	Specifies the appearance of the play button. Valid values are a one-element character vector (for a simple text label), an HTML tag or list of tags (using `tag()` and friends), or raw HTML (using `HTML()`).
`pauseButton`	Similar to `playButton`, but for the pause button.

Server value

A number, date, or date-time (depending on the class of value), or in the case of slider range, a vector of two numbers/dates/date-times.

Examples

## Only run examples in interactive R sessions
if (interactive()) {
options(device.ask.default = FALSE)

ui <- fluidPage(
  sliderInput("obs", "Number of observations:",
    min = 0, max = 1000, value = 500
  ),
  plotOutput("distPlot")
)

# Server logic
server <- function(input, output) {
  output$distPlot <- renderPlot({
    hist(rnorm(input$obs))
  })
}

# Complete app with UI and server components
shinyApp(ui, server)
}