151 lines
5.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Date$ $Revision$ -->
<!--
*************************************************************************
* BEGINNING OF LEVEL TWO STYLE SHEETS *
*************************************************************************
-->
<div1 id="StyleSheets">
<head>Document Object Model Style Sheets</head>
<orglist role="editors">
<member>
<name>Chris Wilson</name>
<affiliation>Microsoft Corp.</affiliation>
</member>
<member>
<name>Philippe Le H&eacute;garet</name>
<affiliation>W3C</affiliation>
</member>
<member>
<name>Vidur Apparao</name>
<affiliation>Netscape Communications Corp.</affiliation>
</member>
</orglist>
<?GENERATE-MINI-TOC?>
<!--
******************************************************
| INTRODUCTION |
******************************************************
-->
<div2 id="StyleSheets-overview">
<head>Introduction</head>
<p>
The DOM Level 2 Style Sheet interfaces are base interfaces used to
represent any type of style sheet. The expectation is that DOM modules
that represent a specific style sheet language may contain interfaces
that derive from these interfaces.
</p>
<p>
The interfaces found within this section are not mandatory. A DOM
application may use the <code>hasFeature(feature, version)</code> method
of the <code>DOMImplementation</code> interface with parameter values
"StyleSheets" and "2.0" (respectively) to determine whether or not this module
is supported by the implementation. In order to fully support this
module, an implementation must also support the "Core" feature defined
defined in the DOM 2 Core specification <bibref
ref="DOMCore"/>. Please refer to additional information about <xspecref
href='&core.latest.url;/introduction.html#ID-Conformance'>conformance</xspecref>
in the DOM Level 2 Core specification <bibref ref="DOMCore"/>.
</p>
</div2>
<div2 id="StyleSheets-fundamental">
<head>Style Sheet Interfaces</head>
<p>This set of interfaces represents the generic notion of style sheets.</p>
<definitions>
&stylesheets-stylesheet;
&stylesheets-stylesheetlist;
&stylesheets-medialist;
</definitions>
</div2>
<div2 id="StyleSheets-extensions">
<head>Document Extensions</head>
<definitions>
&stylesheets-linkstyle;
&stylesheets-documentstyle;
</definitions>
</div2>
<div2 id="StyleSheets-Association">
<head>Association between a style sheet and a document.</head>
<glist>
<gitem>
<label>HTML and Style Sheet Creation</label>
<def>
<p>
A style sheet can be associated with an HTMLDocument in one of two
ways:
</p>
<ulist>
<item>
<p>
By creating a new LINK HTML element (see the
<code>HTMLLinkElement</code> interface in the <bibref
ref="DOMHTML-inf"/> and <bibref ref="HTML40"/>). The underlying
style sheet will be created after the element is inserted into
the document and both the href and the type attribute have been
set in a way indicating that the linked object is a style
sheet.
</p>
</item>
<item>
<p>
By creating a new STYLE HTML element (see the
<code>HTMLStyleElement</code> interface in the <bibref
ref="DOMHTML-inf"/> and <bibref ref="HTML40"/>). The underlying style
sheet will be created after the element is inserted into the
document and the type attribute is set in a way indicating that
the element corresponds to a style sheet language interpreted
by the user agent.
</p>
</item>
</ulist>
</def>
</gitem>
<gitem>
<label>
HTML and Style Sheet Removal
</label>
<def>
<p>
Removing a LINK HTML element or a STYLE HTML element removes the
underlying style sheet from the style sheet collection associated
with a document. Specifically, the removed style sheet is no longer
applied to the presentation of the document.
</p>
</def>
</gitem>
<gitem>
<label>XML and Style Sheet Creation</label>
<def>
<p>
A new style sheet can be created and associated with an XML
document by creating a processing instruction with the target
'xml-stylesheet' <bibref ref="XML-StyleSheet"/> and inserting it
into the document.
</p>
</def>
</gitem>
<gitem>
<label>XML and Style Sheet Removal</label>
<def>
<p>
Removing a processing instruction with a target of 'xml-stylesheet'
<bibref ref="XML-StyleSheet"/> removes the underlying style sheet
from the style sheet collection associated with a document.
Specifically, the removed style sheet is no longer applied to the
presentation of the document.
</p>
</def>
</gitem>
</glist>
</div2>
</div1>
<!--
*************************************************************************
* END OF LEVEL TWO STYLE SHEETS *
*************************************************************************
-->