Range Slider Ready
Range Slider lets user specify a numeric value using a slider which must be no less than a given value, and no more than another given value.
Examples
Properties #
Property | Attribute | Description | Type | Default |
---|---|---|---|---|
debounce | debounce | Set the amount of time, in milliseconds, to wait to trigger the duetChange event after each keystroke. | number | 0 |
expand | expand | Expands the input to fill 100% of the container width. | boolean | false |
identifier | identifier | Adds a unique identifier for the input. | string | undefined |
label | label | Label for the range slider. | string | "label" |
labelHidden | label-hidden | Visually hide the label, but still show it to screen readers. | boolean | false |
locale | locale | Locale used to format the entered value. | "en-GB" | "en-US" | "fi-FI" | "sv-SE" | "fi-FI" |
margin | margin | Controls the margin of the component. | "auto" | "none" | "auto" |
max | max | Maximum value. | number | 100 |
min | min | Minimum value. | number | 0 |
step | step | Step amount. | number | 1 |
theme | theme | Theme of the input. | "" | "default" | "turva" | "" |
unit | unit | Unit for the range slider. | string | "" |
value | value | Value of the input. | number | 0 |
Events #
Event | Description | Type |
---|---|---|
duetChange | Emitted when the value has changed. | CustomEvent<{ originalEvent?: Event; component: "duet-range-slider"; value: number; }> |
duetInput | Emitted when a keyboard input ocurred. | CustomEvent<{ originalEvent?: Event; component: "duet-range-slider"; value: number; }> |
Methods #
setFocus() => Promise<void>
#
Sets focus on the specified duet-range-slider
. Use this method instead of the global
input.focus()
.
Returns #
Type: Promise<void>
Usage #
This section includes guidelines for designers and developers about the usage of this component in different contexts.
When to use #
- To let user specify a numeric value using a slider which must be no less than a given value, and no more than another given value.
- When the accuracy of the numeric value entered isn’t important.
When not to use #
- When the accuracy of the numeric value entered is important. Consider using number input instead.
- For entering arbitrary numeric values. Use input component instead.
Accessibility #
This component has been validated to meet the WCAG 2.1 AA accessibility guidelines. You can find additional information regarding accessibility of this component below.
- Number Input component uses a basic HTML
<input type="range">
element behind the scenes and offers similar functionality and API for its users. - Never use range slider when the entered numeric value needs to be exact as using a slider based control can be hard for certain users.
label
property is always required for an accessible input control.labelHidden
property hides the above label visually, but still keeps it accessible for assistive technologies.
Integration
For integration, event and theming guidelines, please see Using Components. This documentation explains how to implement and use Duet’s components across different technologies like Angular, React or Vanilla JavaScript.
Tutorials
Follow these practical tutorials to learn how to build simple page layouts using Duet’s CSS Framework, Web Components and other features:
Abstract
TutorialsBuilding Layouts
TutorialsUsing CLI Tools
TutorialsCreating Custom Patterns
TutorialsServer Side Rendering
TutorialsSharing Prototypes
TutorialsUsage With Markdown
TutorialsVS Code
TutorialsZeplin
Troubleshooting
If you experience any issues while using a component, please head over to the Support page for more guidelines and help.