MultiRangeSlider.js

download

• MultiRangeSlider.js
• MultiRangeSlider.min.js
• MultiRangeSlider.css

source code and demo

• download source code
• view demo
• view demo-style-1
• view demo-style-2

Description

We face a problem that input type range allow only one value to select. If we want to select two values from a range we have no option. we need to add two input type range slider to take input min value and max value. Handling two input range control is not easy and manages events is also very difficult. For the solution of selecting multiple value and handling events it provide a solution. It allows user to select min value and max value from a range slider. It's design layout is fully controlled by CSS and provide a lot of events to handle via JavaScript.

How to Use

download MultiRangeSlider.js/MultiRangeSlider.min.js and include in your project. There are two way to add this control on form

Method 1

let options ={container: document.querySelector('.container')};
let multiRangeSlider1 = new  MultiRangeSlider(options);

Method 2

let multiRangeSlider2 = new  MultiRangeSlider();
document.querySelector('.container').appendChild(multiRangeSlider2);

Options

This slider control can be handled by options that is passed to constructor function as explained in Method 1

let options = {
    container : null, // target container element where it append
	id : '', //set id attribute if passed value else unset
	baseClassName : '', // prefix of class names of all elements of range slider default "multi-range-slider" set if you want to change theme style.
    min : 0, // slider min value default is 0
    max : 100, // slider max value default is 100
    step : 5, // slider step value default is ((max - min) / 20)=5
    value_min : 25, // slider selected min value default is ((max - min) * 0.25)
    value_max : 75, // slider selected max value default is ((max - min) * 0.75)
    showRuler : true, // is ruler visible or not default is true
    showValue : true, // is selected min and max value label shows or not default true
    showLabel : true, // is slider min and max value shows or not default true
    preventWheel : false, // is slider move with mouse wheel default is false
    oninit : null, // eventHandlerFunction trigger when control is created by constructor.
    onbarclick : null, // eventHandlerFunction trigger when control's bar clicked.
    oninput : null, // eventHandlerFunction trigger when control's value change by user.
    onchange : null, // eventHandlerFunction trigger when control's value change by user or JavaScript. 
    onslidestart : null, // eventHandlerFunction trigger when thumb is start sliding by user.
    onslide : null, // eventHandlerFunction triggers continuously till the thumb is sliding by user. also trigger when user click on bar.
    onslideend : null // eventHandlerFunction trigger when thumb is stop sliding by user.
}

Properties and Event Listeners

This slider control can be handled by setting properties and adding event listeners as explained in Method 2

multiRangeSliderObject.propertyName=value; 

| Property Name | Description| |--|--| |min|(Numeric) get/set slider min value| |max|(Numeric) get/set slider max value| |step|(Numeric) get/set slider step value, controls ruler points and bar click value increment/decrement | |value_min|(Numeric) get/set slider selected min value| |value_max|(Numeric) get/set slider selected max value| |minValue|(Numeric) get/set slider selected min value| |maxValue|(Numeric) get/set slider selected max value| |value1|(Numeric) get/set slider selected min value| |value2|(Numeric) get/set slider selected max value| |showRuler|(boolean) get/set slider ruler is visible or not| |showValue|(boolean) get/set slider thumb selected min and max value is visible or not| |showLabel|(boolean) get/set slider min and max value label is display or not| |preventWheel|(boolean) get/set whether slider responses mouse wheel or not default is false. if true then it do not responses mouse wheel.|

Event Listeners

This control dispatches following events that can be handled by registering event listeners

multiRangeSliderObject.addEventListener("eventName",eventHandlerFunction);

| Event Listeners | Description| |--|--| |barclick|trigger when user click on bar or change value by keyboard arrow key| |input| trigger when slider value is changed by user| |change| trigger when slider value is changed by user or JavaScript code| |slidestart | trigger when user start slide by thumb or mouse wheel| |slide | trigger continuously till user slide the thumb or rotating the mouse wheel| |slideend| trigger when user release the thumb or stop rotating the mouse wheel|

eventHandlerFunction Argument

Note : eventHandlerFunction receives an argument event that have following properties.

|e.property| Description | |--|--| | min | slider min value | |max| slider max value| |step| slider step value| |value_min| slider selected min value| |value_max| slider selected max value| |minValue| slider selected min value| |maxValue| slider selected max value| |value1| slider selected min value| |value2| slider selected max value| |slider| slider.bar.thumb_left/slider.bar.thumb_right| |target| multiRangeSliderObject|

Mouse Wheel Event Listener

