jQuery Knob

Demo

jQuery 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).

aterrien

small projects

Tweet Share