xinyb
2024-04-23 2ef61846432762b570d5f2004a4551225da01324
提交 | 用户 | age
a6a76f 1 /*!
F 2  * jQuery Migrate - v1.2.1 - 2013-05-08
3  * https://github.com/jquery/jquery-migrate
4  * Copyright 2005, 2013 jQuery Foundation, Inc. and other contributors; Licensed MIT
5  */
6 (function( jQuery, window, undefined ) {
7 // See http://bugs.jquery.com/ticket/13335
8 // "use strict";
9
10
11 var warnedAbout = {};
12
13 // List of warnings already given; public read only
14 jQuery.migrateWarnings = [];
15
16 // Set to true to prevent console output; migrateWarnings still maintained
17 // jQuery.migrateMute = false;
18
19 // Show a message on the console so devs know we're active
20 if ( !jQuery.migrateMute && window.console && window.console.log ) {
21     window.console.log("JQMIGRATE: Logging is active");
22 }
23
24 // Set to false to disable traces that appear with warnings
25 if ( jQuery.migrateTrace === undefined ) {
26     jQuery.migrateTrace = true;
27 }
28
29 // Forget any warnings we've already given; public
30 jQuery.migrateReset = function() {
31     warnedAbout = {};
32     jQuery.migrateWarnings.length = 0;
33 };
34
35 function migrateWarn( msg) {
36     var console = window.console;
37     if ( !warnedAbout[ msg ] ) {
38         warnedAbout[ msg ] = true;
39         jQuery.migrateWarnings.push( msg );
40         if ( console && console.warn && !jQuery.migrateMute ) {
41             console.warn( "JQMIGRATE: " + msg );
42             if ( jQuery.migrateTrace && console.trace ) {
43                 console.trace();
44             }
45         }
46     }
47 }
48
49 function migrateWarnProp( obj, prop, value, msg ) {
50     if ( Object.defineProperty ) {
51         // On ES5 browsers (non-oldIE), warn if the code tries to get prop;
52         // allow property to be overwritten in case some other plugin wants it
53         try {
54             Object.defineProperty( obj, prop, {
55                 configurable: true,
56                 enumerable: true,
57                 get: function() {
58                     migrateWarn( msg );
59                     return value;
60                 },
61                 set: function( newValue ) {
62                     migrateWarn( msg );
63                     value = newValue;
64                 }
65             });
66             return;
67         } catch( err ) {
68             // IE8 is a dope about Object.defineProperty, can't warn there
69         }
70     }
71
72     // Non-ES5 (or broken) browser; just set the property
73     jQuery._definePropertyBroken = true;
74     obj[ prop ] = value;
75 }
76
77 if ( document.compatMode === "BackCompat" ) {
78     // jQuery has never supported or tested Quirks Mode
79     migrateWarn( "jQuery is not compatible with Quirks Mode" );
80 }
81
82
83 var attrFn = jQuery( "<input/>", { size: 1 } ).attr("size") && jQuery.attrFn,
84     oldAttr = jQuery.attr,
85     valueAttrGet = jQuery.attrHooks.value && jQuery.attrHooks.value.get ||
86         function() { return null; },
87     valueAttrSet = jQuery.attrHooks.value && jQuery.attrHooks.value.set ||
88         function() { return undefined; },
89     rnoType = /^(?:input|button)$/i,
90     rnoAttrNodeType = /^[238]$/,
91     rboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i,
92     ruseDefault = /^(?:checked|selected)$/i;
93
94 // jQuery.attrFn
95 migrateWarnProp( jQuery, "attrFn", attrFn || {}, "jQuery.attrFn is deprecated" );
96
97 jQuery.attr = function( elem, name, value, pass ) {
98     var lowerName = name.toLowerCase(),
99         nType = elem && elem.nodeType;
100
101     if ( pass ) {
102         // Since pass is used internally, we only warn for new jQuery
103         // versions where there isn't a pass arg in the formal params
104         if ( oldAttr.length < 4 ) {
105             migrateWarn("jQuery.fn.attr( props, pass ) is deprecated");
106         }
107         if ( elem && !rnoAttrNodeType.test( nType ) &&
108             (attrFn ? name in attrFn : jQuery.isFunction(jQuery.fn[name])) ) {
109             return jQuery( elem )[ name ]( value );
110         }
111     }
112
113     // Warn if user tries to set `type`, since it breaks on IE 6/7/8; by checking
114     // for disconnected elements we don't warn on $( "<button>", { type: "button" } ).
115     if ( name === "type" && value !== undefined && rnoType.test( elem.nodeName ) && elem.parentNode ) {
116         migrateWarn("Can't change the 'type' of an input or button in IE 6/7/8");
117     }
118
119     // Restore boolHook for boolean property/attribute synchronization
120     if ( !jQuery.attrHooks[ lowerName ] && rboolean.test( lowerName ) ) {
121         jQuery.attrHooks[ lowerName ] = {
122             get: function( elem, name ) {
123                 // Align boolean attributes with corresponding properties
124                 // Fall back to attribute presence where some booleans are not supported
125                 var attrNode,
126                     property = jQuery.prop( elem, name );
127                 return property === true || typeof property !== "boolean" &&
128                     ( attrNode = elem.getAttributeNode(name) ) && attrNode.nodeValue !== false ?
129
130                     name.toLowerCase() :
131                     undefined;
132             },
133             set: function( elem, value, name ) {
134                 var propName;
135                 if ( value === false ) {
136                     // Remove boolean attributes when set to false
137                     jQuery.removeAttr( elem, name );
138                 } else {
139                     // value is true since we know at this point it's type boolean and not false
140                     // Set boolean attributes to the same name and set the DOM property
141                     propName = jQuery.propFix[ name ] || name;
142                     if ( propName in elem ) {
143                         // Only set the IDL specifically if it already exists on the element
144                         elem[ propName ] = true;
145                     }
146
147                     elem.setAttribute( name, name.toLowerCase() );
148                 }
149                 return name;
150             }
151         };
152
153         // Warn only for attributes that can remain distinct from their properties post-1.9
154         if ( ruseDefault.test( lowerName ) ) {
155             migrateWarn( "jQuery.fn.attr('" + lowerName + "') may use property instead of attribute" );
156         }
157     }
158
159     return oldAttr.call( jQuery, elem, name, value );
160 };
161
162 // attrHooks: value
163 jQuery.attrHooks.value = {
164     get: function( elem, name ) {
165         var nodeName = ( elem.nodeName || "" ).toLowerCase();
166         if ( nodeName === "button" ) {
167             return valueAttrGet.apply( this, arguments );
168         }
169         if ( nodeName !== "input" && nodeName !== "option" ) {
170             migrateWarn("jQuery.fn.attr('value') no longer gets properties");
171         }
172         return name in elem ?
173             elem.value :
174             null;
175     },
176     set: function( elem, value ) {
177         var nodeName = ( elem.nodeName || "" ).toLowerCase();
178         if ( nodeName === "button" ) {
179             return valueAttrSet.apply( this, arguments );
180         }
181         if ( nodeName !== "input" && nodeName !== "option" ) {
182             migrateWarn("jQuery.fn.attr('value', val) no longer sets properties");
183         }
184         // Does not return so that setAttribute is also used
185         elem.value = value;
186     }
187 };
188
189
190 var matched, browser,
191     oldInit = jQuery.fn.init,
192     oldParseJSON = jQuery.parseJSON,
193     // Note: XSS check is done below after string is trimmed
194     rquickExpr = /^([^<]*)(<[\w\W]+>)([^>]*)$/;
195
196 // $(html) "looks like html" rule change
197 jQuery.fn.init = function( selector, context, rootjQuery ) {
198     var match;
199
200     if ( selector && typeof selector === "string" && !jQuery.isPlainObject( context ) &&
201             (match = rquickExpr.exec( jQuery.trim( selector ) )) && match[ 0 ] ) {
202         // This is an HTML string according to the "old" rules; is it still?
203         if ( selector.charAt( 0 ) !== "<" ) {
204             migrateWarn("$(html) HTML strings must start with '<' character");
205         }
206         if ( match[ 3 ] ) {
207             migrateWarn("$(html) HTML text after last tag is ignored");
208         }
209         // Consistently reject any HTML-like string starting with a hash (#9521)
210         // Note that this may break jQuery 1.6.x code that otherwise would work.
211         if ( match[ 0 ].charAt( 0 ) === "#" ) {
212             migrateWarn("HTML string cannot start with a '#' character");
213             jQuery.error("JQMIGRATE: Invalid selector string (XSS)");
214         }
215         // Now process using loose rules; let pre-1.8 play too
216         if ( context && context.context ) {
217             // jQuery object as context; parseHTML expects a DOM object
218             context = context.context;
219         }
220         if ( jQuery.parseHTML ) {
221             return oldInit.call( this, jQuery.parseHTML( match[ 2 ], context, true ),
222                     context, rootjQuery );
223         }
224     }
225     return oldInit.apply( this, arguments );
226 };
227 jQuery.fn.init.prototype = jQuery.fn;
228
229 // Let $.parseJSON(falsy_value) return null
230 jQuery.parseJSON = function( json ) {
231     if ( !json && json !== null ) {
232         migrateWarn("jQuery.parseJSON requires a valid JSON string");
233         return null;
234     }
235     return oldParseJSON.apply( this, arguments );
236 };
237
238 jQuery.uaMatch = function( ua ) {
239     ua = ua.toLowerCase();
240
241     var match = /(chrome)[ \/]([\w.]+)/.exec( ua ) ||
242         /(webkit)[ \/]([\w.]+)/.exec( ua ) ||
243         /(opera)(?:.*version|)[ \/]([\w.]+)/.exec( ua ) ||
244         /(msie) ([\w.]+)/.exec( ua ) ||
245         ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec( ua ) ||
246         [];
247
248     return {
249         browser: match[ 1 ] || "",
250         version: match[ 2 ] || "0"
251     };
252 };
253
254 // Don't clobber any existing jQuery.browser in case it's different
255 if ( !jQuery.browser ) {
256     matched = jQuery.uaMatch( navigator.userAgent );
257     browser = {};
258
259     if ( matched.browser ) {
260         browser[ matched.browser ] = true;
261         browser.version = matched.version;
262     }
263
264     // Chrome is Webkit, but Webkit is also Safari.
265     if ( browser.chrome ) {
266         browser.webkit = true;
267     } else if ( browser.webkit ) {
268         browser.safari = true;
269     }
270
271     jQuery.browser = browser;
272 }
273
274 // Warn if the code tries to get jQuery.browser
275 migrateWarnProp( jQuery, "browser", jQuery.browser, "jQuery.browser is deprecated" );
276
277 jQuery.sub = function() {
278     function jQuerySub( selector, context ) {
279         return new jQuerySub.fn.init( selector, context );
280     }
281     jQuery.extend( true, jQuerySub, this );
282     jQuerySub.superclass = this;
283     jQuerySub.fn = jQuerySub.prototype = this();
284     jQuerySub.fn.constructor = jQuerySub;
285     jQuerySub.sub = this.sub;
286     jQuerySub.fn.init = function init( selector, context ) {
287         if ( context && context instanceof jQuery && !(context instanceof jQuerySub) ) {
288             context = jQuerySub( context );
289         }
290
291         return jQuery.fn.init.call( this, selector, context, rootjQuerySub );
292     };
293     jQuerySub.fn.init.prototype = jQuerySub.fn;
294     var rootjQuerySub = jQuerySub(document);
295     migrateWarn( "jQuery.sub() is deprecated" );
296     return jQuerySub;
297 };
298
299
300 // Ensure that $.ajax gets the new parseJSON defined in core.js
301 jQuery.ajaxSetup({
302     converters: {
303         "text json": jQuery.parseJSON
304     }
305 });
306
307
308 var oldFnData = jQuery.fn.data;
309
310 jQuery.fn.data = function( name ) {
311     var ret, evt,
312         elem = this[0];
313
314     // Handles 1.7 which has this behavior and 1.8 which doesn't
315     if ( elem && name === "events" && arguments.length === 1 ) {
316         ret = jQuery.data( elem, name );
317         evt = jQuery._data( elem, name );
318         if ( ( ret === undefined || ret === evt ) && evt !== undefined ) {
319             migrateWarn("Use of jQuery.fn.data('events') is deprecated");
320             return evt;
321         }
322     }
323     return oldFnData.apply( this, arguments );
324 };
325
326
327 var rscriptType = /\/(java|ecma)script/i,
328     oldSelf = jQuery.fn.andSelf || jQuery.fn.addBack;
329
330 jQuery.fn.andSelf = function() {
331     migrateWarn("jQuery.fn.andSelf() replaced by jQuery.fn.addBack()");
332     return oldSelf.apply( this, arguments );
333 };
334
335 // Since jQuery.clean is used internally on older versions, we only shim if it's missing
336 if ( !jQuery.clean ) {
337     jQuery.clean = function( elems, context, fragment, scripts ) {
338         // Set context per 1.8 logic
339         context = context || document;
340         context = !context.nodeType && context[0] || context;
341         context = context.ownerDocument || context;
342
343         migrateWarn("jQuery.clean() is deprecated");
344
345         var i, elem, handleScript, jsTags,
346             ret = [];
347
348         jQuery.merge( ret, jQuery.buildFragment( elems, context ).childNodes );
349
350         // Complex logic lifted directly from jQuery 1.8
351         if ( fragment ) {
352             // Special handling of each script element
353             handleScript = function( elem ) {
354                 // Check if we consider it executable
355                 if ( !elem.type || rscriptType.test( elem.type ) ) {
356                     // Detach the script and store it in the scripts array (if provided) or the fragment
357                     // Return truthy to indicate that it has been handled
358                     return scripts ?
359                         scripts.push( elem.parentNode ? elem.parentNode.removeChild( elem ) : elem ) :
360                         fragment.appendChild( elem );
361                 }
362             };
363
364             for ( i = 0; (elem = ret[i]) != null; i++ ) {
365                 // Check if we're done after handling an executable script
366                 if ( !( jQuery.nodeName( elem, "script" ) && handleScript( elem ) ) ) {
367                     // Append to fragment and handle embedded scripts
368                     fragment.appendChild( elem );
369                     if ( typeof elem.getElementsByTagName !== "undefined" ) {
370                         // handleScript alters the DOM, so use jQuery.merge to ensure snapshot iteration
371                         jsTags = jQuery.grep( jQuery.merge( [], elem.getElementsByTagName("script") ), handleScript );
372
373                         // Splice the scripts into ret after their former ancestor and advance our index beyond them
374                         ret.splice.apply( ret, [i + 1, 0].concat( jsTags ) );
375                         i += jsTags.length;
376                     }
377                 }
378             }
379         }
380
381         return ret;
382     };
383 }
384
385 var eventAdd = jQuery.event.add,
386     eventRemove = jQuery.event.remove,
387     eventTrigger = jQuery.event.trigger,
388     oldToggle = jQuery.fn.toggle,
389     oldLive = jQuery.fn.live,
390     oldDie = jQuery.fn.die,
391     ajaxEvents = "ajaxStart|ajaxStop|ajaxSend|ajaxComplete|ajaxError|ajaxSuccess",
392     rajaxEvent = new RegExp( "\\b(?:" + ajaxEvents + ")\\b" ),
393     rhoverHack = /(?:^|\s)hover(\.\S+|)\b/,
394     hoverHack = function( events ) {
395         if ( typeof( events ) !== "string" || jQuery.event.special.hover ) {
396             return events;
397         }
398         if ( rhoverHack.test( events ) ) {
399             migrateWarn("'hover' pseudo-event is deprecated, use 'mouseenter mouseleave'");
400         }
401         return events && events.replace( rhoverHack, "mouseenter$1 mouseleave$1" );
402     };
403
404 // Event props removed in 1.9, put them back if needed; no practical way to warn them
405 if ( jQuery.event.props && jQuery.event.props[ 0 ] !== "attrChange" ) {
406     jQuery.event.props.unshift( "attrChange", "attrName", "relatedNode", "srcElement" );
407 }
408
409 // Undocumented jQuery.event.handle was "deprecated" in jQuery 1.7
410 if ( jQuery.event.dispatch ) {
411     migrateWarnProp( jQuery.event, "handle", jQuery.event.dispatch, "jQuery.event.handle is undocumented and deprecated" );
412 }
413
414 // Support for 'hover' pseudo-event and ajax event warnings
415 jQuery.event.add = function( elem, types, handler, data, selector ){
416     if ( elem !== document && rajaxEvent.test( types ) ) {
417         migrateWarn( "AJAX events should be attached to document: " + types );
418     }
419     eventAdd.call( this, elem, hoverHack( types || "" ), handler, data, selector );
420 };
421 jQuery.event.remove = function( elem, types, handler, selector, mappedTypes ){
422     eventRemove.call( this, elem, hoverHack( types ) || "", handler, selector, mappedTypes );
423 };
424
425 jQuery.fn.error = function() {
426     var args = Array.prototype.slice.call( arguments, 0);
427     migrateWarn("jQuery.fn.error() is deprecated");
428     args.splice( 0, 0, "error" );
429     if ( arguments.length ) {
430         return this.bind.apply( this, args );
431     }
432     // error event should not bubble to window, although it does pre-1.7
433     this.triggerHandler.apply( this, args );
434     return this;
435 };
436
437 jQuery.fn.toggle = function( fn, fn2 ) {
438
439     // Don't mess with animation or css toggles
440     if ( !jQuery.isFunction( fn ) || !jQuery.isFunction( fn2 ) ) {
441         return oldToggle.apply( this, arguments );
442     }
443     migrateWarn("jQuery.fn.toggle(handler, handler...) is deprecated");
444
445     // Save reference to arguments for access in closure
446     var args = arguments,
447         guid = fn.guid || jQuery.guid++,
448         i = 0,
449         toggler = function( event ) {
450             // Figure out which function to execute
451             var lastToggle = ( jQuery._data( this, "lastToggle" + fn.guid ) || 0 ) % i;
452             jQuery._data( this, "lastToggle" + fn.guid, lastToggle + 1 );
453
454             // Make sure that clicks stop
455             event.preventDefault();
456
457             // and execute the function
458             return args[ lastToggle ].apply( this, arguments ) || false;
459         };
460
461     // link all the functions, so any of them can unbind this click handler
462     toggler.guid = guid;
463     while ( i < args.length ) {
464         args[ i++ ].guid = guid;
465     }
466
467     return this.click( toggler );
468 };
469
470 jQuery.fn.live = function( types, data, fn ) {
471     migrateWarn("jQuery.fn.live() is deprecated");
472     if ( oldLive ) {
473         return oldLive.apply( this, arguments );
474     }
475     jQuery( this.context ).on( types, this.selector, data, fn );
476     return this;
477 };
478
479 jQuery.fn.die = function( types, fn ) {
480     migrateWarn("jQuery.fn.die() is deprecated");
481     if ( oldDie ) {
482         return oldDie.apply( this, arguments );
483     }
484     jQuery( this.context ).off( types, this.selector || "**", fn );
485     return this;
486 };
487
488 // Turn global events into document-triggered events
489 jQuery.event.trigger = function( event, data, elem, onlyHandlers  ){
490     if ( !elem && !rajaxEvent.test( event ) ) {
491         migrateWarn( "Global events are undocumented and deprecated" );
492     }
493     return eventTrigger.call( this,  event, data, elem || document, onlyHandlers  );
494 };
495 jQuery.each( ajaxEvents.split("|"),
496     function( _, name ) {
497         jQuery.event.special[ name ] = {
498             setup: function() {
499                 var elem = this;
500
501                 // The document needs no shimming; must be !== for oldIE
502                 if ( elem !== document ) {
503                     jQuery.event.add( document, name + "." + jQuery.guid, function() {
504                         jQuery.event.trigger( name, null, elem, true );
505                     });
506                     jQuery._data( this, name, jQuery.guid++ );
507                 }
508                 return false;
509             },
510             teardown: function() {
511                 if ( this !== document ) {
512                     jQuery.event.remove( document, name + "." + jQuery._data( this, name ) );
513                 }
514                 return false;
515             }
516         };
517     }
518 );
519
520
521 })( jQuery, window );