xdocs/dom/xml/style/definitions/DocumentCSS.xml

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

<interface id="CSS-DocumentCSS" name="DocumentCSS" 
  inherits="stylesheets::DocumentStyle" since="DOM Level 2">
  <descr>
    <p>This interface represents a document with a CSS view.</p>
    <p>
      The <code>getOverrideStyle</code> method provides a mechanism through
      which a DOM author could effect immediate change to the style of an
      element without modifying the explicitly linked style sheets of a
      document or the inline style of elements in the style sheets.  This style
      sheet comes after the author style sheet in the cascade algorithm and is
      called <emph>override style sheet</emph>. The override style sheet takes
      precedence over author style sheets. An "!important" declaration still
      takes precedence over a normal declaration. Override, author, and user
      style sheets all may contain "!important" declarations. User "!important"
      rules take precedence over both override and author "!important" rules,
      and override "!important" rules take precedence over author "!important"
      rules.
    </p>
    <p>
      The expectation is that an instance of the <code>DocumentCSS</code>
      interface can be obtained by using binding-specific casting methods on an
      instance of the <code>Document</code> interface.
    </p>
  </descr>

  <method id="CSS-DocumentCSS-getOverrideStyle" name="getOverrideStyle">
    <descr>
      <p>
	This method is used to retrieve the override style declaration for a
	specified element and a specified pseudo-element.
      </p>
    </descr>
    <parameters>
      <param name="elt" type="Element" attr="in">
	<descr>
	  <p>
	    The element whose style is to be modified.  This parameter cannot
	    be null.
	  </p>
	</descr>
      </param>
      <param name="pseudoElt" type="DOMString" attr="in">
	<descr>
	  <p>
	    The pseudo-element or <code>null</code> if none.
	  </p>
	</descr>
      </param>
    </parameters>
    <returns type="CSSStyleDeclaration">
      <descr>
	<p>
	  The override style declaration.
	</p>
      </descr>
    </returns>
    <raises>
    </raises>
  </method>

</interface>