1.1.0 • Published 4 years ago
@pmwcs/slider v1.1.0
Sliders
Sliders let users select from a range of values by moving the slider thumb.
- Module @pmwcs/slider
- Import styles:
- Using CSS Loader
- import '@pmwcs/slider/styles';
- Or include stylesheets
- '@material/slider/dist/mdc.slider.css'
- Using CSS Loader
- MDC Docs: https://material.io/develop/web/components/input-controls/sliders/
Sliders can be both uncontrolled and controlled. When creating a controlled Slider, you should be listening to the onInput event and use evt.detail.value to set your new value.
Sliders will automatically layout themselves on window resize. If you need to manually trigger a layout because the sliders container size changed, the simplest way is to trigger a resize event window.dispatchEvent(new Event('resize'));.
Known Issue material-components-web uses pointer events internally. If you are using something below React 16.4, you will see unknown attribute errors, however the slider should still work.
<Slider
onInput={evt => console.log(evt)}
onChange={evt => console.log(evt)}
/>function Example() {
const [value, setValue] = React.useState(50);
// onInput is required and will fire continuously.
// onChange is optional and fires at the end of the interaction
return (
<Slider
value={value}
onChange={evt => setValue(evt.detail.value)}
onInput={evt => setValue(evt.detail.value)}
discrete
step={1}
/>
);
}<Slider discrete displayMarkers min={100} max={200} step={5} />Slider
A Slider component.
Props
| Name | Type | Description |
|---|---|---|
disabled | undefined \| false \| true | Disables the control. |
discrete | undefined \| false \| true | Displays the exact value of the Slider on the knob. |
displayMarkers | undefined \| false \| true | Displays the individual step markers on the Slider track. |
foundationRef | React.Ref<MDCSliderFoundation> | Advanced: A reference to the MDCFoundation. |
max | number \| string | The maximum value of the Slider. |
min | number \| string | The minimum value of the Slider. |
onChange | undefined \| (evt: SliderOnChangeEventT) => void | A callback that fires when the Slider stops sliding which takes an event with event.detail.value set to the Slider's value. evt.detail = { value: number;} |
onInput | undefined \| (evt: SliderOnInputEventT) => void | A callback that fires continuously while the Slider is sliding that takes an event with event.detail.value set to the Slider's value. evt.detail = { value: number;} |
step | number \| string | A step to quantize values by. |
value | number \| string | The value of the Slider. |