Skip to content

sbwaggoner/jQuery-ui-Slider-Pips

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

#jQuery UI Slider Pips (v1.5.5) ####Plugin to add "pips" or "floats" to a JQUI Slider.

This plugin extends the jQuery UI Slider widget.
Use it for creating a nicely-styled slider like shown below:

Default settings for the plugin

Documentation, Demos and Examples here


###Requirements:

  • jQuery (1.9+)
  • jQuery UI (1.10+)
  • A Reason to use it

###Usage:
Include the plugin javascript file after jQuery & jQuery-ui.
Include the CSS file; edit as you please.
Below methods are chainable, I've shown them separate for clarity

####Default usage:

// if you just want the defaults, copy & paste this code.
$('.element').slider().slider('pips').slider('float');

####Advanced usage with options:

// First of all attach a slider to an element.
$('.element').slider();

// Then you can give it pips and labels!  
$('.element').slider('pips', {  
    first: 'label',  
    last: 'label',  
    rest: 'pip',  
    labels: ['label1', 'label2', ...],  
    prefix: "",  
    suffix: ""  
});

// And finally can add floaty numbers (if desired)  
$('.element').slider('float', {  
    handle: true,  
    pips: true,  
    labels: ['label1', 'label2', ...],  
    prefix: "",  
    suffix: ""  
});

####Options for pips:
first: 'pip' or 'label' or false
last: 'pip' or 'label' or false
rest: 'pip' or 'label' or false
labels: ['array','of','labels'] or false
prefix: "string"
suffix: "string"
formatLabel: function(val){ return this.prefix + val + this.suffix }

####Options for float:
handle: true or false
pips: true or false
labels: ['array','of','labels'] or false
prefix: "string"
suffix: "string"
formatLabel: function(val){ return this.prefix + val + this.suffix }


###Style Customisation:
All customisation should be done to the CSS file, or in your own CSS.
The base styles I've provided do a decent job in the Demo,
but they may need tweaking to suit your needs and UI theme.
For some inspiration and help with styling, go to the styling section of the documentation.


###Compatibility:
Modern Browsers, IE7+
(To really support IE7 you will need to do some CSS changes.)


###License:
Open Source MIT.
http://opensource.org/licenses/MIT


###Changlog:





  • Aug 28, 2013 - Update to 1.2
    • Convert to a grunt/node setup
    • Clean up code with jshint
    • Remove legacy demo




About

Plugin for adding little 'pips' , 'floats' and labels to a slider.

Resources

Stars

Watchers

Forks

Packages

No packages published