The Category Slider widget can be useful for situations where users must provide feedback from a fixed set of ascending options. Surveys, for example, often have questions that ask respondents to rate how much they agree or disagree with certain statements (that is, Strongly agree/ agree/ disagree/ strongly disagree).
Properties allow you to edit the Category Slider widget, connect it with other widgets and customize the user actions.
|Options||Formatting||An array of objects with keys |
|Default Value||Formatting||Sets an initial option to be captured as user input unless it's changed by the user. This property should be set to match the |
|Show Marks||Formatting||Toggles on/off the widget's reference labels below the slider element.|
|Visible||Formatting||Controls widget's visibility on the page. When turned off: The widget won't be visible when the app is published. It appears translucent when in Edit mode.|
|Disabled||Formatting||Makes the widget inactive or unusable. The widget remains visible to the user but user interaction won't be allowed.|
|value||Binding||Represents the value which is currently selected in the widget.|
These properties allow you to perform formatting changes or bind it to any other widget in queries or JS objects.
Options property to define the set of choices that the user may choose from with the slider. This property should be an array of objects, each with a
label key (text to be displayed to the user) and a
value key (the corresponding value to use within your widgets and code).
Sets an initial option to be captured as user input unless it's changed by the user. Please note that this property should be set to match the
value attribute of your desired option from the Options object.
This property is a toggle that enables/disables the label markings along the bottom of the slider.
This binding property allows you to access the value that has been selected with the slider. For example, if the selected value is
"agree", then the
value property would look like:
Each variant of the Slider widget has events that are called when the user adjusts the widget's values:
The Category Slider widget is great for collecting input that falls along a range of possible values. Consider using this widget when your users' responses are expected to fall along a fixed set of ascending data.