jQuery Knob
- 3 minsjQuery Knob
- canvas based ; no png or jpg sprites.
- touch, mouse and mousewheel, keyboard events implemented.
- downward compatible ; overloads an input element.
Example
<input type="text" value="75" class="dial">
<script>
$(function() {
$(".dial").knob();
});
</script>
Options
Options are provided as attributes ‘data-option’:
<input type="text" class="dial" data-min="-50" data-max="50">
… or in the “knob()” call :
$(".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 : display input (default=true)
- displayPrevious : displays the previous value with transparency (default=false)
- fgColor : foreground color
- inputColor : input value (number) color
- font : font family
- fontWeight : font weight
- bgColor : background color
Hooks
<script>
$(".dial").knob({
'release' : function (v) { /*make something*/ }
});
</script>
-
‘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
<input type="text" value="75" class="dial">
<script>
$(".dial").knob({
'change' : function (v) { console.log(v); }
});
</script>
Dynamically configure
<script>
$('.dial').trigger(
'configure',
{
"min":10,
"max":40,
"fgColor":"#FF0000",
"skin":"tron",
"cursor":true
}
);
</script>
Set the value
<script>
$('.dial')
.val(27)
.trigger('change');
</script>
Supported browser
Tested on Chrome, Safari, Firefox, IE>=8.0 (IE8.0 with excanvas).