annotate default/node_modules/jquery/src/core/init.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 // Initialize a jQuery object
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
2 define( [
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
3 "../core",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 "../var/document",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 "../var/isFunction",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 "./var/rsingleTag",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 "../traversing/findFilter"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 ], function( jQuery, document, isFunction, rsingleTag ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 "use strict";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 // A central reference to the root jQuery(document)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 var rootjQuery,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 // A simple way to check for HTML strings
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 // Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 // Strict HTML recognition (#11290: must start with <)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 // Shortcut simple #id case for speed
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 init = jQuery.fn.init = function( selector, context, root ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 var match, elem;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 // HANDLE: $(""), $(null), $(undefined), $(false)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 if ( !selector ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 // Method init() accepts an alternate rootjQuery
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 // so migrate can support jQuery.sub (gh-2101)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 root = root || rootjQuery;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 // Handle HTML strings
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 if ( typeof selector === "string" ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 if ( selector[ 0 ] === "<" &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 selector[ selector.length - 1 ] === ">" &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 selector.length >= 3 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 // Assume that strings that start and end with <> are HTML and skip the regex check
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 match = [ null, selector, null ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44 match = rquickExpr.exec( selector );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 // Match html or make sure no context is specified for #id
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 if ( match && ( match[ 1 ] || !context ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 // HANDLE: $(html) -> $(array)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 if ( match[ 1 ] ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 context = context instanceof jQuery ? context[ 0 ] : context;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 // Option to run scripts is true for back-compat
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 // Intentionally let the error be thrown if parseHTML is not present
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 jQuery.merge( this, jQuery.parseHTML(
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57 match[ 1 ],
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 context && context.nodeType ? context.ownerDocument || context : document,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 true
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 ) );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 // HANDLE: $(html, props)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63 if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 for ( match in context ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 // Properties of context are called as methods if possible
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67 if ( isFunction( this[ match ] ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68 this[ match ]( context[ match ] );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70 // ...and otherwise set as attributes
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
71 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
72 this.attr( match, context[ match ] );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
73 }
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
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
79 // HANDLE: $(#id)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
80 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
81 elem = document.getElementById( match[ 2 ] );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
82
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
83 if ( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
84
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
85 // Inject the element directly into the jQuery object
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
86 this[ 0 ] = elem;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
87 this.length = 1;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
88 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
89 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
90 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
91
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
92 // HANDLE: $(expr, $(...))
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
93 } else if ( !context || context.jquery ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
94 return ( context || root ).find( selector );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
95
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
96 // HANDLE: $(expr, context)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
97 // (which is just equivalent to: $(context).find(expr)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
98 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
99 return this.constructor( context ).find( selector );
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 // HANDLE: $(DOMElement)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
103 } else if ( selector.nodeType ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
104 this[ 0 ] = selector;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
105 this.length = 1;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
106 return this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
107
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
108 // HANDLE: $(function)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
109 // Shortcut for document ready
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
110 } else if ( isFunction( selector ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
111 return root.ready !== undefined ?
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
112 root.ready( selector ) :
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
113
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
114 // Execute immediately if ready is not present
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
115 selector( jQuery );
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 return jQuery.makeArray( selector, this );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
119 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
120
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
121 // Give the init function the jQuery prototype for later instantiation
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
122 init.prototype = jQuery.fn;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
123
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
124 // Initialize central reference
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
125 rootjQuery = jQuery( document );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
126
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
127 return init;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
128
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
129 } );