ToolJet/docs/versioned_docs/version-2.61.0/widgets/range-slider.md
2024-06-26 14:47:00 +05:30

81 lines
No EOL
3.5 KiB
Markdown

---
id: range-slider
title: Range Slider
---
# Range Slider
The **Range Slider** widget is widely used across different UIs. One of the main purposes is to filter, explore all the related content and available in the control and settings options.
:::tip
Range Sliders have "Two handles" option which allows user to select within a range.
:::
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>
## Properties
| <div style={{ width:"100px"}}> Property </div> | <div style={{ width:"150px"}}> Description </div> |
|:------------ |:-------------|
| Minimum value | Set the minimum value for the slider. This field accepts any numerical value. |
| Maximum value | Set the maximum value for the slider. This field accepts any numerical value. |
| Value | Set the default value when the widget loads. This can be used to pre-fill the value based on your data and requirements. |
| Two handles | The slider will now have 2 dragging handles. It is used to define a range of values versus a single given value. |
</div>
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>
## Component Specific Actions (CSA)
There are currently no CSA (Component-Specific Actions) implemented to regulate or control the component.
</div>
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>
## Exposed Variables
| <div style={{ width:"100px"}}> Variables </div> | <div style={{ width:"135px"}}> Description </div> | <div style={{ width:"135px"}}> How To Access </div> |
|:----------- |:----------- |:--------- |
| value | Holds an object when `two handles` option is disabled or an array when `two handles` is enabled from the component properties. | The value can be accessed dynamically using JS: `{{components.rangeslider1.value}}` or `{{components.rangeslider1.value[1]}}` |
</div>
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>
## General
### Tooltip
A Tooltip is often used to specify extra information about something when the user hovers the mouse pointer over the widget.
Under the <b>General</b> accordion, you can set the value in the string format. Now hovering over the widget will display the string as the tooltip.
</div>
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>
## Layout
| <div style={{ width:"100px"}}> Layout </div> | <div style={{ width:"100px"}}> Description </div> | <div style={{ width:"135px"}}> Expected Value </div> |
|:--------------- |:----------------------------------------- | :------------------------------------------------------------------------------------------------------------- |
| Show on desktop | Toggle on or off to display desktop view. | You can programmatically determining the value by clicking on `Fx` to set the value `{{true}}` or `{{false}}` |
| Show on mobile | Toggle on or off to display mobile view. | You can programmatically determining the value by clicking on `Fx` to set the value `{{true}}` or `{{false}}` |
</div>
<div style={{paddingTop:'24px', paddingBottom:'24px'}}>
## Styles
| <div style={{ width:"100px"}}> Style </div> | <div style={{ width:"100px"}}> Description </div> |
|:------------ |:-------------|
| Line color | Enter the hexcode to set the default color for slider's track. |
| Handle color | Enter the hexcode to set the color for slider's handler. |
| Track color | Enter the hexcode to set the color for slider's active portion on the track. |
| Visibility | Set the visibility of the slider programmatically. The default value is `{{true}}`. |
:::info
Any property having `Fx` button next to its field can be **programmatically configured**.
:::
</div>