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.

Since:: 1.4, DOM Level 2

Field Summary

Fields declared in interface CSSRule

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

Modifier and Type	Field	Description
`static final short`	`CHARSET_RULE`	The rule is a `CSSCharsetRule`.
`static final short`	`FONT_FACE_RULE`	The rule is a `CSSFontFaceRule`.
`static final short`	`IMPORT_RULE`	The rule is a `CSSImportRule`.
`static final short`	`MEDIA_RULE`	The rule is a `CSSMediaRule`.
`static final short`	`PAGE_RULE`	The rule is a `CSSPageRule`.
`static final short`	`STYLE_RULE`	The rule is a `CSSStyleRule`.
`static final short`	`UNKNOWN_RULE`	The rule is a `CSSUnknownRule`.

Method Summary

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 CSSRule

getCssText, getParentRule, getParentStyleSheet, getType, setCssText

Modifier and Type	Method	Description
`String`	`getCssText()`	The parsable textual representation of the rule.
`CSSRule`	`getParentRule()`	If this rule is contained inside another rule (e.g. a style rule inside an @media block), this is the containing rule.
`CSSStyleSheet`	`getParentStyleSheet()`	The style sheet that contains this rule.
`short`	`getType()`	The type of the rule, as defined above.
`void`	`setCssText(String cssText)`	The parsable textual representation of the rule.

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.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.