huijiewei-ion-rangeslider

English description | Описание на русском

Ion.RangeSlider. Is an easy, flexible and responsive range slider with tons of options.

---

• Version: 2.2.0 | Version 3.x is under development now
• Project page and demos
• Download ZIP

Description

• Ion.RangeSlider — cool, comfortable, responsive and easily customizable range slider
• Supports events and public methods, has flexible settings, can be completely altered with CSS
• Cross-browser: Google Chrome, Mozilla Firefox 3.6+, Opera 12+, Safari 5+, Internet Explorer 8+
• Ion.RangeSlider supports touch-devices (iPhone, iPad, Nexus, etc.).
• Ion.RangeSlider freely distributed under terms of MIT licence.
• With this plugin you will be able to build beautiful range sliders, like this:

Key features

• Skin support. (5 skins included and PSD for skin creation)
• Any number of sliders at one page without conflicts and big performance problems
• Two slider types single (1 slider) and double (2 sliders)
• Support of negative and fractional values
• Ability to set custom step and snap grid to step
• Support of custom values diapason
• Customisable grid of values
• Ability to disable UI elements (min and max, current value, grid)
• Postfixes and prefixes for your numbers ($20, 20 € etc.)
• Additional postfix for maximum value (eg. $0 — $100+)
• Ability to prettify large numbers (eg. 10000000 -> 10 000 000 or 10.000.000)
• Slider writes its value right into input value field. This makes it easy to use in any html form
• Any slider value can be set through input data-attribute (eg. data-min="10")
• Slider supports disable param. You can set it true to make slider inactive
• Slider supports external methods (update, reset and remove) to control it after creation
• For advanced users slider has callbacks (onStart, onChange, onFinish, onUpdate). Slider pastes all its params to callback first argument as object
• Slider supports date and time

Demos

• Basic demo
• Advanced demo
• Interactions demo

Dependencies

• jQuery 1.8.x+

Usage

Add the following libraries to the page:

• jQuery
• ion.rangeSlider.min.js

Add the following stylesheets to the page:

• normalize.css (optional)
• ion.rangeSlider.css

Plus, a skin for the slider. 5 skins are included. Choose one:

• ion.rangeSlider.skinFlat.css + sprite-skin-flat.png
• ion.rangeSlider.skinHTML5.css + no images
• ion.rangeSlider.skinModern.css + sprite-skin-modern.png
• ion.rangeSlider.skinNice.css + sprite-skin-nice.png
• ion.rangeSlider.skinSimple.css + sprite-skin-simple.png

Or use the included PSD file and design a custom skin.

Install with bower

• bower install ionrangeslider

Install with npm

• npm install ion-rangeslider

Initialisation

The slider overrides a native text input element.

<input type="text" id="example_id" name="example_name" value="" />

To initialise the slider, call ionRangeSlider on the element:

$("#example_id").ionRangeSlider();

Demo for juniors

If your are new in web development and you are not sure how to correctly install the plugin to your web-page, please download this demo example

Experiments playground

Here you can find bunch of advanced JSFIDDLE demos with different, non-standart use cases:

• Reverse or RTL
• 1 handle bind to 1 input
• 2 handles bind to 2 inputs
• 2 sliders connected to each other
• 1st slider disables/enables 2nd slider
• Non-linear slider
• Plus and Minus buttons
• Calculating sum
• Adding one more diapazon on 1 slider
• Live editing of Min and Max values
• Prettify and transform values at the same time
• Custom marks on slider
• Rendering money value n.nn
• Rendering Dates with Moment.js
• Changing step live
• Toggle slider
• Using different skin color at the same time
• 2 dependant sliders
• Skip some values
• Good Prettify example

Settings

