<?xml version="1.0" encoding="utf-8"?>
<!-- CSSCharsetRule interface -->

<interface id="CSS-CSSCharsetRule" name="CSSCharsetRule"
  inherits="CSSRule" since="DOM Level 2">
  <descr>
    <p>
      The <code>CSSCharsetRule</code> interface represents a <xspecref
      href="&css2;/syndata.html#x66">@charset
      rule</xspecref> in a CSS style sheet. The value of the
      <code>encoding</code> 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 <code>encoding</code> attribute is
      the value found in the <code>@charset</code> rule. If there was no
      <code>@charset</code> in the original document, then no
      <code>CSSCharsetRule</code> is created.  The value of the
      <code>encoding</code> attribute may also be used as a hint for the
      encoding used on serialization of the style sheet.
    </p>
    <p>
      The value of the <xspecref href="&css2;/syndata.html#x66">@charset
      rule</xspecref> (and therefore of the <code>CSSCharsetRule</code>) may
      not correspond to the encoding the document actually came in; character
      encoding information e.g. in an HTTP header, has priority (see <xspecref
      href="&css2;/syndata.html#x66">CSS document representation</xspecref>) but this is
      not reflected in the <code>CSSCharsetRule</code>.
    </p>
  </descr>
  
  <attribute type="DOMString" readonly="no" name="encoding" id="CSS-CSSCharsetRule-encoding">
    <descr>
      <p>
	The encoding information used in this <code>@charset</code> rule.
      </p>
    </descr>
     <setraises>
      <exception name="DOMException">
        <descr>
          <p>SYNTAX_ERR: Raised if the specified encoding value has a syntax
	    error and is unparsable.</p>
	  <p>NO_MODIFICATION_ALLOWED_ERR: Raised if this encoding rule is
	    readonly.</p>
        </descr>
      </exception>
     </setraises>
  </attribute>
  
</interface>
