org.w3c.dom.css

Interface CSSRule

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 shortCHARSET_RULE
The rule is a CSSCharsetRule.
static shortFONT_FACE_RULE
The rule is a CSSFontFaceRule.
static shortIMPORT_RULE
The rule is a CSSImportRule.
static shortMEDIA_RULE
The rule is a CSSMediaRule.
static shortPAGE_RULE
The rule is a CSSPageRule.
static shortSTYLE_RULE
The rule is a CSSStyleRule.
static shortUNKNOWN_RULE
The rule is a CSSUnknownRule.
Method Summary
StringgetCssText()
The parsable textual representation of the rule.
CSSRulegetParentRule()
If this rule is contained inside another rule (e.g. a style rule inside an @media block), this is the containing rule.
CSSStyleSheetgetParentStyleSheet()
The style sheet that contains this rule.
shortgetType()
The type of the rule, as defined above.
voidsetCssText(String cssText)
The parsable textual representation of the rule.

Field Detail

CHARSET_RULE

public static final short CHARSET_RULE
The rule is a CSSCharsetRule.

FONT_FACE_RULE

public static final short FONT_FACE_RULE
The rule is a CSSFontFaceRule.

IMPORT_RULE

public static final short IMPORT_RULE
The rule is a CSSImportRule.

MEDIA_RULE

public static final short MEDIA_RULE
The rule is a CSSMediaRule.

PAGE_RULE

public static final short PAGE_RULE
The rule is a CSSPageRule.

STYLE_RULE

public static final short STYLE_RULE
The rule is a CSSStyleRule.

UNKNOWN_RULE

public static final short UNKNOWN_RULE
The rule is a CSSUnknownRule.

Method Detail

getCssText

public String getCssText()
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.

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)
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.