1.0.1 • Published 3 years ago

multi-range-slider-control v1.0.1

Weekly downloads
-
License
ISC
Repository
github
Last release
3 years ago

MultiRangeSlider.js

MultiRangeSlider.png

MultiRangeSlider.png

download

source code and demo

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 NameDescription
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 ListenersDescription
barclicktrigger when user click on bar or change value by keyboard arrow key
inputtrigger when slider value is changed by user
changetrigger when slider value is changed by user or JavaScript code
slidestarttrigger when user start slide by thumb or mouse wheel
slidetrigger continuously till user slide the thumb or rotating the mouse wheel
slideendtrigger when user release the thumb or stop rotating the mouse wheel

eventHandlerFunction Argument

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

e.propertyDescription
minslider min value
maxslider max value
stepslider step value
value_minslider selected min value
value_maxslider selected max value
minValueslider selected min value
maxValueslider selected max value
value1slider selected min value
value2slider selected max value
sliderslider.bar.thumb_left/slider.bar.thumb_right
targetmultiRangeSliderObject

Mouse Wheel Event Listener

wheelaction
shift + wheelscroll left thumb and increment/decrement selected min value and trigger input, change, slidestart, slide, slideend events
ctrl + wheelscroll right thumb and increment/decrement selected max value and trigger input, change, slidestart, slide, slideend events
shift + ctrl + wheelscroll 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);

MultiRangeSlider.png

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;

MultiRangeSlider.png

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;

MultiRangeSlider.png

License : Free to Use