Name
CSSMediaRule.insertRule( ) — insert a new rule into an @media block
Availability
DOM Level 2 CSS
Synopsis
unsigned long insertRule(Stringrule, unsigned longindex) 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
cssRulesarray, or thecssRules.lengthto 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
ruleat the specified position.-
INDEX_SIZE_ERR indexis negative or greater thancssRules.length.-
NO_MODIFICATION_ALLOWED_ERR This
@mediarule and itscssRulesarray are read-only.-
SYNTAX_ERR The specified
rulecontains a syntax error.
Description
This method inserts the specified rule
into the cssRules array at the specified
index.