4 * Copyright (c) 2009 AUTHORS.txt (http://ui.jquery.com/about)
5 * Dual licensed under the MIT (MIT-LICENSE.txt)
6 * and GPL (GPL-LICENSE.txt) licenses.
8 * http://docs.jquery.com/UI
12 var _remove
= $.fn
.remove
,
13 isFF2
= $.browser
.mozilla
&& (parseFloat($.browser
.version
) < 1.9);
15 //Helper functions and ui object
19 // $.ui.plugin is deprecated. Use the proxy pattern instead.
21 add: function(module
, option
, set) {
22 var proto
= $.ui
[module
].prototype;
24 proto
.plugins
[i
] = proto
.plugins
[i
] || [];
25 proto
.plugins
[i
].push([option
, set[i
]]);
28 call: function(instance
, name
, args
) {
29 var set = instance
.plugins
[name
];
32 for (var i
= 0; i
< set.length
; i
++) {
33 if (instance
.options
[set[i
][0]]) {
34 set[i
][1].apply(instance
.element
, args
);
40 contains: function(a
, b
) {
41 return document
.compareDocumentPosition
42 ? a
.compareDocumentPosition(b
) & 16
43 : a
!== b
&& a
.contains(b
);
48 if ($.ui
.cssCache
[name
]) { return $.ui
.cssCache
[name
]; }
49 var tmp
= $('<div class="ui-gen"></div>').addClass(name
).css({position
:'absolute', top
:'-5000px', left
:'-5000px', display
:'block'}).appendTo('body');
51 //if (!$.browser.safari)
52 //tmp.appendTo('body');
54 //Opera and Safari set width and height to 0px instead of auto
55 //Safari returns rgba(0,0,0,0) when bgcolor is not set
56 $.ui
.cssCache
[name
] = !!(
57 (!(/auto|default/).test(tmp
.css('cursor')) || (/^[1-9]/).test(tmp
.css('height')) || (/^[1-9]/).test(tmp
.css('width')) ||
58 !(/none/).test(tmp
.css('backgroundImage')) || !(/transparent|rgba\(0, 0, 0, 0\)/).test(tmp
.css('backgroundColor')))
60 try { $('body').get(0).removeChild(tmp
.get(0)); } catch(e
){}
61 return $.ui
.cssCache
[name
];
64 hasScroll: function(el
, a
) {
66 //If overflow is hidden, the element might have extra content, but the user wants to hide it
67 if ($(el
).css('overflow') == 'hidden') { return false; }
69 var scroll
= (a
&& a
== 'left') ? 'scrollLeft' : 'scrollTop',
72 if (el
[scroll
] > 0) { return true; }
74 // TODO: determine which cases actually cause this to happen
75 // if the element doesn't have the scroll set, see if it's possible to
78 has
= (el
[scroll
] > 0);
83 isOverAxis: function(x
, reference
, size
) {
84 //Determines when x coordinate is over "b" element axis
85 return (x
> reference
) && (x
< (reference
+ size
));
88 isOver: function(y
, x
, top
, left
, height
, width
) {
89 //Determines when x, y coordinates is over "b" element
90 return $.ui
.isOverAxis(y
, top
, height
) && $.ui
.isOverAxis(x
, left
, width
);
110 NUMPAD_MULTIPLY
: 106,
111 NUMPAD_SUBTRACT
: 109,
123 // WAI-ARIA normalization
126 removeAttr
= $.fn
.removeAttr
,
127 ariaNS
= "http://www.w3.org/2005/07/aaa",
128 ariaState
= /^aria-/,
129 ariaRole
= /^wairole:/;
131 $.attr = function(elem
, name
, value
) {
132 var set = value
!== undefined;
134 return (name
== 'role'
136 ? attr
.call(this, elem
, name
, "wairole:" + value
)
137 : (attr
.apply(this, arguments
) || "").replace(ariaRole
, ""))
138 : (ariaState
.test(name
)
140 ? elem
.setAttributeNS(ariaNS
,
141 name
.replace(ariaState
, "aaa:"), value
)
142 : attr
.call(this, elem
, name
.replace(ariaState
, "aaa:")))
143 : attr
.apply(this, arguments
)));
146 $.fn
.removeAttr = function(name
) {
147 return (ariaState
.test(name
)
148 ? this.each(function() {
149 this.removeAttributeNS(ariaNS
, name
.replace(ariaState
, ""));
150 }) : removeAttr
.call(this, name
));
157 // Safari has a native remove event which actually removes DOM elements,
158 // so we have to use triggerHandler instead of trigger (#3037).
159 $("*", this).add(this).each(function() {
160 $(this).triggerHandler("remove");
162 return _remove
.apply(this, arguments
);
165 enableSelection: function() {
167 .attr('unselectable', 'off')
168 .css('MozUserSelect', '')
169 .unbind('selectstart.ui');
172 disableSelection: function() {
174 .attr('unselectable', 'on')
175 .css('MozUserSelect', 'none')
176 .bind('selectstart.ui', function() { return false; });
179 scrollParent: function() {
181 if(($.browser
.msie
&& (/(static|relative)/).test(this.css('position'))) || (/absolute/).test(this.css('position'))) {
182 scrollParent
= this.parents().filter(function() {
183 return (/(relative|absolute|fixed)/).test($.curCSS(this,'position',1)) && (/(auto|scroll)/).test($.curCSS(this,'overflow',1)+$.curCSS(this,'overflow-y',1)+$.curCSS(this,'overflow-x',1));
186 scrollParent
= this.parents().filter(function() {
187 return (/(auto|scroll)/).test($.curCSS(this,'overflow',1)+$.curCSS(this,'overflow-y',1)+$.curCSS(this,'overflow-x',1));
191 return (/fixed/).test(this.css('position')) || !scrollParent
.length
? $(document
) : scrollParent
;
196 //Additional selectors
197 $.extend($.expr
[':'], {
198 data: function(elem
, i
, match
) {
199 return !!$.data(elem
, match
[3]);
202 // TODO: add support for object, area
203 tabbable: function(elem
) {
204 var nodeName
= elem
.nodeName
.toLowerCase();
205 function isVisible(element
) {
206 return !($(element
).is(':hidden') || $(element
).parents(':hidden').length
);
211 elem
.tabIndex
>= 0 &&
213 ( // filter node types that participate in the tab order
216 ('a' == nodeName
&& elem
.href
) ||
218 // enabled form element
219 (/input|select|textarea|button/.test(nodeName
) &&
220 'hidden' != elem
.type
&& !elem
.disabled
)
230 // $.widget is a factory to create jQuery plugins
231 // taking some boilerplate code out of the plugin code
232 function getter(namespace, plugin
, method
, args
) {
233 function getMethods(type
) {
234 var methods
= $[namespace][plugin
][type
] || [];
235 return (typeof methods
== 'string' ? methods
.split(/,?\s+/) : methods
);
238 var methods
= getMethods('getter');
239 if (args
.length
== 1 && typeof args
[0] == 'string') {
240 methods
= methods
.concat(getMethods('getterSetter'));
242 return ($.inArray(method
, methods
) != -1);
245 $.widget = function(name
, prototype) {
246 var namespace = name
.split(".")[0];
247 name
= name
.split(".")[1];
249 // create plugin method
250 $.fn
[name
] = function(options
) {
251 var isMethodCall
= (typeof options
== 'string'),
252 args
= Array
.prototype.slice
.call(arguments
, 1);
254 // prevent calls to internal methods
255 if (isMethodCall
&& options
.substring(0, 1) == '_') {
259 // handle getter methods
260 if (isMethodCall
&& getter(namespace, name
, options
, args
)) {
261 var instance
= $.data(this[0], name
);
262 return (instance
? instance
[options
].apply(instance
, args
)
266 // handle initialization and non-getter methods
267 return this.each(function() {
268 var instance
= $.data(this, name
);
271 (!instance
&& !isMethodCall
&&
272 $.data(this, name
, new $[namespace][name
](this, options
)));
275 (instance
&& isMethodCall
&& $.isFunction(instance
[options
]) &&
276 instance
[options
].apply(instance
, args
));
280 // create widget constructor
281 $[namespace] = $[namespace] || {};
282 $[namespace][name
] = function(element
, options
) {
285 this.namespace = namespace;
286 this.widgetName
= name
;
287 this.widgetEventPrefix
= $[namespace][name
].eventPrefix
|| name
;
288 this.widgetBaseClass
= namespace + '-' + name
;
290 this.options
= $.extend({},
292 $[namespace][name
].defaults
,
293 $.metadata
&& $.metadata
.get(element
)[name
],
296 this.element
= $(element
)
297 .bind('setData.' + name
, function(event
, key
, value
) {
298 if (event
.target
== element
) {
299 return self
._setData(key
, value
);
302 .bind('getData.' + name
, function(event
, key
) {
303 if (event
.target
== element
) {
304 return self
._getData(key
);
307 .bind('remove', function() {
308 return self
.destroy();
314 // add widget prototype
315 $[namespace][name
].prototype = $.extend({}, $.widget
.prototype, prototype);
317 // TODO: merge getter and getterSetter properties from widget prototype
318 // and plugin prototype
319 $[namespace][name
].getterSetter
= 'option';
322 $.widget
.prototype = {
323 _init: function() {},
324 destroy: function() {
325 this.element
.removeData(this.widgetName
)
326 .removeClass(this.widgetBaseClass
+ '-disabled' + ' ' + this.namespace + '-state-disabled')
327 .removeAttr('aria-disabled');
330 option: function(key
, value
) {
334 if (typeof key
== "string") {
335 if (value
=== undefined) {
336 return this._getData(key
);
339 options
[key
] = value
;
342 $.each(options
, function(key
, value
) {
343 self
._setData(key
, value
);
346 _getData: function(key
) {
347 return this.options
[key
];
349 _setData: function(key
, value
) {
350 this.options
[key
] = value
;
352 if (key
== 'disabled') {
354 [value
? 'addClass' : 'removeClass'](
355 this.widgetBaseClass
+ '-disabled' + ' ' +
356 this.namespace + '-state-disabled')
357 .attr("aria-disabled", value
);
362 this._setData('disabled', false);
364 disable: function() {
365 this._setData('disabled', true);
368 _trigger: function(type
, event
, data
) {
369 var callback
= this.options
[type
],
370 eventName
= (type
== this.widgetEventPrefix
371 ? type
: this.widgetEventPrefix
+ type
);
373 event
= event
? $.event
.fix(event
) : $.Event();
374 event
.type
= eventName
;
376 this.element
.trigger(event
, data
);
378 return !(callback
&& callback
.call(this.element
[0], event
, data
) === false
379 || event
.isDefaultPrevented());
383 $.widget
.defaults
= {
388 /** Mouse Interaction Plugin **/
391 _mouseInit: function() {
395 .bind('mousedown.'+this.widgetName
, function(event
) {
396 return self
._mouseDown(event
);
398 .bind('click.'+this.widgetName
, function(event
) {
399 if(self
._preventClickEvent
) {
400 self
._preventClickEvent
= false;
405 // Prevent text selection in IE
406 if ($.browser
.msie
) {
407 this._mouseUnselectable
= this.element
.attr('unselectable');
408 this.element
.attr('unselectable', 'on');
411 this.started
= false;
414 // TODO: make sure destroying one instance of mouse doesn't mess with
415 // other instances of mouse
416 _mouseDestroy: function() {
417 this.element
.unbind('.'+this.widgetName
);
419 // Restore text selection in IE
421 && this.element
.attr('unselectable', this._mouseUnselectable
));
424 _mouseDown: function(event
) {
425 // we may have missed mouseup (out of window)
426 (this._mouseStarted
&& this._mouseUp(event
));
428 this._mouseDownEvent
= event
;
431 btnIsLeft
= (event
.which
== 1),
432 elIsCancel
= (typeof this.options
.cancel
== "string" ? $(event
.target
).parents().add(event
.target
).filter(this.options
.cancel
).length
: false);
433 if (!btnIsLeft
|| elIsCancel
|| !this._mouseCapture(event
)) {
437 this.mouseDelayMet
= !this.options
.delay
;
438 if (!this.mouseDelayMet
) {
439 this._mouseDelayTimer
= setTimeout(function() {
440 self
.mouseDelayMet
= true;
441 }, this.options
.delay
);
444 if (this._mouseDistanceMet(event
) && this._mouseDelayMet(event
)) {
445 this._mouseStarted
= (this._mouseStart(event
) !== false);
446 if (!this._mouseStarted
) {
447 event
.preventDefault();
452 // these delegates are required to keep context
453 this._mouseMoveDelegate = function(event
) {
454 return self
._mouseMove(event
);
456 this._mouseUpDelegate = function(event
) {
457 return self
._mouseUp(event
);
460 .bind('mousemove.'+this.widgetName
, this._mouseMoveDelegate
)
461 .bind('mouseup.'+this.widgetName
, this._mouseUpDelegate
);
463 // preventDefault() is used to prevent the selection of text here -
464 // however, in Safari, this causes select boxes not to be selectable
465 // anymore, so this fix is needed
466 ($.browser
.safari
|| event
.preventDefault());
471 _mouseMove: function(event
) {
472 // IE mouseup check - mouseup happened when mouse was out of window
473 if ($.browser
.msie
&& !event
.button
) {
474 return this._mouseUp(event
);
477 if (this._mouseStarted
) {
478 this._mouseDrag(event
);
479 return event
.preventDefault();
482 if (this._mouseDistanceMet(event
) && this._mouseDelayMet(event
)) {
484 (this._mouseStart(this._mouseDownEvent
, event
) !== false);
485 (this._mouseStarted
? this._mouseDrag(event
) : this._mouseUp(event
));
488 return !this._mouseStarted
;
491 _mouseUp: function(event
) {
493 .unbind('mousemove.'+this.widgetName
, this._mouseMoveDelegate
)
494 .unbind('mouseup.'+this.widgetName
, this._mouseUpDelegate
);
496 if (this._mouseStarted
) {
497 this._mouseStarted
= false;
498 this._preventClickEvent
= true;
499 this._mouseStop(event
);
505 _mouseDistanceMet: function(event
) {
507 Math
.abs(this._mouseDownEvent
.pageX
- event
.pageX
),
508 Math
.abs(this._mouseDownEvent
.pageY
- event
.pageY
)
509 ) >= this.options
.distance
513 _mouseDelayMet: function(event
) {
514 return this.mouseDelayMet
;
517 // These are placeholder methods, to be overriden by extending plugin
518 _mouseStart: function(event
) {},
519 _mouseDrag: function(event
) {},
520 _mouseStop: function(event
) {},
521 _mouseCapture: function(event
) { return true; }
524 $.ui
.mouse
.defaults
= {