org.w3c.dom.css
Interface CSSCharsetRule

All Superinterfaces:
CSSRule

public interface CSSCharsetRule
extends CSSRule

The CSSCharsetRule interface represents a @charset rule in a CSS style sheet. The value of the encoding attribute does not affect the encoding of text data in the DOM objects; this encoding is always UTF-16. After a stylesheet is loaded, the value of the encoding attribute is the value found in the @charset rule. If there was no @charset in the original document, then no CSSCharsetRule is created. The value of the encoding attribute may also be used as a hint for the encoding used on serialization of the style sheet.

The value of the @charset rule (and therefore of the CSSCharsetRule) may not correspond to the encoding the document actually came in; character encoding information e.g. in an HTTP header, has priority (see CSS document representation) but this is not reflected in the CSSCharsetRule.

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

Since:
DOM Level 2

Field Summary
 
Fields inherited from interface org.w3c.dom.css.CSSRule
CHARSET_RULE, FONT_FACE_RULE, IMPORT_RULE, MEDIA_RULE, PAGE_RULE, STYLE_RULE, UNKNOWN_RULE
 
Method Summary
 java.lang.String getEncoding()
          The encoding information used in this @charset rule.
 void setEncoding(java.lang.String encoding)
          The encoding information used in this @charset rule.
 
Methods inherited from interface org.w3c.dom.css.CSSRule
getCssText, getParentRule, getParentStyleSheet, getType, setCssText
 

Method Detail

getEncoding

java.lang.String getEncoding()
The encoding information used in this @charset rule.


setEncoding

void setEncoding(java.lang.String encoding)
                 throws DOMException
The encoding information used in this @charset rule.

Throws:
DOMException - SYNTAX_ERR: Raised if the specified encoding value has a syntax error and is unparsable.
NO_MODIFICATION_ALLOWED_ERR: Raised if this encoding rule is readonly.