multi-range-slider-control

1.0.1 • Public • Published

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 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);

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

Package Sidebar

Install

npm i multi-range-slider-control

Weekly Downloads

7

Version

1.0.1

License

ISC

Unpacked Size

52.8 kB

Total Files

8

Last publish

Collaborators

  • developergovindgupta