Name
CSSStyleSheet.insertRule( ) — insert a rule into a style sheet
Availability
DOM Level 2 CSS
Synopsis
unsigned long insertRule(Stringrule
, unsigned longindex
) throws DOMException;
Arguments
-
rule
The complete, parseable text representation of the rule to be added to the style sheet. 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 thencssRules.length
.-
NO_MODIFICATION_ALLOWED_ERR
The style sheet 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 style sheet.
Get JavaScript: The Definitive Guide, Fourth 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.