|
1 /*! |
|
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 ); |