annotate default/node_modules/jquery/src/attributes/prop.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/access",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 "./support",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 "../selector"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 ], function( jQuery, access, support ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 "use strict";
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 var rfocusable = /^(?:input|select|textarea|button)$/i,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 rclickable = /^(?:a|area)$/i;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 jQuery.fn.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14 prop: function( name, value ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 return access( this, jQuery.prop, name, value, arguments.length > 1 );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 removeProp: function( name ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 return this.each( function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 delete this[ jQuery.propFix[ name ] || name ];
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 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 jQuery.extend( {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 prop: function( elem, name, value ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 var ret, hooks,
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28 nType = elem.nodeType;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30 // Don't get/set properties on text, comment and attribute nodes
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 if ( nType === 3 || nType === 8 || nType === 2 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 return;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35 if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37 // Fix name and attach hooks
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 name = jQuery.propFix[ name ] || name;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 hooks = jQuery.propHooks[ name ];
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 if ( value !== undefined ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43 if ( hooks && "set" in hooks &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44 ( ret = hooks.set( elem, value, name ) ) !== undefined ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 return ret;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 return ( elem[ name ] = value );
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 if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 return ret;
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 return elem[ name ];
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58 propHooks: {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 tabIndex: {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 get: function( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 // Support: IE <=9 - 11 only
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63 // elem.tabIndex doesn't always return the
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 // correct value when it hasn't been explicitly set
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65 // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 // Use proper attribute retrieval(#12072)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67 var tabindex = jQuery.find.attr( elem, "tabindex" );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 if ( tabindex ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70 return parseInt( tabindex, 10 );
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 (
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 rfocusable.test( elem.nodeName ) ||
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75 rclickable.test( elem.nodeName ) &&
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76 elem.href
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
77 ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
78 return 0;
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 return -1;
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 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
85
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
86 propFix: {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
87 "for": "htmlFor",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
88 "class": "className"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
89 }
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 // Support: IE <=11 only
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
93 // Accessing the selectedIndex property
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
94 // forces the browser to respect setting selected
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
95 // on the option
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
96 // The getter ensures a default option is selected
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
97 // when in an optgroup
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
98 // eslint rule "no-unused-expressions" is disabled for this code
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
99 // since it considers such accessions noop
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
100 if ( !support.optSelected ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
101 jQuery.propHooks.selected = {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
102 get: function( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
103
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
104 /* eslint no-unused-expressions: "off" */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
105
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
106 var parent = elem.parentNode;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
107 if ( parent && parent.parentNode ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
108 parent.parentNode.selectedIndex;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
109 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
110 return null;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
111 },
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
112 set: function( elem ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
113
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
114 /* eslint no-unused-expressions: "off" */
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
115
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
116 var parent = elem.parentNode;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
117 if ( parent ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
118 parent.selectedIndex;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
119
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
120 if ( parent.parentNode ) {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
121 parent.parentNode.selectedIndex;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
122 }
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 }
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
127
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
128 jQuery.each( [
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
129 "tabIndex",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
130 "readOnly",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
131 "maxLength",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
132 "cellSpacing",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
133 "cellPadding",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
134 "rowSpan",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
135 "colSpan",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
136 "useMap",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
137 "frameBorder",
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
138 "contentEditable"
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
139 ], function() {
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
140 jQuery.propFix[ this.toLowerCase() ] = this;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
141 } );
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
142
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
143 } );