jssource/src_files/include/javascript/yui3/build/stylesheet/stylesheet.js

   1 /*
   2 Copyright (c) 2010, Yahoo! Inc. All rights reserved.
   3 Code licensed under the BSD License:
   4 http://developer.yahoo.com/yui/license.html
   5 version: 3.3.0
   6 build: 3167
   7 */
   8 YUI.add('stylesheet', function(Y) {
   9
  10 /**
  11  * The StyleSheet component is a module for creating and modifying CSS
  12  * stylesheets.
  13  *
  14  * @module stylesheet
  15  */
  16 var d      = Y.config.doc,
  17     p      = d.createElement('p'), // Have to hold the node (see notes)
  18     workerStyle = p.style, // worker style collection
  19     isString = Y.Lang.isString,
  20     selectors = {},
  21     sheets = {},
  22     floatAttr = ('cssFloat' in workerStyle) ? 'cssFloat' : 'styleFloat',
  23     _toCssText,
  24     _unsetOpacity,
  25     _unsetProperty,
  26     OPACITY = 'opacity',
  27     FLOAT   = 'float',
  28     EMPTY   = '';
  29
  30 // Normalizes the removal of an assigned style for opacity.  IE uses the filter
  31 // property.
  32 _unsetOpacity = (OPACITY in workerStyle) ?
  33     function (style) { style.opacity = EMPTY; } :
  34     function (style) { style.filter = EMPTY; };
  35
  36 // Normalizes the removal of an assigned style for a given property.  Expands
  37 // shortcut properties if necessary and handles the various names for the float
  38 // property.
  39 workerStyle.border = "1px solid red";
  40 workerStyle.border = EMPTY; // IE doesn't unset child properties
  41 _unsetProperty = workerStyle.borderLeft ?
  42     function (style,prop) {
  43         var p;
  44         if (prop !== floatAttr && prop.toLowerCase().indexOf(FLOAT) != -1) {
  45             prop = floatAttr;
  46         }
  47         if (isString(style[prop])) {
  48             switch (prop) {
  49                 case OPACITY:
  50                 case 'filter' : _unsetOpacity(style); break;
  51                 case 'font'   :
  52                     style.font       = style.fontStyle = style.fontVariant =
  53                     style.fontWeight = style.fontSize  = style.lineHeight  =
  54                     style.fontFamily = EMPTY;
  55                     break;
  56                 default       :
  57                     for (p in style) {
  58                         if (p.indexOf(prop) === 0) {
  59                             style[p] = EMPTY;
  60                         }
  61                     }
  62             }
  63         }
  64     } :
  65     function (style,prop) {
  66         if (prop !== floatAttr && prop.toLowerCase().indexOf(FLOAT) != -1) {
  67             prop = floatAttr;
  68         }
  69         if (isString(style[prop])) {
  70             if (prop === OPACITY) {
  71                 _unsetOpacity(style);
  72             } else {
  73                 style[prop] = EMPTY;
  74             }
  75         }
  76     };
  77
  78 /**
  79  * Create an instance of StyleSheet to encapsulate a css stylesheet.
  80  * The constructor can be called using function or constructor syntax.
  81  * <pre><code>var sheet = Y.StyleSheet(..);</pre></code>
  82  * or
  83  * <pre><code>var sheet = new Y.StyleSheet(..);</pre></code>
  84  *
  85  * The first parameter passed can be any of the following things:
  86  * <ul>
  87  *   <li>The desired string name to register a new empty sheet</li>
  88  *   <li>The string name of an existing StyleSheet instance</li>
  89  *   <li>The unique guid generated for an existing StyleSheet instance</li>
  90  *   <li>The id of an existing <code>&lt;link&gt;</code> or <code>&lt;style&gt;</code> node</li>
  91  *   <li>The node reference for an existing <code>&lt;link&gt;</code> or <code>&lt;style&gt;</code> node</li>
  92  *   <li>The Y.Node instance wrapping an existing <code>&lt;link&gt;</code> or <code>&lt;style&gt;</code> node</li>
  93  *   <li>A chunk of css text to create a new stylesheet from</li>
  94  * </ul>
  95  *
  96  * <p>If a string is passed, StyleSheet will first look in its static name
  97  * registry for an existing sheet, then in the DOM for an element with that id.
  98  * If neither are found and the string contains the { character, it will be
  99  * used as a the initial cssText for a new StyleSheet.  Otherwise, a new empty
 100  * StyleSheet is created, assigned the string value as a name, and registered
 101  * statically by that name.</p>
 102  *
 103  * <p>The optional second parameter is a string name to register the sheet as.
 104  * This param is largely useful when providing a node id/ref or chunk of css
 105  * text to create a populated instance.</p>
 106  *
 107  * @class StyleSheet
 108  * @constructor
 109  * @param seed {String|HTMLElement|Node} a style or link node, its id, or a
 110  *              name or guid of a StyleSheet, or a string of css text
 111  * @param name {String} (optional) name to register instance for future static
 112  *              access
 113  */
 114 function StyleSheet(seed, name) {
 115     var head,
 116         node,
 117         sheet,
 118         cssRules = {},
 119         _rules,
 120         _insertRule,
 121         _deleteRule,
 122         i,r,sel;
 123
 124     // Factory or constructor
 125     if (!(Y.instanceOf(this, StyleSheet))) {
 126         return new StyleSheet(seed,name);
 127     }
 128
 129     // Extract the DOM node from Node instances
 130     if (seed) {
 131         if (Y.Node && seed instanceof Y.Node) {
 132             node = seed._node;
 133         } else if (seed.nodeName) {
 134             node = seed;
 135         // capture the DOM node if the string is an id
 136         } else if (isString(seed)) {
 137             if (seed && sheets[seed]) {
 138                 return sheets[seed];
 139             }
 140             node = d.getElementById(seed.replace(/^#/,EMPTY));
 141         }
 142
 143         // Check for the StyleSheet in the static registry
 144         if (node && sheets[Y.stamp(node)]) {
 145             return sheets[Y.stamp(node)];
 146         }
 147     }
 148
 149
 150     // Create a style node if necessary
 151     if (!node || !/^(?:style|link)$/i.test(node.nodeName)) {
 152         node = d.createElement('style');
 153         node.type = 'text/css';
 154     }
 155
 156     if (isString(seed)) {
 157         // Create entire sheet from seed cssText
 158         if (seed.indexOf('{') != -1) {
 159             // Not a load-time fork because low run-time impact and IE fails
 160             // test for s.styleSheet at page load time (oddly)
 161             if (node.styleSheet) {
 162                 node.styleSheet.cssText = seed;
 163             } else {
 164                 node.appendChild(d.createTextNode(seed));
 165             }
 166         } else if (!name) {
 167             name = seed;
 168         }
 169     }
 170
 171     // Make sure the node is attached to the appropriate head element
 172     if (!node.parentNode || node.parentNode.nodeName.toLowerCase() !== 'head') {
 173         head = (node.ownerDocument || d).getElementsByTagName('head')[0];
 174         // styleSheet isn't available on the style node in FF2 until appended
 175         // to the head element.  style nodes appended to body do not affect
 176         // change in Safari.
 177         head.appendChild(node);
 178     }
 179
 180     // Begin setting up private aliases to the important moving parts
 181     // 1. The stylesheet object
 182     // IE stores StyleSheet under the "styleSheet" property
 183     // Safari doesn't populate sheet for xdomain link elements
 184     sheet = node.sheet || node.styleSheet;
 185
 186     // 2. The style rules collection
 187     // IE stores the rules collection under the "rules" property
 188     _rules = sheet && ('cssRules' in sheet) ? 'cssRules' : 'rules';
 189
 190     // 3. The method to remove a rule from the stylesheet
 191     // IE supports removeRule
 192     _deleteRule = ('deleteRule' in sheet) ?
 193         function (i) { sheet.deleteRule(i); } :
 194         function (i) { sheet.removeRule(i); };
 195
 196     // 4. The method to add a new rule to the stylesheet
 197     // IE supports addRule with different signature
 198     _insertRule = ('insertRule' in sheet) ?
 199         function (sel,css,i) { sheet.insertRule(sel+' {'+css+'}',i); } :
 200         function (sel,css,i) { sheet.addRule(sel,css,i); };
 201
 202     // 5. Initialize the cssRules map from the node
 203     // xdomain link nodes forbid access to the cssRules collection, so this
 204     // will throw an error.
 205     // TODO: research alternate stylesheet, @media
 206     for (i = sheet[_rules].length - 1; i >= 0; --i) {
 207         r   = sheet[_rules][i];
 208         sel = r.selectorText;
 209
 210         if (cssRules[sel]) {
 211             cssRules[sel].style.cssText += ';' + r.style.cssText;
 212             _deleteRule(i);
 213         } else {
 214             cssRules[sel] = r;
 215         }
 216     }
 217
 218     // Cache the instance by the generated Id
 219     StyleSheet.register(Y.stamp(node),this);
 220
 221     // Register the instance by name if provided or defaulted from seed
 222     if (name) {
 223         StyleSheet.register(name,this);
 224     }
 225
 226     // Public API
 227     Y.mix(this,{
 228         /**
 229          * Get the unique stamp for this StyleSheet instance
 230          *
 231          * @method getId
 232          * @return {Number} the static id
 233          */
 234         getId : function () { return Y.stamp(node); },
 235
 236         /**
 237          * Enable all the rules in the sheet
 238          *
 239          * @method enable
 240          * @return {StyleSheet}
 241          * @chainable
 242          */
 243         enable : function () { sheet.disabled = false; return this; },
 244
 245         /**
 246          * Disable all the rules in the sheet.  Rules may be changed while the
 247          * StyleSheet is disabled.
 248          *
 249          * @method disable
 250          * @return {StyleSheet}
 251          * @chainable
 252          */
 253         disable : function () { sheet.disabled = true; return this; },
 254
 255         /**
 256          * Returns false if the StyleSheet is disabled.  Otherwise true.
 257          *
 258          * @method isEnabled
 259          * @return {Boolean}
 260          */
 261         isEnabled : function () { return !sheet.disabled; },
 262
 263         /**
 264          * <p>Set style properties for a provided selector string.
 265          * If the selector includes commas, it will be split into individual
 266          * selectors and applied accordingly.  If the selector string does not
 267          * have a corresponding rule in the sheet, it will be added.</p>
 268          *
 269          * <p>The object properties in the second parameter must be the JavaScript
 270          * names of style properties.  E.g. fontSize rather than font-size.</p>
 271          *
 272          * <p>The float style property will be set by any of &quot;float&quot;,
 273          * &quot;styleFloat&quot;, or &quot;cssFloat&quot;.</p>
 274          *
 275          * @method set
 276          * @param sel {String} the selector string to apply the changes to
 277          * @param css {Object} Object literal of style properties and new values
 278          * @return {StyleSheet}
 279          * @chainable
 280          */
 281         set : function (sel,css) {
 282             var rule = cssRules[sel],
 283                 multi = sel.split(/\s*,\s*/),i,
 284                 idx;
 285
 286             // IE's addRule doesn't support multiple comma delimited selectors
 287             if (multi.length > 1) {
 288                 for (i = multi.length - 1; i >= 0; --i) {
 289                     this.set(multi[i], css);
 290                 }
 291                 return this;
 292             }
 293
 294             // Some selector values can cause IE to hang
 295             if (!StyleSheet.isValidSelector(sel)) {
 296                 return this;
 297             }
 298
 299             // Opera throws an error if there's a syntax error in assigned
 300             // cssText. Avoid this using a worker style collection, then
 301             // assigning the resulting cssText.
 302             if (rule) {
 303                 rule.style.cssText = StyleSheet.toCssText(css,rule.style.cssText);
 304             } else {
 305                 idx = sheet[_rules].length;
 306                 css = StyleSheet.toCssText(css);
 307
 308                 // IE throws an error when attempting to addRule(sel,'',n)
 309                 // which would crop up if no, or only invalid values are used
 310                 if (css) {
 311                     _insertRule(sel, css, idx);
 312
 313                     // Safari replaces the rules collection, but maintains the
 314                     // rule instances in the new collection when rules are
 315                     // added/removed
 316                     cssRules[sel] = sheet[_rules][idx];
 317                 }
 318             }
 319             return this;
 320         },
 321
 322         /**
 323          * <p>Unset style properties for a provided selector string, removing
 324          * their effect from the style cascade.</p>
 325          *
 326          * <p>If the selector includes commas, it will be split into individual
 327          * selectors and applied accordingly.  If there are no properties
 328          * remaining in the rule after unsetting, the rule is removed.</p>
 329          *
 330          * <p>The style property or properties in the second parameter must be the
 331          * JavaScript style property names. E.g. fontSize rather than font-size.</p>
 332          *
 333          * <p>The float style property will be unset by any of &quot;float&quot;,
 334          * &quot;styleFloat&quot;, or &quot;cssFloat&quot;.</p>
 335          *
 336          * @method unset
 337          * @param sel {String} the selector string to apply the changes to
 338          * @param css {String|Array} style property name or Array of names
 339          * @return {StyleSheet}
 340          * @chainable
 341          */
 342         unset : function (sel,css) {
 343             var rule = cssRules[sel],
 344                 multi = sel.split(/\s*,\s*/),
 345                 remove = !css,
 346                 rules, i;
 347
 348             // IE's addRule doesn't support multiple comma delimited selectors
 349             // so rules are mapped internally by atomic selectors
 350             if (multi.length > 1) {
 351                 for (i = multi.length - 1; i >= 0; --i) {
 352                     this.unset(multi[i], css);
 353                 }
 354                 return this;
 355             }
 356
 357             if (rule) {
 358                 if (!remove) {
 359                     css = Y.Array(css);
 360
 361                     workerStyle.cssText = rule.style.cssText;
 362                     for (i = css.length - 1; i >= 0; --i) {
 363                         _unsetProperty(workerStyle,css[i]);
 364                     }
 365
 366                     if (workerStyle.cssText) {
 367                         rule.style.cssText = workerStyle.cssText;
 368                     } else {
 369                         remove = true;
 370                     }
 371                 }
 372
 373                 if (remove) { // remove the rule altogether
 374                     rules = sheet[_rules];
 375                     for (i = rules.length - 1; i >= 0; --i) {
 376                         if (rules[i] === rule) {
 377                             delete cssRules[sel];
 378                             _deleteRule(i);
 379                             break;
 380                         }
 381                     }
 382                 }
 383             }
 384             return this;
 385         },
 386
 387         /**
 388          * Get the current cssText for a rule or the entire sheet.  If the
 389          * selector param is supplied, only the cssText for that rule will be
 390          * returned, if found.  If the selector string targets multiple
 391          * selectors separated by commas, the cssText of the first rule only
 392          * will be returned.  If no selector string, the stylesheet's full
 393          * cssText will be returned.
 394          *
 395          * @method getCssText
 396          * @param sel {String} Selector string
 397          * @return {String}
 398          */
 399         getCssText : function (sel) {
 400             var rule, css, selector;
 401
 402             if (isString(sel)) {
 403                 // IE's addRule doesn't support multiple comma delimited
 404                 // selectors so rules are mapped internally by atomic selectors
 405                 rule = cssRules[sel.split(/\s*,\s*/)[0]];
 406
 407                 return rule ? rule.style.cssText : null;
 408             } else {
 409                 css = [];
 410                 for (selector in cssRules) {
 411                     if (cssRules.hasOwnProperty(selector)) {
 412                         rule = cssRules[selector];
 413                         css.push(rule.selectorText+" {"+rule.style.cssText+"}");
 414                     }
 415                 }
 416                 return css.join("\n");
 417             }
 418         }
 419     });
 420
 421 }
 422
 423 _toCssText = function (css,base) {
 424     var f    = css.styleFloat || css.cssFloat || css[FLOAT],
 425         trim = Y.Lang.trim,
 426         prop;
 427
 428     // A very difficult to repro/isolate IE 9 beta (and Platform Preview 7) bug
 429     // was reduced to this line throwing the error:
 430     // "Invalid this pointer used as target for method call"
 431     // It appears that the style collection is corrupted. The error is
 432     // catchable, so in a best effort to work around it, replace the
 433     // p and workerStyle and try the assignment again.
 434     try {
 435         workerStyle.cssText = base || EMPTY;
 436     } catch (e) {
 437         p = d.createElement('p');
 438         workerStyle = p.style;
 439         workerStyle.cssText = base || EMPTY;
 440     }
 441
 442     if (f && !css[floatAttr]) {
 443         css = Y.merge(css);
 444         delete css.styleFloat; delete css.cssFloat; delete css[FLOAT];
 445         css[floatAttr] = f;
 446     }
 447
 448     for (prop in css) {
 449         if (css.hasOwnProperty(prop)) {
 450             try {
 451                 // IE throws Invalid Value errors and doesn't like whitespace
 452                 // in values ala ' red' or 'red '
 453                 workerStyle[prop] = trim(css[prop]);
 454             }
 455             catch (ex) {
 456             }
 457         }
 458     }
 459     return workerStyle.cssText;
 460 };
 461
 462 Y.mix(StyleSheet, {
 463     /**
 464      * <p>Converts an object literal of style properties and values into a string
 465      * of css text.  This can then be assigned to el.style.cssText.</p>
 466      *
 467      * <p>The optional second parameter is a cssText string representing the
 468      * starting state of the style prior to alterations.  This is most often
 469      * extracted from the eventual target's current el.style.cssText.</p>
 470      *
 471      * @method StyleSheet.toCssText
 472      * @param css {Object} object literal of style properties and values
 473      * @param cssText {String} (optional) starting cssText value
 474      * @return {String} the resulting cssText string
 475      * @static
 476      */
 477     toCssText : ((OPACITY in workerStyle) ? _toCssText :
 478         // Wrap IE's toCssText to catch opacity.  The copy/merge is to preserve
 479         // the input object's integrity, but if float and opacity are set, the
 480         // input will be copied twice in IE.  Is there a way to avoid this
 481         // without increasing the byte count?
 482         function (css, cssText) {
 483             if (OPACITY in css) {
 484                 css = Y.merge(css,{
 485                         filter: 'alpha(opacity='+(css.opacity*100)+')'
 486                       });
 487                 delete css.opacity;
 488             }
 489             return _toCssText(css,cssText);
 490         }),
 491
 492     /**
 493      * Registers a StyleSheet instance in the static registry by the given name
 494      *
 495      * @method StyleSheet.register
 496      * @param name {String} the name to assign the StyleSheet in the registry
 497      * @param sheet {StyleSheet} The StyleSheet instance
 498      * @return {Boolean} false if no name or sheet is not a StyleSheet
 499      *              instance. true otherwise.
 500      * @static
 501      */
 502     register : function (name,sheet) {
 503         return !!(name && sheet instanceof StyleSheet &&
 504                   !sheets[name] && (sheets[name] = sheet));
 505     },
 506
 507     /**
 508      * <p>Determines if a selector string is safe to use.  Used internally
 509      * in set to prevent IE from locking up when attempting to add a rule for a
 510      * &quot;bad selector&quot;.</p>
 511      *
 512      * <p>Bad selectors are considered to be any string containing unescaped
 513      * `~!@$%^&()+=|{}[];'"?< or space. Also forbidden are . or # followed by
 514      * anything other than an alphanumeric.  Additionally -abc or .-abc or
 515      * #_abc or '# ' all fail.  There are likely more failure cases, so
 516      * please file a bug if you encounter one.</p>
 517      *
 518      * @method StyleSheet.isValidSelector
 519      * @param sel {String} the selector string
 520      * @return {Boolean}
 521      * @static
 522      */
 523     isValidSelector : function (sel) {
 524         var valid = false;
 525
 526         if (sel && isString(sel)) {
 527
 528             if (!selectors.hasOwnProperty(sel)) {
 529                 // TEST: there should be nothing but white-space left after
 530                 // these destructive regexs
 531                 selectors[sel] = !/\S/.test(
 532                     // combinators
 533                     sel.replace(/\s+|\s*[+~>]\s*/g,' ').
 534                     // attribute selectors (contents not validated)
 535                     replace(/([^ ])\[.*?\]/g,'$1').
 536                     // pseudo-class|element selectors (contents of parens
 537                     // such as :nth-of-type(2) or :not(...) not validated)
 538                     replace(/([^ ])::?[a-z][a-z\-]+[a-z](?:\(.*?\))?/ig,'$1').
 539                     // element tags
 540                     replace(/(?:^| )[a-z0-6]+/ig,' ').
 541                     // escaped characters
 542                     replace(/\\./g,EMPTY).
 543                     // class and id identifiers
 544                     replace(/[.#]\w[\w\-]*/g,EMPTY));
 545             }
 546
 547             valid = selectors[sel];
 548         }
 549
 550         return valid;
 551     }
 552 },true);
 553
 554 Y.StyleSheet = StyleSheet;
 555
 556 /*
 557
 558 NOTES
 559  * Style node must be added to the head element.  Safari does not honor styles
 560    applied to StyleSheet objects on style nodes in the body.
 561  * StyleSheet object is created on the style node when the style node is added
 562    to the head element in Firefox 2 (and maybe 3?)
 563  * The cssRules collection is replaced after insertRule/deleteRule calls in
 564    Safari 3.1.  Existing Rules are used in the new collection, so the collection
 565    cannot be cached, but the rules can be.
 566  * Opera requires that the index be passed with insertRule.
 567  * Same-domain restrictions prevent modifying StyleSheet objects attached to
 568    link elements with remote href (or "about:blank" or "javascript:false")
 569  * Same-domain restrictions prevent reading StyleSheet cssRules/rules
 570    collection of link elements with remote href (or "about:blank" or
 571    "javascript:false")
 572  * Same-domain restrictions result in Safari not populating node.sheet property
 573    for link elements with remote href (et.al)
 574  * IE names StyleSheet related properties and methods differently (see code)
 575  * IE converts tag names to upper case in the Rule's selectorText
 576  * IE converts empty string assignment to complex properties to value settings
 577    for all child properties.  E.g. style.background = '' sets non-'' values on
 578    style.backgroundPosition, style.backgroundColor, etc.  All else clear
 579    style.background and all child properties.
 580  * IE assignment style.filter = '' will result in style.cssText == 'FILTER:'
 581  * All browsers support Rule.style.cssText as a read/write property, leaving
 582    only opacity needing to be accounted for.
 583  * Benchmarks of style.property = value vs style.cssText += 'property: value'
 584    indicate cssText is slightly slower for single property assignment.  For
 585    multiple property assignment, cssText speed stays relatively the same where
 586    style.property speed decreases linearly by the number of properties set.
 587    Exception being Opera 9.27, where style.property is always faster than
 588    style.cssText.
 589  * Opera 9.5b throws a syntax error when assigning cssText with a syntax error.
 590  * Opera 9.5 doesn't honor rule.style.cssText = ''.  Previous style persists.
 591    You have to remove the rule altogether.
 592  * Stylesheet properties set with !important will trump inline style set on an
 593    element or in el.style.property.
 594  * Creating a worker style collection like document.createElement('p').style;
 595    will fail after a time in FF (~5secs of inactivity).  Property assignments
 596    will not alter the property or cssText.  It may be the generated node is
 597    garbage collected and the style collection becomes inert (speculation).
 598  * IE locks up when attempting to add a rule with a selector including at least
 599    characters {[]}~`!@%^&*()+=|? (unescaped) and leading _ or -
 600    such as addRule('-foo','{ color: red }') or addRule('._abc','{...}')
 601  * IE's addRule doesn't support comma separated selectors such as
 602    addRule('.foo, .bar','{..}')
 603  * IE throws an error on valid values with leading/trailing white space.
 604  * When creating an entire sheet at once, only FF2/3 & Opera allow creating a
 605    style node, setting its innerHTML and appending to head.
 606  * When creating an entire sheet at once, Safari requires the style node to be
 607    created with content in innerHTML of another element.
 608  * When creating an entire sheet at once, IE requires the style node content to
 609    be set via node.styleSheet.cssText
 610  * When creating an entire sheet at once in IE, styleSheet.cssText can't be
 611    written until node.type = 'text/css'; is performed.
 612  * When creating an entire sheet at once in IE, load-time fork on
 613    var styleNode = d.createElement('style'); _method = styleNode.styleSheet ?..
 614    fails (falsey).  During run-time, the test for .styleSheet works fine
 615  * Setting complex properties in cssText will SOMETIMES allow child properties
 616    to be unset
 617    set         unset              FF2  FF3  S3.1  IE6  IE7  Op9.27  Op9.5
 618    ----------  -----------------  ---  ---  ----  ---  ---  ------  -----
 619    border      -top               NO   NO   YES   YES  YES  YES     YES
 620                -top-color         NO   NO   YES             YES     YES
 621                -color             NO   NO   NO              NO      NO
 622    background  -color             NO   NO   YES             YES     YES
 623                -position          NO   NO   YES             YES     YES
 624                -position-x        NO   NO   NO              NO      NO
 625    font        line-height        YES  YES  NO    NO   NO   NO      YES
 626                -style             YES  YES  NO              YES     YES
 627                -size              YES  YES  NO              YES     YES
 628                -size-adjust       ???  ???  n/a   n/a  n/a  ???     ???
 629    padding     -top               NO   NO   YES             YES     YES
 630    margin      -top               NO   NO   YES             YES     YES
 631    list-style  -type              YES  YES  YES             YES     YES
 632                -position          YES  YES  YES             YES     YES
 633    overflow    -x                 NO   NO   YES             n/a     YES
 634
 635    ??? - unsetting font-size-adjust has the same effect as unsetting font-size
 636  * FireFox and WebKit populate rule.cssText as "SELECTOR { CSSTEXT }", but
 637    Opera and IE do not.
 638  * IE6 and IE7 silently ignore the { and } if passed into addRule('.foo','{
 639    color:#000}',0).  IE8 does not and creates an empty rule.
 640  * IE6-8 addRule('.foo','',n) throws an error.  Must supply *some* cssText
 641 */
 642
 643
 644
 645 }, '3.3.0' );