Section 25.54. CSSStyleSheet.insertRule( ): insert a rule into a stylesheet

25.54. CSSStyleSheet.insertRule( ): insert a rule into a stylesheet

DOM Level 2 CSS:

25.54.1. Synopsis

 unsigned long insertRule(String rule,                          unsigned long index)     throws DOMException; 

25.54.1.1. Arguments

rule

The complete, parseable text representation of the rule to be added to the stylesheet. For style rules, this includes both the element selector and the style information.

index

The position in the cssRules array at which the rule is to be inserted or appended.

25.54.1.2. Returns

The value of the index argument.

25.54.1.3. Throws

This method throws a DOMException with one of the following code values in the following circumstances:

HIERARCHY_REQUEST_ERR

CSS syntax does not allow the specified rule at the specified location.

INDEX_SIZE_ERR

index is negative or greater then cssRules.length.

NO_MODIFICATION_ALLOWED_ERR

The stylesheet is read-only.

SYNTAX_ERR

The specified rule text contains a syntax error.

25.54.2. Description

This method inserts (or appends) a new CSS rule at the specified index of the cssRules array of this stylesheet. This is a DOM-standard method; see CSSStyleSheet.addRule( ) for an IE-specific alternative.