2 * jQuery UI Widget 1.9.1+amd
3 * https://github.com/blueimp/jQuery-File-Upload
5 * Copyright 2012 jQuery Foundation and other contributors
6 * Released under the MIT license.
7 * http://jquery.org/license
9 * http://api.jqueryui.com/jQuery.widget/
13 if (typeof define === "function" && define.amd) {
14 // Register as an anonymous AMD module:
15 define(["jquery"], factory);
20 }(function( $, undefined ) {
23 slice = Array.prototype.slice,
24 _cleanData = $.cleanData;
25 $.cleanData = function( elems ) {
26 for ( var i = 0, elem; (elem = elems[i]) != null; i++ ) {
28 $( elem ).triggerHandler( "remove" );
29 // http://bugs.jquery.com/ticket/8235
35 $.widget = function( name, base, prototype ) {
36 var fullName, existingConstructor, constructor, basePrototype,
37 namespace = name.split( "." )[ 0 ];
39 name = name.split( "." )[ 1 ];
40 fullName = namespace + "-" + name;
47 // create selector for plugin
48 $.expr[ ":" ][ fullName.toLowerCase() ] = function( elem ) {
49 return !!$.data( elem, fullName );
52 $[ namespace ] = $[ namespace ] || {};
53 existingConstructor = $[ namespace ][ name ];
54 constructor = $[ namespace ][ name ] = function( options, element ) {
55 // allow instantiation without "new" keyword
56 if ( !this._createWidget ) {
57 return new constructor( options, element );
60 // allow instantiation without initializing for simple inheritance
61 // must use "new" keyword (the code above always passes args)
62 if ( arguments.length ) {
63 this._createWidget( options, element );
66 // extend with the existing constructor to carry over any static properties
67 $.extend( constructor, existingConstructor, {
68 version: prototype.version,
69 // copy the object used to create the prototype in case we need to
70 // redefine the widget later
71 _proto: $.extend( {}, prototype ),
72 // track widgets that inherit from this widget in case this widget is
73 // redefined after a widget inherits from it
74 _childConstructors: []
77 basePrototype = new base();
78 // we need to make the options hash a property directly on the new instance
79 // otherwise we'll modify the options hash on the prototype that we're
81 basePrototype.options = $.widget.extend( {}, basePrototype.options );
82 $.each( prototype, function( prop, value ) {
83 if ( $.isFunction( value ) ) {
84 prototype[ prop ] = (function() {
85 var _super = function() {
86 return base.prototype[ prop ].apply( this, arguments );
88 _superApply = function( args ) {
89 return base.prototype[ prop ].apply( this, args );
92 var __super = this._super,
93 __superApply = this._superApply,
97 this._superApply = _superApply;
99 returnValue = value.apply( this, arguments );
101 this._super = __super;
102 this._superApply = __superApply;
109 constructor.prototype = $.widget.extend( basePrototype, {
110 // TODO: remove support for widgetEventPrefix
111 // always use the name + a colon as the prefix, e.g., draggable:start
112 // don't prefix for widgets that aren't DOM-based
113 widgetEventPrefix: basePrototype.widgetEventPrefix || name
115 constructor: constructor,
116 namespace: namespace,
118 // TODO remove widgetBaseClass, see #8155
119 widgetBaseClass: fullName,
120 widgetFullName: fullName
123 // If this widget is being redefined then we need to find all widgets that
124 // are inheriting from it and redefine all of them so that they inherit from
125 // the new version of this widget. We're essentially trying to replace one
126 // level in the prototype chain.
127 if ( existingConstructor ) {
128 $.each( existingConstructor._childConstructors, function( i, child ) {
129 var childPrototype = child.prototype;
131 // redefine the child widget using the same prototype that was
132 // originally used, but inherit from the new version of the base
133 $.widget( childPrototype.namespace + "." + childPrototype.widgetName, constructor, child._proto );
135 // remove the list of existing child constructors from the old constructor
136 // so the old child constructors can be garbage collected
137 delete existingConstructor._childConstructors;
139 base._childConstructors.push( constructor );
142 $.widget.bridge( name, constructor );
145 $.widget.extend = function( target ) {
146 var input = slice.call( arguments, 1 ),
148 inputLength = input.length,
151 for ( ; inputIndex < inputLength; inputIndex++ ) {
152 for ( key in input[ inputIndex ] ) {
153 value = input[ inputIndex ][ key ];
154 if ( input[ inputIndex ].hasOwnProperty( key ) && value !== undefined ) {
156 if ( $.isPlainObject( value ) ) {
157 target[ key ] = $.isPlainObject( target[ key ] ) ?
158 $.widget.extend( {}, target[ key ], value ) :
159 // Don't extend strings, arrays, etc. with objects
160 $.widget.extend( {}, value );
161 // Copy everything else by reference
163 target[ key ] = value;
171 $.widget.bridge = function( name, object ) {
172 var fullName = object.prototype.widgetFullName;
173 $.fn[ name ] = function( options ) {
174 var isMethodCall = typeof options === "string",
175 args = slice.call( arguments, 1 ),
178 // allow multiple hashes to be passed on init
179 options = !isMethodCall && args.length ?
180 $.widget.extend.apply( null, [ options ].concat(args) ) :
183 if ( isMethodCall ) {
184 this.each(function() {
186 instance = $.data( this, fullName );
188 return $.error( "cannot call methods on " + name + " prior to initialization; " +
189 "attempted to call method '" + options + "'" );
191 if ( !$.isFunction( instance[options] ) || options.charAt( 0 ) === "_" ) {
192 return $.error( "no such method '" + options + "' for " + name + " widget instance" );
194 methodValue = instance[ options ].apply( instance, args );
195 if ( methodValue !== instance && methodValue !== undefined ) {
196 returnValue = methodValue && methodValue.jquery ?
197 returnValue.pushStack( methodValue.get() ) :
203 this.each(function() {
204 var instance = $.data( this, fullName );
206 instance.option( options || {} )._init();
208 new object( options, this );
217 $.Widget = function( /* options, element */ ) {};
218 $.Widget._childConstructors = [];
220 $.Widget.prototype = {
221 widgetName: "widget",
222 widgetEventPrefix: "",
223 defaultElement: "<div>",
230 _createWidget: function( options, element ) {
232 element = $( element || this.defaultElement || this )[ 0 ];
233 this.element = $( element );
235 this.eventNamespace = "." + this.widgetName + this.uuid;
236 this.options = $.widget.extend( {},
238 this._getCreateOptions(),
242 this.hoverable = $();
243 this.focusable = $();
245 if ( element !== this ) {
247 // TODO remove dual storage
248 $.data( element, this.widgetName, this );
249 $.data( element, this.widgetFullName, this );
250 this._on( this.element, {
251 remove: function( event ) {
252 if ( event.target === element ) {
257 this.document = $( element.style ?
258 // element within the document
259 element.ownerDocument :
260 // element is window or document
261 element.document || element );
262 this.window = $( this.document[0].defaultView || this.document[0].parentWindow );
266 this._trigger( "create", null, this._getCreateEventData() );
270 _getCreateOptions: $.noop,
271 _getCreateEventData: $.noop,
275 destroy: function() {
277 // we can probably remove the unbind calls in 2.0
278 // all event bindings should go through this._on()
280 .unbind( this.eventNamespace )
282 // TODO remove dual storage
283 .removeData( this.widgetName )
284 .removeData( this.widgetFullName )
285 // support: jquery <1.6.3
286 // http://bugs.jquery.com/ticket/9413
287 .removeData( $.camelCase( this.widgetFullName ) );
289 .unbind( this.eventNamespace )
290 .removeAttr( "aria-disabled" )
292 this.widgetFullName + "-disabled " +
293 "ui-state-disabled" );
295 // clean up events and states
296 this.bindings.unbind( this.eventNamespace );
297 this.hoverable.removeClass( "ui-state-hover" );
298 this.focusable.removeClass( "ui-state-focus" );
306 option: function( key, value ) {
312 if ( arguments.length === 0 ) {
313 // don't return a reference to the internal hash
314 return $.widget.extend( {}, this.options );
317 if ( typeof key === "string" ) {
318 // handle nested keys, e.g., "foo.bar" => { foo: { bar: ___ } }
320 parts = key.split( "." );
322 if ( parts.length ) {
323 curOption = options[ key ] = $.widget.extend( {}, this.options[ key ] );
324 for ( i = 0; i < parts.length - 1; i++ ) {
325 curOption[ parts[ i ] ] = curOption[ parts[ i ] ] || {};
326 curOption = curOption[ parts[ i ] ];
329 if ( value === undefined ) {
330 return curOption[ key ] === undefined ? null : curOption[ key ];
332 curOption[ key ] = value;
334 if ( value === undefined ) {
335 return this.options[ key ] === undefined ? null : this.options[ key ];
337 options[ key ] = value;
341 this._setOptions( options );
345 _setOptions: function( options ) {
348 for ( key in options ) {
349 this._setOption( key, options[ key ] );
354 _setOption: function( key, value ) {
355 this.options[ key ] = value;
357 if ( key === "disabled" ) {
359 .toggleClass( this.widgetFullName + "-disabled ui-state-disabled", !!value )
360 .attr( "aria-disabled", value );
361 this.hoverable.removeClass( "ui-state-hover" );
362 this.focusable.removeClass( "ui-state-focus" );
369 return this._setOption( "disabled", false );
371 disable: function() {
372 return this._setOption( "disabled", true );
375 _on: function( element, handlers ) {
378 // no element argument, shuffle and use this.element
381 element = this.element;
382 delegateElement = this.widget();
384 // accept selectors, DOM elements
385 element = delegateElement = $( element );
386 this.bindings = this.bindings.add( element );
389 $.each( handlers, function( event, handler ) {
390 function handlerProxy() {
391 // allow widgets to customize the disabled handling
392 // - disabled as an array instead of boolean
393 // - disabled class as method for disabling individual parts
394 if ( instance.options.disabled === true ||
395 $( this ).hasClass( "ui-state-disabled" ) ) {
398 return ( typeof handler === "string" ? instance[ handler ] : handler )
399 .apply( instance, arguments );
402 // copy the guid so direct unbinding works
403 if ( typeof handler !== "string" ) {
404 handlerProxy.guid = handler.guid =
405 handler.guid || handlerProxy.guid || $.guid++;
408 var match = event.match( /^(\w+)\s*(.*)$/ ),
409 eventName = match[1] + instance.eventNamespace,
412 delegateElement.delegate( selector, eventName, handlerProxy );
414 element.bind( eventName, handlerProxy );
419 _off: function( element, eventName ) {
420 eventName = (eventName || "").split( " " ).join( this.eventNamespace + " " ) + this.eventNamespace;
421 element.unbind( eventName ).undelegate( eventName );
424 _delay: function( handler, delay ) {
425 function handlerProxy() {
426 return ( typeof handler === "string" ? instance[ handler ] : handler )
427 .apply( instance, arguments );
430 return setTimeout( handlerProxy, delay || 0 );
433 _hoverable: function( element ) {
434 this.hoverable = this.hoverable.add( element );
436 mouseenter: function( event ) {
437 $( event.currentTarget ).addClass( "ui-state-hover" );
439 mouseleave: function( event ) {
440 $( event.currentTarget ).removeClass( "ui-state-hover" );
445 _focusable: function( element ) {
446 this.focusable = this.focusable.add( element );
448 focusin: function( event ) {
449 $( event.currentTarget ).addClass( "ui-state-focus" );
451 focusout: function( event ) {
452 $( event.currentTarget ).removeClass( "ui-state-focus" );
457 _trigger: function( type, event, data ) {
459 callback = this.options[ type ];
462 event = $.Event( event );
463 event.type = ( type === this.widgetEventPrefix ?
465 this.widgetEventPrefix + type ).toLowerCase();
466 // the original event may come from any element
467 // so we need to reset the target on the new event
468 event.target = this.element[ 0 ];
470 // copy original event properties over to the new event
471 orig = event.originalEvent;
473 for ( prop in orig ) {
474 if ( !( prop in event ) ) {
475 event[ prop ] = orig[ prop ];
480 this.element.trigger( event, data );
481 return !( $.isFunction( callback ) &&
482 callback.apply( this.element[0], [ event ].concat( data ) ) === false ||
483 event.isDefaultPrevented() );
487 $.each( { show: "fadeIn", hide: "fadeOut" }, function( method, defaultEffect ) {
488 $.Widget.prototype[ "_" + method ] = function( element, options, callback ) {
489 if ( typeof options === "string" ) {
490 options = { effect: options };
493 effectName = !options ?
495 options === true || typeof options === "number" ?
497 options.effect || defaultEffect;
498 options = options || {};
499 if ( typeof options === "number" ) {
500 options = { duration: options };
502 hasOptions = !$.isEmptyObject( options );
503 options.complete = callback;
504 if ( options.delay ) {
505 element.delay( options.delay );
507 if ( hasOptions && $.effects && ( $.effects.effect[ effectName ] || $.uiBackCompat !== false && $.effects[ effectName ] ) ) {
508 element[ method ]( options );
509 } else if ( effectName !== method && element[ effectName ] ) {
510 element[ effectName ]( options.duration, options.easing, callback );
512 element.queue(function( next ) {
513 $( this )[ method ]();
515 callback.call( element[ 0 ] );
524 if ( $.uiBackCompat !== false ) {
525 $.Widget.prototype._getCreateOptions = function() {
526 return $.metadata && $.metadata.get( this.element[0] )[ this.widgetName ];