├── .gitignore ├── secretplan.jpg ├── bower.json ├── package.json ├── knob.jquery.json ├── LICENSE ├── README.md ├── dist └── jquery.knob.min.js ├── index.html ├── js └── jquery.knob.js └── excanvas.js /.gitignore: -------------------------------------------------------------------------------- 1 | nbproject/ -------------------------------------------------------------------------------- /secretplan.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aterrien/jQuery-Knob/HEAD/secretplan.jpg -------------------------------------------------------------------------------- /bower.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "jquery-knob", 3 | "version": "1.2.13", 4 | "main": "js/jquery.knob.js", 5 | "description": "Nice, downward compatible, touchable, jQuery dial.", 6 | "license": "MIT", 7 | "ignore": [], 8 | "dependencies": { 9 | "jquery": ">=1.7.0" 10 | }, 11 | "devDependencies": {} 12 | } 13 | 14 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "jquery-knob", 3 | "version": "1.2.13", 4 | "description": "Nice, downward compatible, touchable, jQuery dial", 5 | "main": "dist/jquery.knob.min.js", 6 | "scripts": { 7 | "test": "echo \"Error: no test specified\" && exit 1" 8 | }, 9 | "repository": { 10 | "type": "git", 11 | "url": "git+https://github.com/aterrien/jQuery-Knob.git" 12 | }, 13 | "keywords": [ 14 | "jquery", 15 | "knob", 16 | "dial" 17 | ], 18 | "author": "Anthony Terrien", 19 | "license": "MIT", 20 | "bugs": { 21 | "url": "https://github.com/aterrien/jQuery-Knob/issues" 22 | }, 23 | "homepage": "https://github.com/aterrien/jQuery-Knob#readme" 24 | } 25 | -------------------------------------------------------------------------------- /knob.jquery.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "knob", 3 | "title": "jQuery Knob", 4 | "description": "Nice, downward compatible, touchable, jQuery dial.", 5 | "keywords": [ 6 | "dial", 7 | "button", 8 | "knob", 9 | "ui", 10 | "input" 11 | ], 12 | "version": "1.2.13", 13 | "author": { 14 | "name": "Anthony Terrien", 15 | "url": "https://github.com/aterrien" 16 | }, 17 | "maintainers": [ 18 | { 19 | "name": "Anthony Terrien", 20 | "email": "kontrol@anthonyterrien.com", 21 | "url": "http://anthonyterrien.com/knob" 22 | } 23 | ], 24 | "licenses": [ 25 | { 26 | "type": "MIT", 27 | "url": "http://opensource.org/licenses/mit-license.php" 28 | } 29 | ], 30 | "bugs": "https://github.com/aterrien/jQuery-Knob/issues", 31 | "homepage": "https://github.com/aterrien/jQuery-Knob", 32 | "docs": "https://github.com/aterrien/jQuery-Knob", 33 | "download": "https://github.com/aterrien/jQuery-Knob/tags", 34 | "dependencies": { 35 | "jquery": ">=1.7.0" 36 | } 37 | } 38 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | 3 | Copyright (c) 2013 Anthony Terrien 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy of 6 | this software and associated documentation files (the "Software"), to deal in 7 | the Software without restriction, including without limitation the rights to 8 | use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of 9 | the Software, and to permit persons to whom the Software is furnished to do so, 10 | subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS 17 | FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR 18 | COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 19 | IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 20 | CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 21 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | jQuery Knob 2 | ============= 3 | 4 | - canvas based ; no png or jpg sprites. 5 | - touch, mouse and mousewheel, keyboard events implemented. 6 | - downward compatible ; overloads an input element. 7 | 8 | Example 9 | ------- 10 | 11 | ```html 12 | 13 | 14 | 19 | ``` 20 | 21 | Options 22 | ------- 23 | 24 | Options are provided as attributes 'data-option': 25 | 26 | ```html 27 | 28 | ``` 29 | 30 | ... or in the "knob()" call : 31 | 32 | ```javascript 33 | $(".dial").knob({ 34 | 'min':-50, 35 | 'max':50 36 | }); 37 | ``` 38 | 39 | The following options are supported : 40 | 41 | Behaviors : 42 | * min : min value | default=0. 43 | * max : max value | default=100. 44 | * step : step size | default=1. 45 | * angleOffset : starting angle in degrees | default=0. 46 | * angleArc : arc size in degrees | default=360. 47 | * stopper : stop at min & max on keydown/mousewheel | default=true. 48 | * readOnly : disable input and events | default=false. 49 | * rotation : direction of progression | default=clockwise. 50 | 51 | UI : 52 | * 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. 53 | * thickness : gauge thickness. 54 | * lineCap : gauge stroke endings. | default=butt, round=rounded line endings 55 | * width : dial width. 56 | * height : dial height. 57 | * displayInput : default=true | false=hide input. 58 | * displayPrevious : default=false | true=displays the previous value with transparency. 59 | * fgColor : foreground color. 60 | * inputColor : input value (number) color. 61 | * font : font family. 62 | * fontWeight : font weight. 63 | * bgColor : background color. 64 | 65 | Hooks 66 | ------- 67 | 68 | ```html 69 | 74 | ``` 75 | 76 | * 'release' : executed on release 77 | 78 | Parameters : 79 | + value : int, current value 80 | 81 | * 'change' : executed at each change of the value 82 | 83 | Parameters : 84 | + value : int, current value 85 | 86 | * 'draw' : when drawing the canvas 87 | 88 | Context : 89 | - this.g : canvas context 2D (see Canvas documentation) 90 | - this.$ : jQuery wrapped element 91 | - this.o : options 92 | - this.i : input 93 | - ... console.log(this); 94 | 95 | * 'cancel' : triggered on [esc] keydown 96 | 97 | * 'format' : allows to format output (add unit %, ms ...) 98 | 99 | The scope (this) of each hook function is the current Knob instance (refer to the demo code). 100 | 101 | Example 102 | ------- 103 | 104 | ```html 105 | 106 | 107 | 112 | ``` 113 | 114 | Dynamically configure 115 | ------- 116 | 117 | ```html 118 | 130 | ``` 131 | 132 | Set the value 133 | ------- 134 | 135 | ```html 136 | 141 | ``` 142 | 143 | Supported browser 144 | ------- 145 | 146 | Tested on Chrome, Safari, Firefox, IE>=8.0 (IE8.0 with excanvas). 147 | 148 |  149 | -------------------------------------------------------------------------------- /dist/jquery.knob.min.js: -------------------------------------------------------------------------------- 1 | (function(e){if(typeof define==="function"&&define.amd){define(["jquery"],e)}else{e(jQuery)}})(function(e){"use strict";var t={},n=Math.max,r=Math.min;t.c={};t.c.d=e(document);t.c.t=function(e){return e.originalEvent.touches.length-1};t.o=function(){var n=this;this.o=null;this.$=null;this.i=null;this.g=null;this.v=null;this.cv=null;this.x=0;this.y=0;this.w=0;this.h=0;this.$c=null;this.c=null;this.t=0;this.isInit=false;this.fgColor=null;this.pColor=null;this.dH=null;this.cH=null;this.eH=null;this.rH=null;this.scale=1;this.relative=false;this.relativeWidth=false;this.relativeHeight=false;this.$div=null;this.run=function(){var t=function(e,t){var r;for(r in t){n.o[r]=t[r]}n._carve().init();n._configure()._draw()};if(this.$.data("kontroled"))return;this.$.data("kontroled",true);this.extend();this.o=e.extend({min:this.$.data("min")!==undefined?this.$.data("min"):0,max:this.$.data("max")!==undefined?this.$.data("max"):100,stopper:true,readOnly:this.$.data("readonly")||this.$.attr("readonly")==="readonly",cursor:this.$.data("cursor")===true&&30||this.$.data("cursor")||0,thickness:this.$.data("thickness")&&Math.max(Math.min(this.$.data("thickness"),1),.01)||.35,lineCap:this.$.data("linecap")||"butt",width:this.$.data("width")||200,height:this.$.data("height")||200,displayInput:this.$.data("displayinput")==null||this.$.data("displayinput"),displayPrevious:this.$.data("displayprevious"),fgColor:this.$.data("fgcolor")||"#87CEEB",inputColor:this.$.data("inputcolor"),font:this.$.data("font")||"Arial",fontWeight:this.$.data("font-weight")||"bold",inline:false,step:this.$.data("step")||1,rotation:this.$.data("rotation"),draw:null,change:null,cancel:null,release:null,format:function(e){return e},parse:function(e){return parseFloat(e)}},this.o);this.o.flip=this.o.rotation==="anticlockwise"||this.o.rotation==="acw";if(!this.o.inputColor){this.o.inputColor=this.o.fgColor}if(this.$.is("fieldset")){this.v={};this.i=this.$.find("input");this.i.each(function(t){var r=e(this);n.i[t]=r;n.v[t]=n.o.parse(r.val());r.bind("change blur",function(){var e={};e[t]=r.val();n.val(n._validate(e))})});this.$.find("legend").remove()}else{this.i=this.$;this.v=this.o.parse(this.$.val());this.v===""&&(this.v=this.o.min);this.$.bind("change blur",function(){n.val(n._validate(n.o.parse(n.$.val())))})}!this.o.displayInput&&this.$.hide();this.$c=e(document.createElement("canvas")).attr({width:this.o.width,height:this.o.height});this.$div=e('
');this.$.wrap(this.$div).before(this.$c);this.$div=this.$.parent();if(typeof G_vmlCanvasManager!=="undefined"){G_vmlCanvasManager.initElement(this.$c[0])}this.c=this.$c[0].getContext?this.$c[0].getContext("2d"):null;if(!this.c){throw{name:"CanvasNotSupportedException",message:"Canvas not supported. Please use excanvas on IE8.0.",toString:function(){return this.name+": "+this.message}}}this.scale=(window.devicePixelRatio||1)/(this.c.webkitBackingStorePixelRatio||this.c.mozBackingStorePixelRatio||this.c.msBackingStorePixelRatio||this.c.oBackingStorePixelRatio||this.c.backingStorePixelRatio||1);this.relativeWidth=this.o.width%1!==0&&this.o.width.indexOf("%");this.relativeHeight=this.o.height%1!==0&&this.o.height.indexOf("%");this.relative=this.relativeWidth||this.relativeHeight;this._carve();if(this.v instanceof Object){this.cv={};this.copy(this.v,this.cv)}else{this.cv=this.v}this.$.bind("configure",t).parent().bind("configure",t);this._listen()._configure()._xy().init();this.isInit=true;this.$.val(this.o.format(this.v));this._draw();return this};this._carve=function(){if(this.relative){var e=this.relativeWidth?this.$div.parent().width()*parseInt(this.o.width)/100:this.$div.parent().width(),t=this.relativeHeight?this.$div.parent().height()*parseInt(this.o.height)/100:this.$div.parent().height();this.w=this.h=Math.min(e,t)}else{this.w=this.o.width;this.h=this.o.height}this.$div.css({width:this.w+"px",height:this.h+"px"});this.$c.attr({width:this.w,height:this.h});if(this.scale!==1){this.$c[0].width=this.$c[0].width*this.scale;this.$c[0].height=this.$c[0].height*this.scale;this.$c.width(this.w);this.$c.height(this.h)}return this};this._draw=function(){var e=true;n.g=n.c;n.clear();n.dH&&(e=n.dH());e!==false&&n.draw()};this._touch=function(e){var r=function(e){var t=n.xy2val(e.originalEvent.touches[n.t].pageX,e.originalEvent.touches[n.t].pageY);if(t==n.cv)return;if(n.cH&&n.cH(t)===false)return;n.change(n._validate(t));n._draw()};this.t=t.c.t(e);r(e);t.c.d.bind("touchmove.k",r).bind("touchend.k",function(){t.c.d.unbind("touchmove.k touchend.k");n.val(n.cv)});return this};this._mouse=function(e){var r=function(e){var t=n.xy2val(e.pageX,e.pageY);if(t==n.cv)return;if(n.cH&&n.cH(t)===false)return;n.change(n._validate(t));n._draw()};r(e);t.c.d.bind("mousemove.k",r).bind("keyup.k",function(e){if(e.keyCode===27){t.c.d.unbind("mouseup.k mousemove.k keyup.k");if(n.eH&&n.eH()===false)return;n.cancel()}}).bind("mouseup.k",function(e){t.c.d.unbind("mousemove.k mouseup.k keyup.k");n.val(n.cv)});return this};this._xy=function(){var e=this.$c.offset();this.x=e.left;this.y=e.top;return this};this._listen=function(){if(!this.o.readOnly){this.$c.bind("mousedown",function(e){e.preventDefault();n._xy()._mouse(e)}).bind("touchstart",function(e){e.preventDefault();n._xy()._touch(e)});this.listen()}else{this.$.attr("readonly","readonly")}if(this.relative){e(window).resize(function(){n._carve().init();n._draw()})}return this};this._configure=function(){if(this.o.draw)this.dH=this.o.draw;if(this.o.change)this.cH=this.o.change;if(this.o.cancel)this.eH=this.o.cancel;if(this.o.release)this.rH=this.o.release;if(this.o.displayPrevious){this.pColor=this.h2rgba(this.o.fgColor,"0.4");this.fgColor=this.h2rgba(this.o.fgColor,"0.6")}else{this.fgColor=this.o.fgColor}return this};this._clear=function(){this.$c[0].width=this.$c[0].width};this._validate=function(e){var t=~~((e<0?-.5:.5)+e/this.o.step)*this.o.step;return Math.round(t*100)/100};this.listen=function(){};this.extend=function(){};this.init=function(){};this.change=function(e){};this.val=function(e){};this.xy2val=function(e,t){};this.draw=function(){};this.clear=function(){this._clear()};this.h2rgba=function(e,t){var n;e=e.substring(1,7);n=[parseInt(e.substring(0,2),16),parseInt(e.substring(2,4),16),parseInt(e.substring(4,6),16)];return"rgba("+n[0]+","+n[1]+","+n[2]+","+t+")"};this.copy=function(e,t){for(var n in e){t[n]=e[n]}}};t.Dial=function(){t.o.call(this);this.startAngle=null;this.xy=null;this.radius=null;this.lineWidth=null;this.cursorExt=null;this.w2=null;this.PI2=2*Math.PI;this.extend=function(){this.o=e.extend({bgColor:this.$.data("bgcolor")||"#EEEEEE",angleOffset:this.$.data("angleoffset")||0,angleArc:this.$.data("anglearc")||360,inline:true},this.o)};this.val=function(e,t){if(null!=e){e=this.o.parse(e);if(t!==false&&e!=this.v&&this.rH&&this.rH(e)===false){return}this.cv=this.o.stopper?n(r(e,this.o.max),this.o.min):e;this.v=this.cv;this.$.val(this.o.format(this.v));this._draw()}else{return this.v}};this.xy2val=function(e,t){var i,s;i=Math.atan2(e-(this.x+this.w2),-(t-this.y-this.w2))-this.angleOffset;if(this.o.flip){i=this.angleArc-i-this.PI2}if(this.angleArc!=this.PI2&&i<0&&i>-.5){i=0}else if(i<0){i+=this.PI2}s=i*(this.o.max-this.o.min)/this.angleArc+this.o.min;this.o.stopper&&(s=n(r(s,this.o.max),this.o.min));return s};this.listen=function(){var t=this,i,s,o=function(e){e.preventDefault();var o=e.originalEvent,u=o.detail||o.wheelDeltaX,a=o.detail||o.wheelDeltaY,f=t._validate(t.o.parse(t.$.val()))+(u>0||a>0?t.o.step:u<0||a<0?-t.o.step:0);f=n(r(f,t.o.max),t.o.min);t.val(f,false);if(t.rH){clearTimeout(i);i=setTimeout(function(){t.rH(f);i=null},100);if(!s){s=setTimeout(function(){if(i)t.rH(f);s=null},200)}}},u,a,f=1,l={37:-t.o.step,38:t.o.step,39:t.o.step,40:-t.o.step};this.$.bind("keydown",function(i){var s=i.keyCode;if(s>=96&&s<=105){s=i.keyCode=s-48}u=parseInt(String.fromCharCode(s));if(isNaN(u)){s!==13&&s!==8&&s!==9&&s!==189&&(s!==190||t.$.val().match(/\./))&&i.preventDefault();if(e.inArray(s,[37,38,39,40])>-1){i.preventDefault();var o=t.o.parse(t.$.val())+l[s]*f;t.o.stopper&&(o=n(r(o,t.o.max),t.o.min));t.change(t._validate(o));t._draw();a=window.setTimeout(function(){f*=2},30)}}}).bind("keyup",function(e){if(isNaN(u)){if(a){window.clearTimeout(a);a=null;f=1;t.val(t.$.val())}}else{t.$.val()>t.o.max&&t.$.val(t.o.max)||t.$.val()Nice, downward compatible, touchable, jQuery dial. 
* implemented interactions : mouse click and wheel mouse, keyboard (on focus) and fingers (touch events)
112 |× Disable display input
115 |116 | data-width="100" 117 | data-displayInput=false 118 |119 | 120 |
× 'cursor' mode
123 |124 | data-width="150" 125 | data-cursor=true 126 | data-thickness=.3 127 | data-fgColor="#222222" 128 |129 | 130 |
× Display previous value
133 |134 | data-displayPrevious=true 135 | data-min="-100" 136 |137 | 138 |
× Angle offset
142 |143 | data-angleOffset=90 144 | data-linecap=round 145 |146 | 147 |
× Angle offset and arc
150 |151 | data-fgColor="#66CC66" 152 | data-angleOffset=-125 153 | data-angleArc=250 154 | data-rotation=anticlockwise 155 |156 | 157 |
× 4-digit, step 0.1
160 |161 | data-step=".1" 162 | data-min="-10000" 163 | data-max="10000" 164 | value="0" 165 | data-displayPrevious=true 166 |167 | 168 |
× Overloaded 'draw' method
172 |176 | data-width="75" 177 | data-fgColor="#ffec03" 178 | data-skin="tron" 179 | data-thickness=".2" 180 | data-displayPrevious=true 181 |182 | 183 |
186 | data-width="150" 187 | data-fgColor="#ffec03" 188 | data-skin="tron" 189 | data-thickness=".2" 190 | data-displayPrevious=true 191 |192 | 193 |
196 | data-width="150" 197 | data-fgColor="#C0ffff" 198 | data-skin="tron" 199 | data-thickness=".1" 200 | data-angleOffset="180" 201 |202 | 203 |
× Responsive
208 |209 | data-width="80%" 210 |211 |
× Superpose (clock)
242 |× Readonly
257 |258 | readonly (or data-readOnly=true) 259 | data-thickness=".4" 260 | data-fgColor="chartreuse" 261 |262 | 263 |
× Dynamic
266 |267 | data-width="200" 268 |269 | 270 | 271 |
272 | data-width="50" 273 | data-cursor=true 274 |275 | 276 | 277 |
× Infinite || iPod click wheel
280 |282 | data-width="150" 283 | data-cursor=true 284 | data-thickness=".5" 285 | data-fgColor="#AAAAAA" 286 | data-bgColor="#FFFFFF" 287 | data-displayInput="false" 288 | + some code 289 |290 | 291 |
300 | jQuery Knob is © 2012 Anthony Terrien - MIT License
301 |
51 | * k.o.call(this);
52 | *
53 | */
54 | k.o = function () {
55 | var s = this;
56 |
57 | this.o = null; // array of options
58 | this.$ = null; // jQuery wrapped element
59 | this.i = null; // mixed HTMLInputElement or array of HTMLInputElement
60 | this.g = null; // deprecated 2D graphics context for 'pre-rendering'
61 | this.v = null; // value ; mixed array or integer
62 | this.cv = null; // change value ; not commited value
63 | this.x = 0; // canvas x position
64 | this.y = 0; // canvas y position
65 | this.w = 0; // canvas width
66 | this.h = 0; // canvas height
67 | this.$c = null; // jQuery canvas element
68 | this.c = null; // rendered canvas context
69 | this.t = 0; // touches index
70 | this.isInit = false;
71 | this.fgColor = null; // main color
72 | this.pColor = null; // previous color
73 | this.dH = null; // draw hook
74 | this.cH = null; // change hook
75 | this.eH = null; // cancel hook
76 | this.rH = null; // release hook
77 | this.scale = 1; // scale factor
78 | this.relative = false;
79 | this.relativeWidth = false;
80 | this.relativeHeight = false;
81 | this.$div = null; // component div
82 |
83 | this.run = function () {
84 | var cf = function (e, conf) {
85 | var k;
86 | for (k in conf) {
87 | s.o[k] = conf[k];
88 | }
89 | s._carve().init();
90 | s._configure()
91 | ._draw();
92 | };
93 |
94 | if (this.$.data('kontroled')) return;
95 | this.$.data('kontroled', true);
96 |
97 | this.extend();
98 | this.o = $.extend({
99 | // Config
100 | min: this.$.data('min') !== undefined ? this.$.data('min') : 0,
101 | max: this.$.data('max') !== undefined ? this.$.data('max') : 100,
102 | stopper: true,
103 | readOnly: this.$.data('readonly') || (this.$.attr('readonly') === 'readonly'),
104 |
105 | // UI
106 | cursor: this.$.data('cursor') === true && 30
107 | || this.$.data('cursor') || 0,
108 | thickness: this.$.data('thickness')
109 | && Math.max(Math.min(this.$.data('thickness'), 1), 0.01)
110 | || 0.35,
111 | lineCap: this.$.data('linecap') || 'butt',
112 | width: this.$.data('width') || 200,
113 | height: this.$.data('height') || 200,
114 | displayInput: this.$.data('displayinput') == null || this.$.data('displayinput'),
115 | displayPrevious: this.$.data('displayprevious'),
116 | fgColor: this.$.data('fgcolor') || '#87CEEB',
117 | inputColor: this.$.data('inputcolor'),
118 | font: this.$.data('font') || 'Arial',
119 | fontWeight: this.$.data('font-weight') || 'bold',
120 | inline: false,
121 | step: this.$.data('step') || 1,
122 | rotation: this.$.data('rotation'),
123 |
124 | // Hooks
125 | draw: null, // function () {}
126 | change: null, // function (value) {}
127 | cancel: null, // function () {}
128 | release: null, // function (value) {}
129 |
130 | // Output formatting, allows to add unit: %, ms ...
131 | format: function(v) {
132 | return v;
133 | },
134 | parse: function (v) {
135 | return parseFloat(v);
136 | }
137 | }, this.o
138 | );
139 |
140 | // finalize options
141 | this.o.flip = this.o.rotation === 'anticlockwise' || this.o.rotation === 'acw';
142 | if (!this.o.inputColor) {
143 | this.o.inputColor = this.o.fgColor;
144 | }
145 |
146 | // routing value
147 | if (this.$.is('fieldset')) {
148 |
149 | // fieldset = array of integer
150 | this.v = {};
151 | this.i = this.$.find('input');
152 | this.i.each(function(k) {
153 | var $this = $(this);
154 | s.i[k] = $this;
155 | s.v[k] = s.o.parse($this.val());
156 |
157 | $this.bind(
158 | 'change blur',
159 | function () {
160 | var val = {};
161 | val[k] = $this.val();
162 | s.val(s._validate(val));
163 | }
164 | );
165 | });
166 | this.$.find('legend').remove();
167 | } else {
168 |
169 | // input = integer
170 | this.i = this.$;
171 | this.v = this.o.parse(this.$.val());
172 | this.v === '' && (this.v = this.o.min);
173 | this.$.bind(
174 | 'change blur',
175 | function () {
176 | s.val(s._validate(s.o.parse(s.$.val())));
177 | }
178 | );
179 |
180 | }
181 |
182 | !this.o.displayInput && this.$.hide();
183 |
184 | // adds needed DOM elements (canvas, div)
185 | this.$c = $(document.createElement('canvas')).attr({
186 | width: this.o.width,
187 | height: this.o.height
188 | });
189 |
190 | // wraps all elements in a div
191 | // add to DOM before Canvas init is triggered
192 | this.$div = $('');
196 |
197 | this.$.wrap(this.$div).before(this.$c);
198 | this.$div = this.$.parent();
199 |
200 | if (typeof G_vmlCanvasManager !== 'undefined') {
201 | G_vmlCanvasManager.initElement(this.$c[0]);
202 | }
203 |
204 | this.c = this.$c[0].getContext ? this.$c[0].getContext('2d') : null;
205 |
206 | if (!this.c) {
207 | throw {
208 | name: "CanvasNotSupportedException",
209 | message: "Canvas not supported. Please use excanvas on IE8.0.",
210 | toString: function(){return this.name + ": " + this.message}
211 | }
212 | }
213 |
214 | // hdpi support
215 | this.scale = (window.devicePixelRatio || 1) / (
216 | this.c.webkitBackingStorePixelRatio ||
217 | this.c.mozBackingStorePixelRatio ||
218 | this.c.msBackingStorePixelRatio ||
219 | this.c.oBackingStorePixelRatio ||
220 | this.c.backingStorePixelRatio || 1
221 | );
222 |
223 | // detects relative width / height
224 | this.relativeWidth = this.o.width % 1 !== 0
225 | && this.o.width.indexOf('%');
226 | this.relativeHeight = this.o.height % 1 !== 0
227 | && this.o.height.indexOf('%');
228 | this.relative = this.relativeWidth || this.relativeHeight;
229 |
230 | // computes size and carves the component
231 | this._carve();
232 |
233 | // prepares props for transaction
234 | if (this.v instanceof Object) {
235 | this.cv = {};
236 | this.copy(this.v, this.cv);
237 | } else {
238 | this.cv = this.v;
239 | }
240 |
241 | // binds configure event
242 | this.$
243 | .bind("configure", cf)
244 | .parent()
245 | .bind("configure", cf);
246 |
247 | // finalize init
248 | this._listen()
249 | ._configure()
250 | ._xy()
251 | .init();
252 |
253 | this.isInit = true;
254 |
255 | this.$.val(this.o.format(this.v));
256 | this._draw();
257 |
258 | return this;
259 | };
260 |
261 | this._carve = function() {
262 | if (this.relative) {
263 | var w = this.relativeWidth ?
264 | this.$div.parent().width() *
265 | parseInt(this.o.width) / 100
266 | : this.$div.parent().width(),
267 | h = this.relativeHeight ?
268 | this.$div.parent().height() *
269 | parseInt(this.o.height) / 100
270 | : this.$div.parent().height();
271 |
272 | // apply relative
273 | this.w = this.h = Math.min(w, h);
274 | } else {
275 | this.w = this.o.width;
276 | this.h = this.o.height;
277 | }
278 |
279 | // finalize div
280 | this.$div.css({
281 | 'width': this.w + 'px',
282 | 'height': this.h + 'px'
283 | });
284 |
285 | // finalize canvas with computed width
286 | this.$c.attr({
287 | width: this.w,
288 | height: this.h
289 | });
290 |
291 | // scaling
292 | if (this.scale !== 1) {
293 | this.$c[0].width = this.$c[0].width * this.scale;
294 | this.$c[0].height = this.$c[0].height * this.scale;
295 | this.$c.width(this.w);
296 | this.$c.height(this.h);
297 | }
298 |
299 | return this;
300 | };
301 |
302 | this._draw = function () {
303 |
304 | // canvas pre-rendering
305 | var d = true;
306 |
307 | s.g = s.c;
308 |
309 | s.clear();
310 |
311 | s.dH && (d = s.dH());
312 |
313 | d !== false && s.draw();
314 | };
315 |
316 | this._touch = function (e) {
317 | var touchMove = function (e) {
318 | var v = s.xy2val(
319 | e.originalEvent.touches[s.t].pageX,
320 | e.originalEvent.touches[s.t].pageY
321 | );
322 |
323 | if (v == s.cv) return;
324 |
325 | if (s.cH && s.cH(v) === false) return;
326 |
327 | s.change(s._validate(v));
328 | s._draw();
329 | };
330 |
331 | // get touches index
332 | this.t = k.c.t(e);
333 |
334 | // First touch
335 | touchMove(e);
336 |
337 | // Touch events listeners
338 | k.c.d
339 | .bind("touchmove.k", touchMove)
340 | .bind(
341 | "touchend.k",
342 | function () {
343 | k.c.d.unbind('touchmove.k touchend.k');
344 | s.val(s.cv);
345 | }
346 | );
347 |
348 | return this;
349 | };
350 |
351 | this._mouse = function (e) {
352 | var mouseMove = function (e) {
353 | var v = s.xy2val(e.pageX, e.pageY);
354 |
355 | if (v == s.cv) return;
356 |
357 | if (s.cH && (s.cH(v) === false)) return;
358 |
359 | s.change(s._validate(v));
360 | s._draw();
361 | };
362 |
363 | // First click
364 | mouseMove(e);
365 |
366 | // Mouse events listeners
367 | k.c.d
368 | .bind("mousemove.k", mouseMove)
369 | .bind(
370 | // Escape key cancel current change
371 | "keyup.k",
372 | function (e) {
373 | if (e.keyCode === 27) {
374 | k.c.d.unbind("mouseup.k mousemove.k keyup.k");
375 |
376 | if (s.eH && s.eH() === false)
377 | return;
378 |
379 | s.cancel();
380 | }
381 | }
382 | )
383 | .bind(
384 | "mouseup.k",
385 | function (e) {
386 | k.c.d.unbind('mousemove.k mouseup.k keyup.k');
387 | s.val(s.cv);
388 | }
389 | );
390 |
391 | return this;
392 | };
393 |
394 | this._xy = function () {
395 | var o = this.$c.offset();
396 | this.x = o.left;
397 | this.y = o.top;
398 |
399 | return this;
400 | };
401 |
402 | this._listen = function () {
403 | if (!this.o.readOnly) {
404 | this.$c
405 | .bind(
406 | "mousedown",
407 | function (e) {
408 | e.preventDefault();
409 | s._xy()._mouse(e);
410 | }
411 | )
412 | .bind(
413 | "touchstart",
414 | function (e) {
415 | e.preventDefault();
416 | s._xy()._touch(e);
417 | }
418 | );
419 |
420 | this.listen();
421 | } else {
422 | this.$.attr('readonly', 'readonly');
423 | }
424 |
425 | if (this.relative) {
426 | $(window).resize(function() {
427 | s._carve().init();
428 | s._draw();
429 | });
430 | }
431 |
432 | return this;
433 | };
434 |
435 | this._configure = function () {
436 |
437 | // Hooks
438 | if (this.o.draw) this.dH = this.o.draw;
439 | if (this.o.change) this.cH = this.o.change;
440 | if (this.o.cancel) this.eH = this.o.cancel;
441 | if (this.o.release) this.rH = this.o.release;
442 |
443 | if (this.o.displayPrevious) {
444 | this.pColor = this.h2rgba(this.o.fgColor, "0.4");
445 | this.fgColor = this.h2rgba(this.o.fgColor, "0.6");
446 | } else {
447 | this.fgColor = this.o.fgColor;
448 | }
449 |
450 | return this;
451 | };
452 |
453 | this._clear = function () {
454 | this.$c[0].width = this.$c[0].width;
455 | };
456 |
457 | this._validate = function (v) {
458 | var val = (~~ (((v < 0) ? -0.5 : 0.5) + (v/this.o.step))) * this.o.step;
459 | return Math.round(val * 100) / 100;
460 | };
461 |
462 | // Abstract methods
463 | this.listen = function () {}; // on start, one time
464 | this.extend = function () {}; // each time configure triggered
465 | this.init = function () {}; // each time configure triggered
466 | this.change = function (v) {}; // on change
467 | this.val = function (v) {}; // on release
468 | this.xy2val = function (x, y) {}; //
469 | this.draw = function () {}; // on change / on release
470 | this.clear = function () { this._clear(); };
471 |
472 | // Utils
473 | this.h2rgba = function (h, a) {
474 | var rgb;
475 | h = h.substring(1,7);
476 | rgb = [
477 | parseInt(h.substring(0,2), 16),
478 | parseInt(h.substring(2,4), 16),
479 | parseInt(h.substring(4,6), 16)
480 | ];
481 |
482 | return "rgba(" + rgb[0] + "," + rgb[1] + "," + rgb[2] + "," + a + ")";
483 | };
484 |
485 | this.copy = function (f, t) {
486 | for (var i in f) {
487 | t[i] = f[i];
488 | }
489 | };
490 | };
491 |
492 |
493 | /**
494 | * k.Dial
495 | */
496 | k.Dial = function () {
497 | k.o.call(this);
498 |
499 | this.startAngle = null;
500 | this.xy = null;
501 | this.radius = null;
502 | this.lineWidth = null;
503 | this.cursorExt = null;
504 | this.w2 = null;
505 | this.PI2 = 2*Math.PI;
506 |
507 | this.extend = function () {
508 | this.o = $.extend({
509 | bgColor: this.$.data('bgcolor') || '#EEEEEE',
510 | angleOffset: this.$.data('angleoffset') || 0,
511 | angleArc: this.$.data('anglearc') || 360,
512 | inline: true
513 | }, this.o);
514 | };
515 |
516 | this.val = function (v, triggerRelease) {
517 | if (null != v) {
518 |
519 | // reverse format
520 | v = this.o.parse(v);
521 |
522 | if (triggerRelease !== false
523 | && v != this.v
524 | && this.rH
525 | && this.rH(v) === false) { return; }
526 |
527 | this.cv = this.o.stopper ? max(min(v, this.o.max), this.o.min) : v;
528 | this.v = this.cv;
529 | this.$.val(this.o.format(this.v));
530 | this._draw();
531 | } else {
532 | return this.v;
533 | }
534 | };
535 |
536 | this.xy2val = function (x, y) {
537 | var a, ret;
538 |
539 | a = Math.atan2(
540 | x - (this.x + this.w2),
541 | - (y - this.y - this.w2)
542 | ) - this.angleOffset;
543 |
544 | if (this.o.flip) {
545 | a = this.angleArc - a - this.PI2;
546 | }
547 |
548 | if (this.angleArc != this.PI2 && (a < 0) && (a > -0.5)) {
549 |
550 | // if isset angleArc option, set to min if .5 under min
551 | a = 0;
552 | } else if (a < 0) {
553 | a += this.PI2;
554 | }
555 |
556 | ret = (a * (this.o.max - this.o.min) / this.angleArc) + this.o.min;
557 |
558 | this.o.stopper && (ret = max(min(ret, this.o.max), this.o.min));
559 |
560 | return ret;
561 | };
562 |
563 | this.listen = function () {
564 |
565 | // bind MouseWheel
566 | var s = this, mwTimerStop,
567 | mwTimerRelease,
568 | mw = function (e) {
569 | e.preventDefault();
570 |
571 | var ori = e.originalEvent,
572 | deltaX = ori.detail || ori.wheelDeltaX,
573 | deltaY = ori.detail || ori.wheelDeltaY,
574 | v = s._validate(s.o.parse(s.$.val()))
575 | + (
576 | deltaX > 0 || deltaY > 0
577 | ? s.o.step
578 | : deltaX < 0 || deltaY < 0 ? -s.o.step : 0
579 | );
580 |
581 | v = max(min(v, s.o.max), s.o.min);
582 |
583 | s.val(v, false);
584 |
585 | if (s.rH) {
586 | // Handle mousewheel stop
587 | clearTimeout(mwTimerStop);
588 | mwTimerStop = setTimeout(function () {
589 | s.rH(v);
590 | mwTimerStop = null;
591 | }, 100);
592 |
593 | // Handle mousewheel releases
594 | if (!mwTimerRelease) {
595 | mwTimerRelease = setTimeout(function () {
596 | if (mwTimerStop)
597 | s.rH(v);
598 | mwTimerRelease = null;
599 | }, 200);
600 | }
601 | }
602 | },
603 | kval,
604 | to,
605 | m = 1,
606 | kv = {
607 | 37: -s.o.step,
608 | 38: s.o.step,
609 | 39: s.o.step,
610 | 40: -s.o.step
611 | };
612 |
613 | this.$
614 | .bind(
615 | "keydown",
616 | function (e) {
617 | var kc = e.keyCode;
618 |
619 | // numpad support
620 | if (kc >= 96 && kc <= 105) {
621 | kc = e.keyCode = kc - 48;
622 | }
623 |
624 | kval = parseInt(String.fromCharCode(kc));
625 |
626 | if (isNaN(kval)) {
627 | (kc !== 13) // enter
628 | && kc !== 8 // bs
629 | && kc !== 9 // tab
630 | && kc !== 189 // -
631 | && (kc !== 190
632 | || s.$.val().match(/\./)) // . allowed once
633 | && e.preventDefault();
634 |
635 | // arrows
636 | if ($.inArray(kc,[37,38,39,40]) > -1) {
637 | e.preventDefault();
638 |
639 | var v = s.o.parse(s.$.val()) + kv[kc] * m;
640 | s.o.stopper && (v = max(min(v, s.o.max), s.o.min));
641 |
642 | s.change(s._validate(v));
643 | s._draw();
644 |
645 | // long time keydown speed-up
646 | to = window.setTimeout(function () {
647 | m *= 2;
648 | }, 30);
649 | }
650 | }
651 | }
652 | )
653 | .bind(
654 | "keyup",
655 | function (e) {
656 | if (isNaN(kval)) {
657 | if (to) {
658 | window.clearTimeout(to);
659 | to = null;
660 | m = 1;
661 | s.val(s.$.val());
662 | }
663 | } else {
664 | // kval postcond
665 | (s.$.val() > s.o.max && s.$.val(s.o.max))
666 | || (s.$.val() < s.o.min && s.$.val(s.o.min));
667 | }
668 | }
669 | );
670 |
671 | this.$c.bind("mousewheel DOMMouseScroll", mw);
672 | this.$.bind("mousewheel DOMMouseScroll", mw);
673 | };
674 |
675 | this.init = function () {
676 | if (this.v < this.o.min
677 | || this.v > this.o.max) { this.v = this.o.min; }
678 |
679 | this.$.val(this.v);
680 | this.w2 = this.w / 2;
681 | this.cursorExt = this.o.cursor / 100;
682 | this.xy = this.w2 * this.scale;
683 | this.lineWidth = this.xy * this.o.thickness;
684 | this.lineCap = this.o.lineCap;
685 | this.radius = this.xy - this.lineWidth / 2;
686 |
687 | this.o.angleOffset
688 | && (this.o.angleOffset = isNaN(this.o.angleOffset) ? 0 : this.o.angleOffset);
689 |
690 | this.o.angleArc
691 | && (this.o.angleArc = isNaN(this.o.angleArc) ? this.PI2 : this.o.angleArc);
692 |
693 | // deg to rad
694 | this.angleOffset = this.o.angleOffset * Math.PI / 180;
695 | this.angleArc = this.o.angleArc * Math.PI / 180;
696 |
697 | // compute start and end angles
698 | this.startAngle = 1.5 * Math.PI + this.angleOffset;
699 | this.endAngle = 1.5 * Math.PI + this.angleOffset + this.angleArc;
700 |
701 | var s = max(
702 | String(Math.abs(this.o.max)).length,
703 | String(Math.abs(this.o.min)).length,
704 | 2
705 | ) + 2;
706 |
707 | this.o.displayInput
708 | && this.i.css({
709 | 'width' : ((this.w / 2 + 4) >> 0) + 'px',
710 | 'height' : ((this.w / 3) >> 0) + 'px',
711 | 'position' : 'absolute',
712 | 'vertical-align' : 'middle',
713 | 'margin-top' : ((this.w / 3) >> 0) + 'px',
714 | 'margin-left' : '-' + ((this.w * 3 / 4 + 2) >> 0) + 'px',
715 | 'border' : 0,
716 | 'background' : 'none',
717 | 'font' : this.o.fontWeight + ' ' + ((this.w / s) >> 0) + 'px ' + this.o.font,
718 | 'text-align' : 'center',
719 | 'color' : this.o.inputColor || this.o.fgColor,
720 | 'padding' : '0px',
721 | '-webkit-appearance': 'none'
722 | }) || this.i.css({
723 | 'width': '0px',
724 | 'visibility': 'hidden'
725 | });
726 | };
727 |
728 | this.change = function (v) {
729 | this.cv = v;
730 | this.$.val(this.o.format(v));
731 | };
732 |
733 | this.angle = function (v) {
734 | return (v - this.o.min) * this.angleArc / (this.o.max - this.o.min);
735 | };
736 |
737 | this.arc = function (v) {
738 | var sa, ea;
739 | v = this.angle(v);
740 | if (this.o.flip) {
741 | sa = this.endAngle + 0.00001;
742 | ea = sa - v - 0.00001;
743 | } else {
744 | sa = this.startAngle - 0.00001;
745 | ea = sa + v + 0.00001;
746 | }
747 | this.o.cursor
748 | && (sa = ea - this.cursorExt)
749 | && (ea = ea + this.cursorExt);
750 |
751 | return {
752 | s: sa,
753 | e: ea,
754 | d: this.o.flip && !this.o.cursor
755 | };
756 | };
757 |
758 | this.draw = function () {
759 | var c = this.g, // context
760 | a = this.arc(this.cv), // Arc
761 | pa, // Previous arc
762 | r = 1;
763 |
764 | c.lineWidth = this.lineWidth;
765 | c.lineCap = this.lineCap;
766 |
767 | if (this.o.bgColor !== "none") {
768 | c.beginPath();
769 | c.strokeStyle = this.o.bgColor;
770 | c.arc(this.xy, this.xy, this.radius, this.endAngle - 0.00001, this.startAngle + 0.00001, true);
771 | c.stroke();
772 | }
773 |
774 | if (this.o.displayPrevious) {
775 | pa = this.arc(this.v);
776 | c.beginPath();
777 | c.strokeStyle = this.pColor;
778 | c.arc(this.xy, this.xy, this.radius, pa.s, pa.e, pa.d);
779 | c.stroke();
780 | r = this.cv == this.v;
781 | }
782 |
783 | c.beginPath();
784 | c.strokeStyle = r ? this.o.fgColor : this.fgColor ;
785 | c.arc(this.xy, this.xy, this.radius, a.s, a.e, a.d);
786 | c.stroke();
787 | };
788 |
789 | this.cancel = function () {
790 | this.val(this.v);
791 | };
792 | };
793 |
794 | $.fn.dial = $.fn.knob = function (o) {
795 | return this.each(
796 | function () {
797 | var d = new k.Dial();
798 | d.o = o;
799 | d.$ = $(this);
800 | d.run();
801 | }
802 | ).parent();
803 | };
804 |
805 | }));
806 |
--------------------------------------------------------------------------------
/excanvas.js:
--------------------------------------------------------------------------------
1 | // Copyright 2006 Google Inc.
2 | //
3 | // Licensed under the Apache License, Version 2.0 (the "License");
4 | // you may not use this file except in compliance with the License.
5 | // You may obtain a copy of the License at
6 | //
7 | // http://www.apache.org/licenses/LICENSE-2.0
8 | //
9 | // Unless required by applicable law or agreed to in writing, software
10 | // distributed under the License is distributed on an "AS IS" BASIS,
11 | // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | // See the License for the specific language governing permissions and
13 | // limitations under the License.
14 |
15 |
16 | // Known Issues:
17 | //
18 | // * Patterns are not implemented.
19 | // * Radial gradient are not implemented. The VML version of these look very
20 | // different from the canvas one.
21 | // * Clipping paths are not implemented.
22 | // * Coordsize. The width and height attribute have higher priority than the
23 | // width and height style values which isn't correct.
24 | // * Painting mode isn't implemented.
25 | // * Canvas width/height should is using content-box by default. IE in
26 | // Quirks mode will draw the canvas using border-box. Either change your
27 | // doctype to HTML5
28 | // (http://www.whatwg.org/specs/web-apps/current-work/#the-doctype)
29 | // or use Box Sizing Behavior from WebFX
30 | // (http://webfx.eae.net/dhtml/boxsizing/boxsizing.html)
31 | // * Non uniform scaling does not correctly scale strokes.
32 | // * Optimize. There is always room for speed improvements.
33 |
34 | // Only add this code if we do not already have a canvas implementation
35 | if (!document.createElement('canvas').getContext) {
36 |
37 | (function() {
38 |
39 | // alias some functions to make (compiled) code shorter
40 | var m = Math;
41 | var mr = m.round;
42 | var ms = m.sin;
43 | var mc = m.cos;
44 | var abs = m.abs;
45 | var sqrt = m.sqrt;
46 |
47 | // this is used for sub pixel precision
48 | var Z = 10;
49 | var Z2 = Z / 2;
50 |
51 | /**
52 | * This funtion is assigned to the