mozilla

Revision 328941 of CSSStyleSheet.insertRule()

  • Revision slug: DOM/CSSStyleSheet/insertRule
  • Revision title: insertRule
  • Revision id: 328941
  • Created:
  • Creator: JaredWein
  • Is current revision? No
  • Comment

Revision Content

{{ DomRef() }}

Summary

The insertRule method inserts a new style rule into the current style sheet.

Syntax

stylesheet.insertRule(rule, index) 

Parameters

  • rule is a string containing the rule to be inserted (selector and declaration).
  • index is a number representing the position to be inserted.

Example 1

 // push a new rule onto the top of my stylesheet
 myStyle.insertRule("#blanc { color: white }", 0); 

Example 2

/**
 * Add a stylesheet rule to the document (may be better practice, however,
 *  to dynamically change classes, so style information can be kept in
 *  genuine styesheets (and avoid adding extra elements to the DOM))
 * Note that an array is needed for declarations and rules since ECMAScript does
 * not afford a predictable object iteration order and since CSS is 
 * order-dependent (i.e., it is cascading); those without need of
 * cascading rules could build a more accessor-friendly object-based API.
 * @param {Array} decls Accepts an array of JSON-encoded declarations
 * @example
addStylesheetRules([
  ['h2', // Also accepts a second argument as an array of arrays instead
    ['color', 'red'],
    ['background-color', 'green', true] // 'true' for !important rules 
  ], 
  ['.myClass', 
    ['background-color', 'yellow']
  ]
]);
 */
function addStylesheetRules (decls) {
    var style = document.createElement('style');
    document.getElementsByTagName('head')[0].appendChild(style);
    if (!window.createPopup) { /* For Safari */
       style.appendChild(document.createTextNode(''));
    }
    var s = document.styleSheets[document.styleSheets.length - 1];
    for (var i=0, dl = decls.length; i < dl; i++) {
        var j = 1, decl = decls[i], selector = decl[0], rulesStr = '';
        if (Object.prototype.toString.call(decl[1][0]) === '[object Array]') {
            decl = decl[1];
            j = 0;
        }
        for (var rl=decl.length; j < rl; j++) {
            var rule = decl[j];
            rulesStr += rule[0] + ':' + rule[1] + (rule[2] ? ' !important' : '') + ';\n';
        }

        if (s.insertRule) {
            s.insertRule(selector + '{' + rulesStr + '}', s.cssRules.length);
        }
        else { /* IE */
            s.addRule(selector, rulesStr, -1);
        }
    }
}

Notes

For rule sets this contains both the selector and the style declaration. For at-rules, this specifies both the at-identifier and the rule content.

Specification

insertRule

{{ languages( { "pl": "pl/DOM/stylesheet.insertRule","zh-cn": "zh-cn/DOM/stylesheet.insertRule" } ) }}

Revision Source

<p>{{ DomRef() }}</p>
<h3 id="Summary" name="Summary">Summary</h3>
<p>The <strong>insertRule</strong> method inserts a new style rule into the current style sheet.</p>
<h3 id="Syntax" name="Syntax">Syntax</h3>
<pre class="eval">
<var style="font-style: italic;">stylesheet</var>.insertRule(<var style="font-style: italic;">rule</var>, <var style="font-style: italic;">index</var>) 
</pre>
<h3 id="Parameters" name="Parameters">Parameters</h3>
<ul>
  <li><code>rule</code> is a string containing the rule to be inserted (selector and declaration).</li>
  <li><code>index</code> is a number representing the position to be inserted.</li>
</ul>
<h3 id="Example" name="Example">Example 1</h3>
<pre class="brush: js">
 // push a new rule onto the top of my stylesheet
 myStyle.insertRule("#blanc { color: white }", 0); 
</pre>
<h3 id="Notes" name="Notes">Example 2</h3>
<pre class="brush: js">
/**
 * Add a stylesheet rule to the document (may be better practice, however,
 *  to dynamically change classes, so style information can be kept in
 *  genuine styesheets (and avoid adding extra elements to the DOM))
 * Note that an array is needed for declarations and rules since ECMAScript does
 * not afford a predictable object iteration order and since CSS is 
 *&nbsp;order-dependent (i.e., it is cascading); those without need of
 *&nbsp;cascading rules could build a more accessor-friendly object-based API.
 * @param {Array} decls Accepts an array of JSON-encoded declarations
 *&nbsp;@example
addStylesheetRules([
  ['h2', // Also accepts a second argument as an array of arrays instead
    ['color', 'red'],
    ['background-color', 'green', true] // 'true' for !important rules 
  ], 
  ['.myClass', 
    ['background-color', 'yellow']
  ]
]);
 */
function addStylesheetRules (decls) {
    var style = document.createElement('style');
    document.getElementsByTagName('head')[0].appendChild(style);
    if (!window.createPopup) { /* For Safari */
       style.appendChild(document.createTextNode(''));
    }
    var s = document.styleSheets[document.styleSheets.length - 1];
    for (var i=0, dl = decls.length; i &lt; dl; i++) {
        var j = 1, decl = decls[i], selector = decl[0], rulesStr = '';
        if (Object.prototype.toString.call(decl[1][0]) === '[object Array]') {
            decl = decl[1];
            j = 0;
        }
        for (var rl=decl.length; j &lt; rl; j++) {
            var rule = decl[j];
            rulesStr += rule[0] + ':' + rule[1] + (rule[2] ? ' !important' : '') + ';\n';
        }

        if (s.insertRule) {
            s.insertRule(selector + '{' + rulesStr + '}', s.cssRules.length);
        }
        else { /* IE */
            s.addRule(selector, rulesStr, -1);
        }
    }
}
</pre>
<h3 id="Notes" name="Notes">Notes</h3>
<p>For rule sets this contains both the selector and the style declaration. For at-rules, this specifies both the at-identifier and the rule content.</p>
<h3 id="Specification" name="Specification">Specification</h3>
<p><a class="external" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSStyleSheet-insertRule">insertRule </a></p>
<p>{{ languages( { "pl": "pl/DOM/stylesheet.insertRule","zh-cn": "zh-cn/DOM/stylesheet.insertRule" } ) }}</p>
Revert to this revision