annotate default/node_modules/jquery/src/serialize.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 "./core/toType",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 "./manipulation/var/rcheckableType",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 "./var/isFunction",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 "./core/init",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7 "./traversing", // filter
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 "./attributes/prop"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 ], function( jQuery, toType, rcheckableType, isFunction ) {
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 var
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 rbracket = /\[\]$/,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 rCRLF = /\r?\n/g,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 rsubmittable = /^(?:input|select|textarea|keygen)/i;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 function buildParams( prefix, obj, traditional, add ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 var name;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 if ( Array.isArray( obj ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 // Serialize array item.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 jQuery.each( obj, function( i, v ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 if ( traditional || rbracket.test( prefix ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 // Treat each array item as a scalar.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 add( prefix, v );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 // Item is non-scalar (array or object), encode its numeric index.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 buildParams(
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 v,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 traditional,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 add
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 }
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 } else if ( !traditional && toType( obj ) === "object" ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 // Serialize object item.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 for ( name in obj ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 // Serialize scalar item.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53 add( prefix, obj );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 }
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 // Serialize an array of form elements or a set of
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 // key/values into a query string
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 jQuery.param = function( a, traditional ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 var prefix,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61 s = [],
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 add = function( key, valueOrFunction ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 // If value is a function, invoke it and use its return value
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65 var value = isFunction( valueOrFunction ) ?
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 valueOrFunction() :
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67 valueOrFunction;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 s[ s.length ] = encodeURIComponent( key ) + "=" +
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70 encodeURIComponent( value == null ? "" : value );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
71 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
72
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
73 // If an array was passed in, assume that it is an array of form elements.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76 // Serialize the form elements
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77 jQuery.each( a, function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78 add( this.name, this.value );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
79 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
80
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
81 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
82
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
83 // If traditional, encode the "old" way (the way 1.3.2 or older
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
84 // did it), otherwise encode params recursively.
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
85 for ( prefix in a ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
86 buildParams( prefix, a[ prefix ], traditional, add );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
87 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
88 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
89
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
90 // Return the resulting serialization
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
91 return s.join( "&" );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
92 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
93
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
94 jQuery.fn.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
95 serialize: function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
96 return jQuery.param( this.serializeArray() );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
97 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
98 serializeArray: function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
99 return this.map( function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
100
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
101 // Can add propHook for "elements" to filter or add form elements
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
102 var elements = jQuery.prop( this, "elements" );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
103 return elements ? jQuery.makeArray( elements ) : this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
104 } )
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
105 .filter( function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
106 var type = this.type;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
107
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
108 // Use .is( ":disabled" ) so that fieldset[disabled] works
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
109 return this.name && !jQuery( this ).is( ":disabled" ) &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
110 rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
111 ( this.checked || !rcheckableType.test( type ) );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
112 } )
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
113 .map( function( i, elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
114 var val = jQuery( this ).val();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
115
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
116 if ( val == null ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
117 return null;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
118 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
119
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
120 if ( Array.isArray( val ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
121 return jQuery.map( val, function( val ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
122 return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
123 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
124 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
125
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
126 return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
127 } ).get();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
128 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
129 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
130
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
131 return jQuery;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
132 } );