|wheel| action | |--|--| | shift + wheel | scroll left thumb and increment/decrement selected min value and trigger [input, change, slidestart, slide, slideend ] events | |ctrl + wheel| scroll right thumb and increment/decrement selected max value and trigger [input, change, slidestart, slide, slideend ] events| |shift + ctrl + wheel| scroll left and right both thumbs and increment/decrement selected min and max values and trigger [input, change, slidestart, slide, slideend ] events|

when both slider moves together then eventListener argument's slider property return array of both sliders. [slider.bar.thumb_left, slider.bar.thumb_right]

Example Code :

Method - 1

HTML

<link rel="stylesheet" href="./node_modules/multi-range-slider-control/MultiRangeSlider.css" />
<script src="./node_modules/multi-range-slider-control/MultiRangeSlider.js"></script>



<div class="container" style="text-align: center">
	<h1>MultiRangeSlider.js : Demo</h1>
	<div class="multi-range-slider-container" style="width: 500px; margin: auto"></div>
	<br />
	<br />
	<div class="multi-range-slider-result" style="text-align: center"></div>
</div>

JS

let onInitMultiRangeSlider = function (e) {
	document.querySelector('.multi-range-slider-result').innerHTML = 
	'minValue = ' + e.minValue + '<br/>maxValue = ' + e.maxValue;
};

let onInputMultiRangeSlider = function (e) {
	document.querySelector('.multi-range-slider-result').innerHTML = 
	'minValue = ' + e.minValue + '<br/>maxValue = ' + e.maxValue;
};

let options = {
	container: document.querySelector('.multi-range-slider-container'), 
	id: 'MultiRangeSlider1', 
	baseClassName: '', 
	min: 0, 
	max: 100, 
	step: 5, 
	value_min: 25, 
	value_max: 75, 
	showRuler: true, 
	showValue: true, 
	showLabel: true, 
	preventWheel: false, 
	oninit: onInitMultiRangeSlider, 
	onbarclick: null, 
	oninput: onInputMultiRangeSlider, 
	onchange: null, 
	onslidestart: null, 
	onslide: null, 
	onslideend: null, 
};
const multiRangeSlider1 = new MultiRangeSlider(options);

Method - 2

HTML

<link rel="stylesheet" href="./MultiRangeSlider/MultiRangeSlider.css" />


<div class="container" style="text-align: center">
	<h1>MultiRangeSlider.js : Demo</h1>
	<div class="multi-range-slider-container" style="width: 500px; margin: auto"></div>
	<br />
	<br />
	<div class="multi-range-slider-result" style="text-align: center"></div>
</div>

JS

import MultiRangeSlider from '/node_modules/multi-range-slider-control/MultiRangeSlider.min.js';

const multiRangeSlider = new MultiRangeSlider();
document.querySelector('.container .multi-range-slider-container').appendChild(multiRangeSlider);

// multiRangeSlider.min = 0;
// multiRangeSlider.max = 100;
// multiRangeSlider.minValue = 10;
// multiRangeSlider.maxValue = 90;
// multiRangeSlider.step = 5;
// multiRangeSlider.showRuler = true;
// multiRangeSlider.showValue = true;
// multiRangeSlider.showLabel = true;
// multiRangeSlider.preventWheel = false;

multiRangeSlider.oninput = (e) => {
    document.querySelector('.container .multi-range-slider-result').innerHTML = 
    'minValue = ' + e.minValue + '<br/>maxValue = ' + e.maxValue;
};

document.querySelector('.container .multi-range-slider-result').innerHTML = 
'minValue = ' + multiRangeSlider.minValue + '<br/>maxValue = ' + multiRangeSlider.maxValue;

baseClassName

HTML

<link rel="stylesheet" href="./MultiRangeSlider/MultiRangeSliderBlack.css" />


<div class="container" style="text-align: center">
	<h1>MultiRangeSlider.js : Demo</h1>
	<div class="multi-range-slider-container" style="width: 500px; margin: auto"></div>
	<br />
	<br />
	<div class="multi-range-slider-result" style="text-align: center"></div>
</div>

JS

import MultiRangeSlider from '/node_modules/multi-range-slider-control/MultiRangeSlider.min.js';

const multiRangeSliderBlack = new MultiRangeSlider({ baseClassName: 'multi-range-slider-black' });
document.querySelector('.container .multi-range-slider-container')
.appendChild(multiRangeSliderBlack);


multiRangeSliderBlack.oninput = (e) => {
    document.querySelector('.container .multi-range-slider-result').innerHTML = 
    'minValue = ' + e.minValue + '<br/>maxValue = ' + e.maxValue;
};

document.querySelector('.container .multi-range-slider-result').innerHTML = 
'minValue = ' + multiRangeSliderBlack.minValue +
 '<br/>maxValue = ' + multiRangeSliderBlack.maxValue;

License : Free to Use