annotate default/node_modules/shoestring/src/shoestring.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([], 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 * The shoestring object constructor.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 *
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 * @param {string,object} prim The selector to find or element to wrap.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 * @param {object} sec The context in which to match the `prim` selector.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 * @returns shoestring
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 * @this window
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 function shoestring( prim, sec ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 var pType = typeof( prim ),
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 ret = [],
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 sel;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 // return an empty shoestring object
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 if( !prim ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 return new Shoestring( ret );
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 // ready calls
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 if( prim.call ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 return shoestring.ready( prim );
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 // handle re-wrapping shoestring objects
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 if( prim.constructor === Shoestring && !sec ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 return prim;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 // if string starting with <, make html
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 if( pType === "string" && prim.indexOf( "<" ) === 0 ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 var dfrag = doc.createElement( "div" );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 dfrag.innerHTML = prim;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 // TODO depends on children (circular)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 return shoestring( dfrag ).children().each(function(){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 dfrag.removeChild( this );
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
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 // if string, it's a selector, use qsa
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 if( pType === "string" ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 if( sec ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 return shoestring( sec ).find( prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 //>>includeStart("development", pragmas.development);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 try {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53 //>>includeEnd("development");
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 sel = doc.querySelectorAll( prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 //>>includeStart("development", pragmas.development);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 } catch( e ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57 shoestring.error( 'queryselector', prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 //>>includeEnd("development");
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61 return new Shoestring( sel, prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 // array like objects or node lists
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65 if( Object.prototype.toString.call( pType ) === '[object Array]' ||
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 (win.NodeList && prim instanceof win.NodeList) ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68 return new Shoestring( prim, prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
71 // if it's an array, use all the elements
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
72 if( prim.constructor === Array ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
73 return new Shoestring( prim, prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76 // otherwise assume it's an object the we want at an index
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77 return new Shoestring( [prim], prim );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
79
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
80 var Shoestring = function( ret, prim ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
81 this.length = 0;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
82 this.selector = prim;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
83 shoestring.merge(this, ret);
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 // TODO only required for tests
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
87 Shoestring.prototype.reverse = [].reverse;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
88
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
89 // For adding element set methods
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
90 shoestring.fn = Shoestring.prototype;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
91
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
92 shoestring.Shoestring = Shoestring;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
93
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
94 // For extending objects
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
95 // TODO move to separate module when we use prototypes
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
96 shoestring.extend = function( first, second ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
97 for( var i in second ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
98 if( second.hasOwnProperty( i ) ){
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
99 first[ i ] = second[ i ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
100 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
101 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
102
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
103 return first;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
104 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
105
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
106 // taken directly from jQuery
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
107 shoestring.merge = function( first, second ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
108 var len, j, i;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
109
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
110 len = +second.length,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
111 j = 0,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
112 i = first.length;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
113
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
114 for ( ; j < len; j++ ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
115 first[ i++ ] = second[ j ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
116 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
117
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
118 first.length = i;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
119
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
120 return first;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
121 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
122
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
123 // expose
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
124 win.shoestring = shoestring;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
125
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
126 //>>excludeStart("exclude", pragmas.exclude);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
127 });
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
128 //>>excludeEnd("exclude");