readme.md

August 26, 2026 · View on GitHub

ion.RangeSlider — flexible and responsive range slider with skins, touch support, and a grid of values.

Features

6 built-in skins (flat, big, modern, round, sharp, square)
Single handle or double handle (range) mode
Negative and fractional values, custom step
Custom values array (numbers or strings)
Value grid with snapping
Prefix and postfix for displayed values ($100, 100k, etc.)
Large number formatting (10000000 → 10 000 000)
Reads from and writes to a native <input> element — works in any HTML form
Initialization via JavaScript or data-* attributes
Public methods: update, reset, destroy
Callbacks: onStart, onChange, onFinish, onUpdate
Keyboard navigation
Touch device support
Works in Internet Explorer 8+ and all modern browsers
MIT license

ion.rangeSlider

Demos

Dependencies

jQuery 1.8+. The browser suite has been run against every version in test/browser/matrix.mjs, from 1.8.3 to 4.0.0 including the 3.x and 4.x slim builds; the boundary versions run on every pull request and the full matrix runs weekly. The plugin's minified files are tested under jQuery 3.7.1 on every pull request.

Install

npm:

npm install ion-rangeslider

Yarn:

yarn add ion-rangeslider

CDN

Use cdnjs or jsDelivr.

<!-- CSS -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/ion-rangeslider/2.3.2/css/ion.rangeSlider.min.css"/>

<!-- jQuery -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>

<!-- Plugin -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/ion-rangeslider/2.3.2/js/ion.rangeSlider.min.js"></script>

Usage

The slider replaces a native text input:

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

Initialize it with:

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

Full example

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

Or use data-* attributes on the input:

<input type="text" id="example"
    data-min="0"
    data-max="10000"
    data-from="1000"
    data-to="9000"
    data-type="double"
    data-prefix="$"
    data-grid="true"
    data-grid-num="10"
/>

Settings

Option	Data-Attr	Defaults	Type	Description
`skin`	`data-skin`	`flat`	string	UI skin (flat, big, modern, round, sharp, square)
`type`	`data-type`	`single`	string	`single` for one handle, `double` for two handles
`min`	`data-min`	`10`	number	Minimum value
`max`	`data-max`	`100`	number	Maximum value
`from`	`data-from`	`min`	number	Start position for left handle (or single handle)
`to`	`data-to`	`max`	number	Start position for right handle
`step`	`data-step`	`1`	number	Step size. Always > 0. Can be fractional
`min_interval`	`data-min-interval`	`-`	number	Minimum range between handles. Double type only
`max_interval`	`data-max-interval`	`-`	number	Maximum range between handles. Double type only
`drag_interval`	`data-drag-interval`	`false`	boolean	Allow dragging the whole range. Double type only
`values`	`data-values`	`[]`	array	Custom array of possible values (numbers or strings). When set, min, max and step are ignored
`from_fixed`	`data-from-fixed`	`false`	boolean	Fix position of left (or single) handle
`from_min`	`data-from-min`	`min`	number	Minimum limit for left (or single) handle
`from_max`	`data-from-max`	`max`	number	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	Minimum limit for right handle
`to_max`	`data-to-max`	`max`	number	Maximum limit for right handle
`to_shadow`	`data-to-shadow`	`false`	boolean	Highlight the limits for right handle
`prettify_enabled`	`data-prettify-enabled`	`true`	boolean	Format long numbers: 10000000 → 10 000 000
`prettify_separator`	`data-prettify-separator`		string	Separator for long numbers: 10000000 → 10,000,000
`prettify`	`-`	`null`	function	Custom formatting function. Receives a number, returns a string (with `prettify_all_values`, non-numeric `values` entries are passed too)
`prettify_all_values`	`data-prettify-all-values`	`false`	boolean	In `values` mode, also run `prettify` on non-numeric entries. Default: `false`
`force_edges`	`data-force-edges`	`false`	boolean	Keep handles and tooltips inside the container
`keyboard`	`data-keyboard`	`true`	boolean	Keyboard controls. Left: ←, ↓, A, S. Right: →, ↑, W, D
`grid`	`data-grid`	`false`	boolean	Show grid of values above the slider
`grid_margin`	`data-grid-margin`	`true`	boolean	Add 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 step. When active, grid_num is not used. Max 50 steps
`hide_min_max`	`data-hide-min-max`	`false`	boolean	Hide min and max labels
`hide_from_to`	`data-hide-from-to`	`false`	boolean	Hide from and to labels
`prefix`	`data-prefix`	``	string	Prefix for values: $100
`min_prefix`	`data-min-prefix`	``	string	Prefix for the minimum value only: From: 0 — 100
`max_prefix`	`data-max-prefix`	``	string	Prefix for the maximum value only: 0 — Up to: 100
`postfix`	`data-postfix`	``	string	Postfix for values: 100k
`max_postfix`	`data-max-postfix`	``	string	Postfix for the maximum value only: 0 — 100+
`decorate_both`	`data-decorate-both`	`true`	boolean	How to format close values in double mode: $10k — $100k vs $10 — 100k
`values_separator`	`data-values-separator`	`—`	string	Separator between from and to labels in double mode
`input_values_separator`	`data-input-values-separator`	`;`	string	Separator in the input value for double mode: `<input value="25;42">`
`disable`	`data-disable`	`false`	boolean	Disable the slider. Input is also disabled and invisible to forms
`block`	`data-block`	`false`	boolean	Block the slider but keep the input enabled. Value is still submitted with the form
`extra_classes`	`data-extra-classes`	`—`	string	Extra CSS classes for the slider container
`scope`	`-`	`null`	object	Scope for callbacks
`onStart`	`-`	`null`	function	Called on slider start
`onChange`	`-`	`null`	function	Called on each value change
`onFinish`	`-`	`null`	function	Called when the user releases a handle
`onUpdate`	`-`	`null`	function	Called when slider is modified by `update` or `reset`

Callback data

All callbacks receive an object as the first argument:

{
    "input": object,            // jQuery reference to the input
    "slider": object,           // jQuery reference to the slider container
    "min": 1000,                // MIN value
    "max": 100000,              // MAX value
    "from": 10000,              // FROM value
    "from_percent": 10,         // FROM value in percent
    "from_value": 0,            // FROM index in values array (if used)
    "from_min": null,           // FROM minimum limit (null if unset)
    "from_max": null,           // FROM maximum limit (null if unset)
    "to": 90000,                // TO value
    "to_percent": 90,           // TO value in percent
    "to_value": 0,              // TO index in values array (if used)
    "to_min": null,             // TO minimum limit (null if unset)
    "to_max": null,             // TO maximum limit (null if unset)
    "min_pretty": "1 000",      // MIN formatted (if prettify is on)
    "max_pretty": "100 000",    // MAX formatted
    "from_pretty": "10 000",    // FROM formatted
    "to_pretty": "90 000"       // TO formatted
}

Public methods

Save the slider instance, then call methods on it:

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

// Get the instance
var slider = $("#range").data("ionRangeSlider");

// Update values
slider.update({
    from: 300,
    to: 400
});

// Reset to initial values
slider.reset();

// Remove the slider and restore the original input
slider.destroy();

Advanced examples

Experiments playground on JSFiddle