org.w3c.dom.css

Interface CSSRule

Known Subinterfaces:
CSSCharsetRule, CSSFontFaceRule, CSSImportRule, CSSMediaRule, CSSPageRule, CSSStyleRule, CSSUnknownRule

public interface CSSRule

The CSSRule interface is the abstract base interface for any type of CSS statement. This includes both rule sets and at-rules. An implementation is expected to preserve all rules specified in a CSS style sheet, even if the rule is not recognized by the parser. Unrecognized rules are represented using the CSSUnknownRule interface.

See also the Document Object Model (DOM) Level 2 Style Specification.

Since:
DOM Level 2

Field Summary

static short
CHARSET_RULE
The rule is a CSSCharsetRule.
static short
FONT_FACE_RULE
The rule is a CSSFontFaceRule.
static short
IMPORT_RULE
The rule is a CSSImportRule.
static short
MEDIA_RULE
The rule is a CSSMediaRule.
static short
PAGE_RULE
The rule is a CSSPageRule.
static short
STYLE_RULE
The rule is a CSSStyleRule.
static short
UNKNOWN_RULE
The rule is a CSSUnknownRule.

Method Summary

String
getCssText()
The parsable textual representation of the rule.
CSSRule
getParentRule()
If this rule is contained inside another rule (e.g.
CSSStyleSheet
getParentStyleSheet()
The style sheet that contains this rule.
short
getType()
The type of the rule, as defined above.
void
setCssText(String cssText)
The parsable textual representation of the rule.

Field Details

CHARSET_RULE

public static final short CHARSET_RULE
The rule is a CSSCharsetRule.

Field Value:
2


FONT_FACE_RULE

public static final short FONT_FACE_RULE
The rule is a CSSFontFaceRule.

Field Value:
5


IMPORT_RULE

public static final short IMPORT_RULE
The rule is a CSSImportRule.

Field Value:
3


MEDIA_RULE

public static final short MEDIA_RULE
The rule is a CSSMediaRule.

Field Value:
4


PAGE_RULE

public static final short PAGE_RULE
The rule is a CSSPageRule.

Field Value:
6


STYLE_RULE

public static final short STYLE_RULE
The rule is a CSSStyleRule.

Field Value:
1


UNKNOWN_RULE

public static final short UNKNOWN_RULE
The rule is a CSSUnknownRule.

Field Value:
0

Method Details

getCssText

public String getCssText()
The parsable textual representation of the rule. This reflects the current state of the rule and not its initial value.


getParentRule

public CSSRule getParentRule()
If this rule is contained inside another rule (e.g. a style rule inside an @media block), this is the containing rule. If this rule is not nested inside any other rules, this returns null.


getParentStyleSheet

public CSSStyleSheet getParentStyleSheet()
The style sheet that contains this rule.


getType

public short getType()
The type of the rule, as defined above. The expectation is that binding-specific casting methods can be used to cast down from an instance of the CSSRule interface to the specific derived interface implied by the type.


setCssText

public void setCssText(String cssText)
            throws DOMException
The parsable textual representation of the rule. This reflects the current state of the rule and not its initial value.

Throws:
DOMException - SYNTAX_ERR: Raised if the specified CSS string value has a syntax error and is unparsable.
INVALID_MODIFICATION_ERR: Raised if the specified CSS string value represents a different type of rule than the current one.
HIERARCHY_REQUEST_ERR: Raised if the rule cannot be inserted at this point in the style sheet.
NO_MODIFICATION_ALLOWED_ERR: Raised if the rule is readonly.