Name

CSSStyleSheet.insertRule( ): insert a rule into a stylesheet — DOM Level 2 CSS:

Synopsis

unsigned long insertRule(Stringrule,
                         unsigned long index)
    throws DOMException;

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.

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

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.

Get JavaScript: The Definitive Guide, 5th Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial