Giter VIP home page Giter VIP logo

jquery-knob's Introduction

jQuery Knob

  • canvas based ; no png or jpg sprites.
  • touch, 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.
  • stopper : stop at 0 & 100 on keydown/mousewheel || default=true.
  • readOnly : disable input and events.
  • angleOffset: change the 0 position of the knob (in degree), || default=0.

UI :

  • cursor : display mode "cursor" | default=gauge.
  • thickness : gauge thickness.
  • width : dial width.
  • displayInput : default=true | false=hide input.
  • displayPrevious : default=false | true=displays the previous value with transparency.
  • fgColor : foreground color.
  • bgColor : background color.
  • ticks : number of ticks | 0=disable.
  • tickColor.
  • tickLength.
  • tickWidth.
  • tickColorizeValues : colorize ticks.
  • skin : default | "tron".

Hooks

<script>
$(".dial").knob({
                    'release':function(v,ipt) { /*make something*/ }
                });
</script>
  • 'release' : executed on release

    Parameters :

    • value : int, current value
    • input : jQuery element, input element
  • 'change' : executed at each change of the value

    Parameters :

    • value : int, current value
  • 'draw' : when drawing the canvas

    Parameters :

    • angle : computed angle
    • value : current value
    • opt : plugin options
    • context : Canvas context 2d

Example

<input type="text" value="75" class="dial">

<script>
$(".dial").knob(
                    {
                    'change':function(e){
                            console.log(e);
                        }
                    }
                );
</script>

Dynamically configure

<script>
$('.dial').trigger('configure',{"min":10, "max":40, "fgColor":"#FF0000", "skin":"tron", "cursor":true})
</script>

Supported browser

Tested on Chrome, Safari, Firefox, IE 9.0.

Revision 1.1.2

  • removed padding around the wheel in default skin / default thickness = 0.35.
  • 'configure' event.
  • added 'displayPrevious' option.
  • change color cgColor / 'displayPrevious' must be true.
  • escape keycode supported while changing = restore the current value.
  • tab keycode supported.
  • added 'stopper'.
  • bugfix init when 'value' attribute is not defined.
  • JSLint qa.
  • infinite mode demo.

Revision 1.1.1

  • keyboard/mousewheel control refactoring / acceleration.
  • bugfix no keyboard or mousewheel when readonly.
  • bugfix min/max can be exceeded.
  • hooks / keyboard events.

jquery-knob's People

Contributors

aterrien avatar eskimoblood avatar brunjo avatar

Stargazers

 avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.