annotate default/node_modules/jquery/src/core/ready.js @ 0:1d038bc9b3d2 default tip

Up:default
author Liny <dev@neowd.com>
date Sat, 31 May 2025 09:21:51 +0800
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
1 define( [
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
2 "../core",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
3 "../var/document",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 "../core/readyException",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 "../deferred"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 ], function( jQuery, document ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 "use strict";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 // The deferred used on DOM ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 var readyList = jQuery.Deferred();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 jQuery.fn.ready = function( fn ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 readyList
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 .then( fn )
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 // Wrap jQuery.readyException in a function so that the lookup
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 // happens at the time of error handling instead of callback
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 // registration.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21 .catch( function( error ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 jQuery.readyException( error );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 jQuery.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 // Is the DOM ready to be used? Set to true once it occurs.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 isReady: false,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 // A counter to track how many items to wait for before
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 // the ready event fires. See #6781
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 readyWait: 1,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 // Handle when the DOM is ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 ready: function( wait ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 // Abort if there are pending holds or we're already ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 // Remember that the DOM is ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 jQuery.isReady = true;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 // If a normal DOM Ready event fired, decrement, and wait if need be
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 if ( wait !== true && --jQuery.readyWait > 0 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53 // If there are functions bound, to execute
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 readyList.resolveWith( document, [ jQuery ] );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 jQuery.ready.then = readyList.then;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 // The ready event handler and self cleanup method
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61 function completed() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 document.removeEventListener( "DOMContentLoaded", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63 window.removeEventListener( "load", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 jQuery.ready();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67 // Catch cases where $(document).ready() is called
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68 // after the browser event has already occurred.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 // Support: IE <=9 - 10 only
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70 // Older IE sometimes signals "interactive" too soon
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
71 if ( document.readyState === "complete" ||
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
72 ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
73
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 // Handle it asynchronously to allow scripts the opportunity to delay ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75 window.setTimeout( jQuery.ready );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
79 // Use the handy event callback
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
80 document.addEventListener( "DOMContentLoaded", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
81
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
82 // A fallback to window.onload, that will always work
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
83 window.addEventListener( "load", completed );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
84 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
85
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
86 } );