Checklist is a component that encapsulates several checkboxes. The values and labels of the checklist are specified in the `options` property and the checked items are specified with the `value` property. Each checkbox is rendered as an input with a surrounding label.
dccChecklist(id=NULL, options=NULL, value=NULL, className=NULL,
style=NULL, inputStyle=NULL, inputClassName=NULL,
labelStyle=NULL, labelClassName=NULL, loading_state=NULL,
persistence=NULL, persisted_props=NULL,
persistence_type=NULL, inline=NULL)
Character. The ID of this component, used to identify dash components in callbacks. The ID needs to be unique across all of the components in an app.
List of character | numeric | logicals | named list | list of lists containing elements 'label', 'value', 'disabled', 'title'. those elements have the following types: - label (character | numeric | logical; required): the option's label - value (character | numeric | logical; required): the value of the option. this value corresponds to the items specified in the `value` property. - disabled (logical; optional): if true, this option is disabled and cannot be selected. - title (character; optional): the html 'title' attribute for the option. allows for information on hover. for more information on this attribute, see https://developer.mozilla.org/en-us/docs/web/html/global_attributes/titles. An array of options
List of character | numeric | logicals. The currently selected value
Character. The class of the container (div)
Named list. The style of the container (div)
Named list. The style of the <input> checkbox element
Character. The class of the <input> checkbox element
Named list. The style of the <label> that wraps the checkbox input and the option's label
Character. The class of the <label> that wraps the checkbox input and the option's label
Lists containing elements 'is_loading', 'prop_name', 'component_name'. those elements have the following types: - is_loading (logical; optional): determines if the component is loading or not - prop_name (character; optional): holds which property is loading - component_name (character; optional): holds the name of the component that is loading. Object that holds the loading state object coming from dash-renderer
Logical | character | numeric. Used to allow user interactions in this component to be persisted when the component - or the page - is refreshed. If `persisted` is truthy and hasn't changed from its previous value, a `value` that the user has changed while using the app will keep that change, as long as the new `value` also matches what was given originally. Used in conjunction with `persistence_type`.
List of a value equal to: 'value's. Properties whose user interactions will persist after refreshing the component or the page. Since only `value` is allowed this prop can normally be ignored.
A value equal to: 'local', 'session', 'memory'. Where persisted user changes will be stored: memory: only kept in memory, reset on page refresh. local: window.localStorage, data is kept after the browser quit. session: window.sessionStorage, data is cleared once the browser quit.
Logical. Indicates whether labelStyle should be inline or not True: Automatically set 'display': 'inline-block' to labelStyle False: No additional styles are passed into labelStyle.
named list of JSON elements corresponding to React.js properties and their values
# NOT RUN {
if (interactive()) {
library(dash)
app <- Dash$new()
app$layout(
dccChecklist(
id = "checklist-input",
options=list(
list("label" = "New York City", "value" = "NYC"),
list("label" = "Montreal", "value" = "MTL"),
list("label" = "San Francisco", "value" = "SF")
),
value=list("MTL", "SF")
)
)
app$run_server()
}
# }
Run the code above in your browser using DataLab