org.w3c.dom.css
Interface CSSCharsetRule

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

Fields inherited from class 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

public java.lang.String getEncoding()

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.

setEncoding

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