addRule Method

Creates a new rule for a style sheet.

Syntax

plNewIndex = styleSheet.addRule(sSelector, sStyle [, iIndex])

Parameters

sSelector Required. String that specifies the selector for the new rule. Single contextual selectors are valid. For example, "div?A HREF="../objects/p.html">p?A HREF="../objects/b.html">b" is a valid contextual selector.
sStyle Required. String that specifies the style assignments for this style rule. This style takes the same form as an inline style specification. For example, "color:blue" is a valid style parameter.
iIndex Optional. Integer that specifies the zero-based position in the rules collection where the new style rule should be placed.
-1 Default. The rule is added to the end of the collection.

Return Value

Reserved. Always returns -1.

Remarks

You can apply rules to a disabled styleSheet, but they do not apply to the document until you enable the styleSheet.

Example

This example uses the addRule method to add a rule that sets all bold text appearing in a DIV to the color blue.
<STYLE>
</STYLE>
<DIV>
Internet Explorer makes <B>HTML</B> dynamic.
</DIV>
<SCRIPT>
var new_rule;
new_rule = document.styleSheets[0].addRule("DIV B", "color:blue", 0);
</SCRIPT>

Standards Information

There is no public standard that applies to this method.

Applies To

styleSheet