Slider
Sliders let users select from a range of values by moving the slider thumb.
Demos
Normal
Layout: discrete
Layout: discrete-markers. (need to set “step
”)
Basic Usage
<mdc-slider>
is a web component. All we need to do is put the required script into your HTML document. Then follow <mdc-slider>
's html structure and everything will be all set.
Required Script
<script async src="https://your-domain/pack-mdc-slider.js"> </script>
Structure
Add <mdc-slider>
in your document where you like.
Attributes could help to change its default setting.
<mdc-slider name="mdc-slider-demo" min="0" max="100" step="10" value="0" ></mdc-slider>
JavaScript Instantiation
<mdc-slider>
could also use JavaScript to create DOM element. Here comes some examples.
<script> var nodeAPI, nodeClasses; //use DOM api nodeAPI = document.createElement('mdc-slider'); nodeAPI.name = 'mdc-slider-demo-nodeAPI'; nodeAPI.min = 0; nodeAPI.max = 100; nodeAPI.step = 20; nodeAPI.value = 50; document.body.appendChild(nodeAPI); //new Classes nodeClasses = new MdcSlider(); nodeClasses.name = 'mdc-slider-demo-nodeClasses'; nodeClasses.min = 0; nodeClasses.max = 100; nodeClasses.step = 20; nodeClasses.value = 50; document.body.appendChild(nodeClasses); </script>
Style Customization
<mdc-sider>
uses CSS variables to style its interface. That means developer could easy change them into the lookup you like.
<style> mdc-slider { --slider-theme: #018786; --slider-duration: .267s; } </style>
Variants
<mdc-slider>
supports some common state to let it become more convenience & useful.
Layout: discrete
<mdc-slider>
will display “pin” which current value when thumb draged. (demo)
<mdc-slider layout="discrete" name="mdc-slider-demo" ></mdc-slider>
Layout: discrete-markers
<mdc-slider>
will display “pin” which current value when thumb draged. Track will list markers in this layout. (demo)
Note: need to set arrtibute - “step
”
<mdc-slider layout="discrete-markers" step="20" name="mdc-slider-demo" ></mdc-slider>
Layout: nodisplay
<mdc-slider>
will hide when this value set.
<mdc-slider layout="nodisplay" name="mdc-slider-demo" ></mdc-slider>
Properties
Property Name | Type | Description |
---|---|---|
layout
|
String | Setter/getter for mdc-slider's layout |
name
|
String | Setter/getter for mdc-slider's name |
value
|
Number | Setter/getter for mdc-slider's value |
min
|
Number | Minimum permitted value. Setter/getter for mdc-slider's min |
max
|
Number | Maximum permitted value. Setter/getter for mdc-slider's max. |
step
|
Number | The stepping interval, used both for user interface and validation purposes. Setter/getter for mdc-slider's step |
Event
Event Signature | Description |
---|---|
change
|
Fired when element's value is changed and committed. |