pathslider
v1.0.0-beta
Published
A jQuery numerical slider that follows a bezier path
Downloads
11
Maintainers
Readme
A jQuery numerical slider that follows a bezier path.
Features
- Numerical slider similar to the jQuery UI Slider - currently it only works with percentages (0-100%)
- This slider follows a bezier path. The parameters are set using the pathslider builder.
- Designed to work in older browsers (no canvas support), just add the path as a background image.
- Get and set the slider position dynamically.
- Slider handle (grip) can be set to rotate along with the angle of the curve (uses css3).
- Callback events are available: create, update, start, slide, change, and stop.
- The slider itself works in all browsers: IE6+, Opera, Chrome, Firefox and Safari (known issues below)
- Pathslider demo.
- Pathslider Builder.
Documentation
Wiki: Home | FAQ | Setup | Options | Events | Theme | Change
To Do:
- Add min, max and step options to use values, other than zero to one hundred percent, with the slider.
- Add enable, disable, destroy methods.
- Smooth out sliding by improving grip position calculation
- The grip jumps around quite a bit with some settings
- This can be minimized by adjusting the tolerance & range settings, but it needs a better method.
- Add more default handle (grip) styles in the css.
- Add ability to make a gradient/patterned stroke style of the curve; I'm not sure it will follow the path of the curve or just be a static background. Needs more testing!
- Add keyboard control to the slider when it has focus - arrows, page up/down, home and end.
- Add a circular path
- Combine multiple beziers to make extended shapes - my math skills are a bit lacking so this may take a while, unless someone out there is willing to help ;)
Dependencies
- jQuery 1.4.4+
- A browser that supports canvas (needed for the builder; optional for the pathslider plugin itself).
- A browser that supports css3 transforms (necessary to rotate the grip).
Known Bugs
- The grip/handle will work if the loop folds back on itself - try these points to see an example: 75,200,200,-125,-200,0,225,200
- The S-Curve demo seems to get stuck near 100% but only in Firefox and on the demo page. It works fine when isolated. The grip isn't staying centered under the cursor like it does in Chrome.
- Safari for Windows likes to start with the grip in the upper left corner of the slider box... most of the time when I hover over it, it jumps to where it should be... wow that is so weird. Also, the "S" curve demo doesn't want to work at all...
Change Log
Version 1.0.0-alpha (8/19/2016)
- Core:
- Builder:
- Switch to using
drawCanvas
callback. - Use
finishCurve
function. - Add curve shift controls.
- Switch to using
- Docs & Readme:
- Update libraries & colors.
- Make MIT license more prominent.
- Optimize png images.
- Extras:
- Add
.git
files. - Remove BOM from all files.
- Add grunt build script & dist folder.
- Add
Version 0.9.1 alpha (12/7/2011)
- Added touch device compatibility.
- Changed the grip "data-degree" attribute to "data-angle". This attribute contains the angle of transformation to rotate the grip.
- Changed the grip "data-position" attribute to "data-percent". This attribute contains the current percentage distance along the curve of the grip.
- Added some images for the wiki documentation.
Version 0.9 alpha (12/5/2011)
- Initial commit