insertRule
(method
)
Owning interface and usage:
CSSStyleSheet.
insertRule(
rule,
index)
Member of these other interfaces:
none
Description:
Used to insert a new rule into the style sheet. The new rule now becomes part of the cascade.
Parameters:
| DOMString rule |
- |
The parsable text representing the rule. 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.
|
| unsigned index |
- |
The index within the style sheet's rule list of the rule before which to insert the specified rule. If the specified index
is equal to the length of the style sheet's rule collection, the rule will be added to the end of the style sheet.
|
Returns:
unsigned long -
The index within the style sheet's rule collection of the newly inserted rule.
Exceptions:
- DOMException HIERARCHY_REQUEST_ERR
-
Raised if the rule cannot be inserted at the specified index e.g. if an @import rule is inserted after a standard rule set or other at-rule.
- DOMException INDEX_SIZE_ERR
-
Raised if the specified index is not a valid insertion point.
- DOMException NO_MODIFICATION_ALLOWED_ERR
-
Raised if this style sheet is readonly.
- DOMException SYNTAX_ERR
-
Raised if the specified rule has a syntax error and is unparsable.