annotate default/node_modules/shoestring/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 //>>excludeStart("exclude", pragmas.exclude);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
2 define([ "shoestring" ], function(){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
3 //>>excludeEnd("exclude");
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 /**
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 * Bind callbacks to be run when the DOM is "ready".
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 *
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 * @param {function} fn The callback to be run
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 * @return shoestring
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 * @this shoestring
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 shoestring.ready = function( fn ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 if( ready && fn ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 fn.call( doc );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 else if( fn ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 readyQueue.push( fn );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 runReady();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 return [doc];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 // TODO necessary?
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 shoestring.fn.ready = function( fn ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 shoestring.ready( fn );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 // Empty and exec the ready queue
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 var ready = false,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 readyQueue = [],
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 runReady = function(){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 if( !ready ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 while( readyQueue.length ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 readyQueue.shift().call( doc );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 ready = true;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44 // If DOM is already ready at exec time, depends on the browser.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 // From: https://github.com/mobify/mobifyjs/blob/526841be5509e28fc949038021799e4223479f8d/src/capture.js#L128
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 if (doc.attachEvent ? doc.readyState === "complete" : doc.readyState !== "loading") {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 runReady();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 doc.addEventListener( "DOMContentLoaded", runReady, false );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 doc.addEventListener( "readystatechange", runReady, false );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 win.addEventListener( "load", runReady, false );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 //>>excludeStart("exclude", pragmas.exclude);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 });
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 //>>excludeEnd("exclude");