Documentation
Range slider
All options and features can be found here.
Basic range slider
<div data-slider='{"js-name": "slider0","start": 50,"range": {"min": 0,"max": 100}}'></div>
<p demo-slider="slider0"></p>
That’s how values are displayed:
/* Demo only */
$(document).ready(function() {
/* Sliders value */
let slidersText = document.querySelectorAll('[demo-slider]');
for(let i = 0;i<slidersText.length;i++){
window[slidersText[i].getAttribute("demo-slider")].on('update',function(values){
slidersText[i].innerHTML = values.join(' | ');
})
}
});
Basic options
Basic range slider options.
js-name
By setting js-name
you can access slider in your js code. Remember to use it in your code after the page has loaded.
/* Example */
window.onload = slider;
function slider(){
let sliderText = document.getElementById('sliderText');
slider1.on('update',function(values,handle){
sliderText.innerHTML = values[handle];
});
}
<div data-slider='{"js-name": "slider1","start": 50,"range": {"min": 0,"max": 100}}'></div>
<p id="sliderText" demo-slider="slider1"></p>
start
The start
option sets the number of handles and corresponding start positions.
The start
option uses the slider’s 'format'
option to decode the input. Number input will be cast to string and decoded.
<div data-slider='{"js-name": "slider2","start": 30,"range": {"min": 0,"max": 100}}'></div>
<p demo-slider="slider2"></p>
<div data-slider='{"js-name": "slider3","start": [40,65],"range": {"min": 0,"max": 100}}'></div>
<p demo-slider="slider3"></p>
<div data-slider='{"js-name": "slider4","start": [25,50,75],"range": {"min": 0,"max": 100}}'></div>
<p demo-slider="slider4"></p>
range
All values on the slider are part of a range. The range has a minimum and maximum value. The minimum value cannot be equal to the maximum value.
<div data-slider='{"js-name": "slider5","start": 500,"range": {"min": -2000,"max": 10000}}'></div>
<p demo-slider="slider5"></p>
<div data-slider='{"js-name": "slider6","start": [-250,800],"range": {"min": -500,"max": 1000}}'></div>
<p demo-slider="slider6"></p>
<div data-slider='{"js-name": "slider7","start": [0.1,0.4,0.9],"range": {"min": 0.1,"max": 1}}'></div>
<p demo-slider="slider7"></p>
step
By default, the slider slides fluently. In order to make the handles jump between intervals, you can use the step option.
<div data-slider='{"js-name": "slider8","start": 5000,"range": {"min": 1000,"max": 10000},"step": 1000}'></div>
<p demo-slider="slider8"></p>
<div data-slider='{"js-name": "slider9","start": 500,"range": {"min": 100,"max": 1000},"step": 125}'></div>
<p demo-slider="slider9"></p>
<div data-slider='{"js-name": "slider10","start": 50,"range": {"min": 10,"max": 100},"step": 5}'></div>
<p demo-slider="slider10"></p>
connect
The connect option can be used to control the bar between the handles or the edges of the slider.
If you are using one handle, set the value to either 'upper'
or 'lower'
.
For sliders with 2 or more handles, pass an array with a boolean for every connecting element, including the edges of the slider. The length of this array must match the handle count + 1.
Setting true sets the bars between the handles, but not between the handles and the sliders edges.
<div data-slider='{"js-name": "slider11","start": 8000,"connect": "lower","range": {"min": [2000],"max": [20000]}}'></div>
<p demo-slider="slider11"></p>
<div data-slider='{"js-name": "slider12","start": 8000,"connect": "upper","range": {"min": [2000],"max": [20000]}}'></div>
<p demo-slider="slider12"></p>
<div data-slider='{"js-name": "slider13","start": [4000, 8000, 12000, 16000],"connect": [false, true, true, false, true],"range": {"min": [2000],"max": [20000]}}'></div>
<p demo-slider="slider13"></p>
margin
When using two handles, the minimum distance between the handles can be set using the margin option. The margin value is relative to the value set in ‘range’. This option is only available on linear sliders.
<div data-slider='{"js-name": "slider14","start": [20,80],"range": {"min": 0,"max": 100},"margin":30}'></div>
<p demo-slider="slider14"></p>
<div data-slider='{"js-name": "slider15","start": [20,80],"range": {"min": 0,"max": 100},"margin":50}'></div>
<p demo-slider="slider15"></p>
limit
The limit
option is the oposite of the margin option, limiting the maximum distance between two handles. As with the margin option, the limit
option can only be used on linear sliders.
<div data-slider='{"js-name": "slider16","start": [10,120],"connect":true,"range": {"min": 0,"max": 100},"limit":40,"behaviour":"drag"}'></div>
<p demo-slider="slider16"></p>
padding
Padding limits how close to the slider edges handles can be.
<div data-slider='{"js-name": "slider17","start": [20,80],"range": {"min": 0,"max": 100},"padding":[10,15]}'></div>
<p demo-slider="slider17"></p>
That’s only the basic features and options of range slider. More possibilities can be found here.