First look at css hooks. These hooks provide a way to change how jQuery handles getti...
[jquery.git] / src / css.js
1 // exclude the following css properties to add px
2 var rexclude = /z-?index|font-?weight|opacity|zoom|line-?height/i,
3         ralpha = /alpha\([^)]*\)/,
4         ropacity = /opacity=([^)]*)/,
5         rfloat = /float/i,
6         rdashAlpha = /-([a-z])/ig,
7         rupper = /([A-Z])/g,
8         rnumpx = /^-?\d+(?:px)?$/i,
9         rnum = /^-?\d/,
10
11         cssShow = { position: "absolute", visibility: "hidden", display:"block" },
12         cssWidth = [ "Left", "Right" ],
13         cssHeight = [ "Top", "Bottom" ],
14
15         // cache check for defaultView.getComputedStyle
16         getComputedStyle = document.defaultView && document.defaultView.getComputedStyle,
17         // normalize float css property
18         styleFloat = jQuery.support.cssFloat ? "cssFloat" : "styleFloat",
19         fcamelCase = function( all, letter ) {
20                 return letter.toUpperCase();
21         };
22
23 jQuery.fn.css = function( name, value ) {
24         return jQuery.access( this, name, value, true, function( elem, name, value ) {
25                 if ( value === undefined ) {
26                         return jQuery.curCSS( elem, name );
27                 }
28
29                 if ( typeof value === "number" && !rexclude.test(name) ) {
30                         value += "px";
31                 }
32
33                 jQuery.style( elem, name, value );
34         });
35 };
36
37 jQuery.extend({
38         cssHooks: {
39                 opacity: {
40                         get: function( elem, force ) {
41                                 var style = elem.style;
42                                 if ( jQuery.support.opacity && !style.filter ) {
43                                         return false; // move along, nothing to see here
44                                 }
45
46                                 // IE uses filters for opacity
47                                 var ret = ropacity.test(elem.currentStyle.filter || "") ?
48                                                         (parseFloat(RegExp.$1) / 100) + "" :
49                                                         "";
50
51                                 return ret === "" ?
52                                         "1" :
53                                         ret;
54                         },
55
56                         set: function( elem, value ) {
57                                 var style = elem.style;
58                                 if ( jQuery.support.opacity && !style.filter ) {
59                                         return false; // move along, nothing to see here
60                                 }
61
62                                 // IE has trouble with opacity if it does not have layout
63                                 // Force it by setting the zoom level
64                                 style.zoom = 1;
65
66                                 // Set the alpha filter to set the opacity
67                                 var opacity = parseInt( value, 10 ) + "" === "NaN" ? "" : "alpha(opacity=" + value * 100 + ")";
68                                 var filter = style.filter || jQuery.curCSS( elem, "filter" ) || "";
69                                 style.filter = ralpha.test(filter) ? filter.replace(ralpha, opacity) : opacity;
70                         }
71                 }
72         },
73
74         style: function( elem, name, value ) {
75                 // don't set styles on text and comment nodes
76                 if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 ) {
77                         return undefined;
78                 }
79
80                 // ignore negative width and height values #1599
81                 if ( (name === "width" || name === "height") && parseFloat(value) < 0 ) {
82                         value = undefined;
83                 }
84
85                 var style = elem.style || elem, set = value !== undefined;
86
87                 // Make sure we're using the right name for getting the float value
88                 if ( rfloat.test( name ) ) {
89                         name = styleFloat;
90                 }
91
92                 name = name.replace(rdashAlpha, fcamelCase);
93
94                 var hooks = jQuery.cssHooks[name] || {};
95
96                 if ( set ) {
97                         if ( !('set' in hooks) || hooks.set( elem, value ) === false ) {
98                                 style[ name ] = value;
99                         }
100                 }
101
102                 if ( 'get' in hooks ) {
103                         var cssHookReturn = hooks.get( elem, false );
104                         if ( cssHookReturn !== false ) {
105                                 return cssHookReturn;
106                         }
107                 }
108
109                 return style[ name ];
110         },
111
112         css: function( elem, name, force, extra ) {
113                 if ( name === "width" || name === "height" ) {
114                         if ( elem.offsetWidth !== 0 ) {
115                                 val = getWH( elem, name, extra );
116
117                         } else {
118                                 jQuery.swap( elem, cssShow, function() {
119                                         val = getWH( elem, name, extra );
120                                 });
121                         }
122
123                         return Math.max(0, Math.round(val));
124                 }
125
126                 return jQuery.curCSS( elem, name, force );
127         },
128
129         curCSS: function( elem, name, force ) {
130                 var ret, style = elem.style, filter, hooks = jQuery.cssHooks[name] || {};
131
132                 // Make sure we're using the right name for getting the float value
133                 if ( rfloat.test( name ) ) {
134                         name = styleFloat;
135                 }
136
137                 if ( 'get' in hooks && ( ret = hooks.get( elem, force ) ) !== false ) {
138                         return ret;
139                 }
140
141                 if ( !force && style && style[ name ] ) {
142                         ret = style[ name ];
143
144                 } else if ( getComputedStyle ) {
145
146                         // Only "float" is needed here
147                         if ( rfloat.test( name ) ) {
148                                 name = "float";
149                         }
150
151                         name = name.replace( rupper, "-$1" ).toLowerCase();
152
153                         var defaultView = elem.ownerDocument.defaultView;
154
155                         if ( !defaultView ) {
156                                 return null;
157                         }
158
159                         var computedStyle = defaultView.getComputedStyle( elem, null );
160
161                         if ( computedStyle ) {
162                                 ret = computedStyle.getPropertyValue( name );
163                         }
164
165                         // We should always get a number back from opacity
166                         if ( name === "opacity" && ret === "" ) {
167                                 ret = "1";
168                         }
169
170                 } else if ( elem.currentStyle ) {
171                         var camelCase = name.replace(rdashAlpha, fcamelCase);
172
173                         ret = elem.currentStyle[ name ] || elem.currentStyle[ camelCase ];
174
175                         // From the awesome hack by Dean Edwards
176                         // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291
177
178                         // If we're not dealing with a regular pixel number
179                         // but a number that has a weird ending, we need to convert it to pixels
180                         if ( !rnumpx.test( ret ) && rnum.test( ret ) ) {
181                                 // Remember the original values
182                                 var left = style.left, rsLeft = elem.runtimeStyle.left;
183
184                                 // Put in the new values to get a computed value out
185                                 elem.runtimeStyle.left = elem.currentStyle.left;
186                                 style.left = camelCase === "fontSize" ? "1em" : (ret || 0);
187                                 ret = style.pixelLeft + "px";
188
189                                 // Revert the changed values
190                                 style.left = left;
191                                 elem.runtimeStyle.left = rsLeft;
192                         }
193                 }
194
195                 return ret;
196         },
197
198         // A method for quickly swapping in/out CSS properties to get correct calculations
199         swap: function( elem, options, callback ) {
200                 var old = {};
201
202                 // Remember the old values, and insert the new ones
203                 for ( var name in options ) {
204                         old[ name ] = elem.style[ name ];
205                         elem.style[ name ] = options[ name ];
206                 }
207
208                 callback.call( elem );
209
210                 // Revert the old values
211                 for ( name in options ) {
212                         elem.style[ name ] = old[ name ];
213                 }
214         }
215 });
216
217 function getWH( elem, name, extra ) {
218         var which = name === "width" ? cssWidth : cssHeight,
219                 val = name === "width" ? elem.offsetWidth : elem.offsetHeight;
220
221         if ( extra === "border" ) {
222                 return val;
223         }
224
225         jQuery.each( which, function() {
226                 if ( !extra ) {
227                         val -= parseFloat(jQuery.curCSS( elem, "padding" + this, true)) || 0;
228                 }
229
230                 if ( extra === "margin" ) {
231                         val += parseFloat(jQuery.curCSS( elem, "margin" + this, true)) || 0;
232
233                 } else {
234                         val -= parseFloat(jQuery.curCSS( elem, "border" + this + "Width", true)) || 0;
235                 }
236         });
237
238         return val;
239 }
240
241 if ( jQuery.expr && jQuery.expr.filters ) {
242         jQuery.expr.filters.hidden = function( elem ) {
243                 var width = elem.offsetWidth, height = elem.offsetHeight,
244                         skip = elem.nodeName.toLowerCase() === "tr";
245
246                 return width === 0 && height === 0 && !skip ?
247                         true :
248                         width > 0 && height > 0 && !skip ?
249                                 false :
250                                 jQuery.curCSS(elem, "display") === "none";
251         };
252
253         jQuery.expr.filters.visible = function( elem ) {
254                 return !jQuery.expr.filters.hidden( elem );
255         };
256 }