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

Fields

Fields declared in interface org.w3c.dom.css.CSSRule

CHARSET_RULE, FONT_FACE_RULE, IMPORT_RULE, MEDIA_RULE, PAGE_RULE, STYLE_RULE, UNKNOWN_RULE

Methods

Modifier and Type Method Description
String getEncoding()

The encoding information used in this @charset rule.
void setEncoding​(String encoding)

The encoding information used in this @charset rule.

Methods declared in interface org.w3c.dom.css.CSSRule

getCssText, getParentRule, getParentStyleSheet, getType, setCssText

Methods

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.