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:
1.4, DOM Level 2

  • Method Details

    • getEncoding

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

    • setEncoding

      void setEncoding(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.