JavaScript: The Definitive Guide, Fourth Edition

Name

CSSMediaRule.insertRule( ) — insert a new rule into an @media block

Availability

DOM Level 2 CSS

Synopsis

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

Arguments

rule

The complete, parseable CSS string representation of the rule to be added.

index

The position at which the new rule is to be inserted into the cssRules array, or the cssRules.length to append the new rule at the end of the array.

Returns

The value of the index argument.

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 position.

INDEX_SIZE_ERR

index is negative or greater than cssRules.length.

NO_MODIFICATION_ALLOWED_ERR

This @media rule and its cssRules array are read-only.

SYNTAX_ERR

The specified rule contains a syntax error.

Description

This method inserts the specified rule into the cssRules array at the specified index.