Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aterrien/jQuery-Knob
Nice, downward compatible, touchable, jQuery dial
https://github.com/aterrien/jQuery-Knob
Last synced: about 2 months ago
JSON representation
Nice, downward compatible, touchable, jQuery dial
- Host: GitHub
- URL: https://github.com/aterrien/jQuery-Knob
- Owner: aterrien
- License: mit
- Created: 2011-11-22T19:10:52.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2022-08-25T10:37:38.000Z (about 2 years ago)
- Last Synced: 2024-04-17T05:33:57.287Z (5 months ago)
- Language: JavaScript
- Homepage: http://anthonyterrien.com/knob/
- Size: 480 KB
- Stars: 5,040
- Watchers: 209
- Forks: 1,254
- Open Issues: 221
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
jQuery Knob
=============
- canvas based ; no png or jpg sprites.
- touch, mouse and mousewheel, keyboard events implemented.
- downward compatible ; overloads an input element.
Example
-------
```html
$(function() {
$(".dial").knob();
});
```
Options
-------
Options are provided as attributes 'data-option':
```html
```
... or in the "knob()" call :
```javascript
$(".dial").knob({
'min':-50,
'max':50
});
```
The following options are supported :
Behaviors :
* min : min value | default=0.
* max : max value | default=100.
* step : step size | default=1.
* angleOffset : starting angle in degrees | default=0.
* angleArc : arc size in degrees | default=360.
* stopper : stop at min & max on keydown/mousewheel | default=true.
* readOnly : disable input and events | default=false.
* rotation : direction of progression | default=clockwise.
UI :
* cursor : display mode "cursor", cursor size could be changed passing a numeric value to the option, default width is used when passing boolean value "true" | default=gauge.
* thickness : gauge thickness.
* lineCap : gauge stroke endings. | default=butt, round=rounded line endings
* width : dial width.
* height : dial height.
* displayInput : default=true | false=hide input.
* displayPrevious : default=false | true=displays the previous value with transparency.
* fgColor : foreground color.
* inputColor : input value (number) color.
* font : font family.
* fontWeight : font weight.
* bgColor : background color.
Hooks
-------
```html
$(".dial").knob({
'release' : function (v) { /*make something*/ }
});
```
* 'release' : executed on release
Parameters :
+ value : int, current value
* 'change' : executed at each change of the value
Parameters :
+ value : int, current value
* 'draw' : when drawing the canvas
Context :
- this.g : canvas context 2D (see Canvas documentation)
- this.$ : jQuery wrapped element
- this.o : options
- this.i : input
- ... console.log(this);
* 'cancel' : triggered on [esc] keydown
* 'format' : allows to format output (add unit %, ms ...)
The scope (this) of each hook function is the current Knob instance (refer to the demo code).
Example
-------
```html
$(".dial").knob({
'change' : function (v) { console.log(v); }
});
```
Dynamically configure
-------
```html
$('.dial').trigger(
'configure',
{
"min":10,
"max":40,
"fgColor":"#FF0000",
"skin":"tron",
"cursor":true
}
);
```
Set the value
-------
```html
$('.dial')
.val(27)
.trigger('change');
```
Supported browser
-------
Tested on Chrome, Safari, Firefox, IE>=8.0 (IE8.0 with excanvas).
