Module jdk.xml.dom
Package 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:
  1.4, DOM Level 2

- ## Field Summary

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

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

- ## 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 org.w3c.dom.css.CSSRule

  `getCssText, getParentRule, getParentStyleSheet, getType, setCssText`

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