Option	Data-Attr	Defaults	Type	Description
type	data-type	single	string	Choose slider type, could be single - for one handle, or double for two handles
min	data-min	10	number	Set slider minimum value
max	data-max	100	number	Set slider maximum value
from	data-from	min	number	Set start position for left handle (or for single handle)
to	data-to	max	number	Set start position for right handle
step	data-step	1	number	Set sliders step. Always > 0. Could be fractional
min_interval	data-min-interval	-	number	Set minimum diapason between sliders. Only for double type
max_interval	data-max-interval	-	number	Set minimum maximum between sliders. Only for double type
drag_interval	data-drag-interval	false	boolean	Allow user to drag whole range. Only for double type
values	data-values	[]	array	Set up your own array of possible slider values. They could be numbers or strings. If the values array is set up, min, max and step param, can no longer be changed
from_fixed	data-from-fixed	false	boolean	Fix position of left (or single) handle
from_min	data-from-min	min	number	Set minimum limit for left (or single) handle
from_max	data-from-max	max	number	Set maximum limit for left (or single) handle
from_shadow	data-from-shadow	false	boolean	Highlight the limits for left handle
to_fixed	data-to-fixed	false	boolean	Fix position of right handle
to_min	data-to-min	min	number	Set minimum limit for right handle
to_max	data-to-max	max	number	Set maximum limit for right handle
to_shadow	data-to-shadow	false	boolean	Highlight the right handle
prettify_enabled	data-prettify-enabled	true	boolean	Improve readability of long numbers: 10000000 → 10 000 000
prettify_separator	data-prettify-separator		string	Set up your own separator for long numbers: 10000000 → 10,000,000 etc.
prettify	-	null	function	Set up your own prettify function. Can be anything. For example, you can set up unix time as slider values and than transform them to cool looking dates
force_edges	data-force-edges	false	boolean	Sliders handles and tooltips will be always inside it's container
keyboard	data-keyboard	true	boolean	Activates keyboard controls. Move left: ←, ↓, A, S. Move right: →, ↑, W, D.
grid	data-grid	true	boolean	Enables grid of values above the slider
grid_margin	data-grid-margin	true	boolean	Set left and right grid gaps
grid_num	data-grid-num	4	number	Number of grid units
grid_snap	data-grid-snap	false	boolean	Snap grid to sliders step (step param). If activated, grid_num will not be used. Max steps = 50
hide_min_max	data-hide-min-max	false	boolean	Hides min and max labels
hide_from_to	data-hide-from-to	false	boolean	Hides from and to labels
prefix	data-prefix	``	string	Set prefix for values. Will be set up right before the number: **$**100
postfix	data-postfix	``	string	Set postfix for values. Will be set up right after the number: 100k
max_postfix	data-max-postfix	``	string	Special postfix, used only for maximum value. Will be showed after handle will reach maximum right position. For example 0 — 100+
decorate_both	data-decorate-both	true	boolean	Used for double type and only if prefix or postfix was set up. Determine how to decorate close values. For example: $10k — $100k or $10 — 100k
values_separator	data-decorate-both	-	string	Set your own separator for close values. Used for double type. Default: 10 — 100. Or you may set: 10 to 100, 10 + 100, 10 → 100 etc.
input_values_separator	data-input-values-separator	;	string	Separator for double values in input value property. <input value="25;42">
disable	data-disable	false	boolean	Locks slider and makes it inactive. Input is disabled too. Invisible to forms
block	data-blokc	false	boolean	Locks slider and makes it inactive. Input is NOT disabled. Can be send with forms
extra_classes	data-extra-classes	—	string	Traverse extra CSS-classes to sliders container
scope	-	null	object	Scope for callbacks. Pass any object
onStart	-	null	function	Callback. Is called on slider start. Gets all slider data as a 1st attribute
onChange	-	null	function	Callback. IS called on each values change. Gets all slider data as a 1st attribute
onFinish	-	null	function	Callback. Is called when user releases handle. Gets all slider data as a 1st attribute
onUpdate	-	null	function	Callback. Is called when slider is modified by external methods update or reset

Description of data passed to callbacks (onChange and etc.)

Result is object type and passed to callback as first argument:

Obj: {
    "input": object,            // jQuery-link to input
    "slider": object,           // jQuery-link to sliders container
    "min": 1000,                // MIN value
    "max": 100000,              // MAX values
    "from": 10000,              // FROM value
    "from_percent": 10,         // FROM value in percents
    "from_value": 0,            // FROM index in values array (if used)
    "to": 90000,                // TO value
    "to_percent": 90,           // TO value in percents
    "to_value": 0,              // TO index in values array (if used)
    "min_pretty": "1 000",      // MIN prettified (if used)
    "max_pretty": "100 000",    // MAX prettified (if used)
    "from_pretty": "10 000",    // FROM prettified (if used)
    "to_pretty": "90 000"       // TO prettified (if used)
}

Creating slider (all params)

An example of a customised slider:

$("#example").ionRangeSlider({
    min: 0,
    max: 10000,
    from: 1000,
    to: 9000,
    type: 'double',
    prefix: "$",
    grid: true,
    grid_num: 10
});

You can also initialise slider with data-* attributes of input tag:

data-min="0"
data-max="10000"
data-from="1000"
data-to="9000"
data-type="double"
data-prefix="$"
data-grid="true"
data-grid-num="10"

Public methods

To use public methods, at first you must save slider instance to variable:

// Launch plugin
$("#range").ionRangeSlider({
    type: "double",
    min: 0,
    max: 1000,
    from: 200,
    to: 500,
    grid: true
});

// Saving it's instance to var
var slider = $("#range").data("ionRangeSlider");

// Fire public method
slider.reset();

There are 3 public methods:

// UPDATE - updates slider to any new values
slider.update({
    from: 300,
    to: 400
});

// RESET - reset slider to it's first values
slider.reset();

// DESTROY - destroys slider and restores original input field
slider.destroy();

One more look on demos

• Basic demo
• Advanced demo
• Interactions demo

All plugins options are covered in demos.

Update history

---

Support Ion-series plugins development:

• Donate through Pledgie service:

• Donate direct to my Paypal account: https://www.paypal.me/IonDen

• Donate direct to my Yandex.Money account: http://yasobe.ru/na/razrabotku