annotate default/node_modules/jquery/src/attributes/val.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/stripAndCollapse",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 "./support",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 "../core/nodeName",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 "../var/isFunction",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 "../core/init"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9 ], function( jQuery, stripAndCollapse, support, nodeName, 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 rreturn = /\r/g;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 jQuery.fn.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 val: function( value ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 var hooks, ret, valueIsFunction,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 elem = this[ 0 ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 if ( !arguments.length ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21 if ( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 hooks = jQuery.valHooks[ elem.type ] ||
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23 jQuery.valHooks[ elem.nodeName.toLowerCase() ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 if ( hooks &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 "get" in hooks &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 ( ret = hooks.get( elem, "value" ) ) !== undefined
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 return ret;
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 ret = elem.value;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 // Handle most common string cases
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 if ( typeof ret === "string" ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 return ret.replace( rreturn, "" );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 // Handle cases where value is null/undef or number
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 return ret == null ? "" : ret;
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 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 valueIsFunction = isFunction( value );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 return this.each( function( i ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49 var val;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51 if ( this.nodeType !== 1 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 if ( valueIsFunction ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 val = value.call( this, i, jQuery( this ).val() );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 val = value;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61 // Treat null/undefined as ""; convert numbers to string
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 if ( val == null ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63 val = "";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65 } else if ( typeof val === "number" ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 val += "";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68 } else if ( Array.isArray( val ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 val = jQuery.map( val, function( value ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70 return 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
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76 // If set returns undefined, fall back to normal setting
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77 if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78 this.value = val;
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 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
82 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
83
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
84 jQuery.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
85 valHooks: {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
86 option: {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
87 get: function( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
88
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
89 var val = jQuery.find.attr( elem, "value" );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
90 return val != null ?
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
91 val :
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
92
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
93 // Support: IE <=10 - 11 only
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
94 // option.text throws exceptions (#14686, #14858)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
95 // Strip and collapse whitespace
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
96 // https://html.spec.whatwg.org/#strip-and-collapse-whitespace
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
97 stripAndCollapse( jQuery.text( elem ) );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
98 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
99 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
100 select: {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
101 get: function( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
102 var value, option, i,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
103 options = elem.options,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
104 index = elem.selectedIndex,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
105 one = elem.type === "select-one",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
106 values = one ? null : [],
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
107 max = one ? index + 1 : options.length;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
108
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
109 if ( index < 0 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
110 i = max;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
111
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
112 } else {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
113 i = one ? index : 0;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
114 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
115
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
116 // Loop through all the selected options
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
117 for ( ; i < max; i++ ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
118 option = options[ i ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
119
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
120 // Support: IE <=9 only
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
121 // IE8-9 doesn't update selected after form reset (#2551)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
122 if ( ( option.selected || i === index ) &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
123
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
124 // Don't return options that are disabled or in a disabled optgroup
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
125 !option.disabled &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
126 ( !option.parentNode.disabled ||
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
127 !nodeName( option.parentNode, "optgroup" ) ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
128
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
129 // Get the specific value for the option
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
130 value = jQuery( option ).val();
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
131
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
132 // We don't need an array for one selects
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
133 if ( one ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
134 return value;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
135 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
136
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
137 // Multi-Selects return an array
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
138 values.push( value );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
139 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
140 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
141
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
142 return values;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
143 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
144
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
145 set: function( elem, value ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
146 var optionSet, option,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
147 options = elem.options,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
148 values = jQuery.makeArray( value ),
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
149 i = options.length;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
150
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
151 while ( i-- ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
152 option = options[ i ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
153
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
154 /* eslint-disable no-cond-assign */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
155
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
156 if ( option.selected =
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
157 jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
158 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
159 optionSet = true;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
160 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
161
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
162 /* eslint-enable no-cond-assign */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
163 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
164
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
165 // Force browsers to behave consistently when non-matching value is set
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
166 if ( !optionSet ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
167 elem.selectedIndex = -1;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
168 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
169 return values;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
170 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
171 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
172 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
173 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
174
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
175 // Radios and checkboxes getter/setter
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
176 jQuery.each( [ "radio", "checkbox" ], function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
177 jQuery.valHooks[ this ] = {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
178 set: function( elem, value ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
179 if ( Array.isArray( value ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
180 return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
181 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
182 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
183 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
184 if ( !support.checkOn ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
185 jQuery.valHooks[ this ].get = function( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
186 return elem.getAttribute( "value" ) === null ? "on" : elem.value;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
187 };
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
188 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
189 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
190
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
191 } );