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.
The interfaces found within this section are not mandatory. A
DOM application may use the hasFeature(feature,
version) method of the DOMImplementation
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 [DOM Level 2 Core]. Please refer
to additional information about
conformance in the DOM Level 2 Core specification [DOM Level 2
Core].
This set of interfaces represents the generic notion of style sheets.
The StyleSheet interface is the abstract base
interface for any type of style sheet. It represents a single style
sheet associated with a structured document. In HTML, the
StyleSheet interface represents either an external style sheet,
included via the HTML
LINK element, or an inline
STYLE element. In XML, this interface represents an
external style sheet, included via a style
sheet processing instruction.
// Introduced in DOM Level 2:
interface StyleSheet {
readonly attribute DOMString type;
attribute boolean disabled;
readonly attribute Node ownerNode;
readonly attribute StyleSheet parentStyleSheet;
readonly attribute DOMString href;
readonly attribute DOMString title;
readonly attribute MediaList media;
};
disabled of type
booleanfalse if the style sheet is applied to the
document. true if it is not. Modifying this attribute
may cause a new resolution of style for the document. A stylesheet
only applies if both an appropriate medium definition is present
and the disabled attribute is false. So, if the media doesn't apply
to the current user agent, the disabled attribute is
ignored.href of type
DOMString, readonlynull. See the
href attribute definition for the LINK
element in HTML 4.0, and the href pseudo-attribute for the XML
style sheet processing instruction.media of type MediaList,
readonlyownerNode. If no media has
been specified, the MediaList
will be empty. See the
media attribute definition for the LINK
element in HTML 4.0, and the media pseudo-attribute for the XML
style sheet processing instruction . Modifying the
media list may cause a change to the attribute
disabled.ownerNode of
type Node, readonlyLINK or
STYLE element. For XML, it may be the linking
processing instruction. For style sheets that are included by other
style sheets, the value of this attribute is
null.parentStyleSheet
of type StyleSheet,
readonlynull.title of type
DOMString, readonlyownerNode. See the
title attribute definition for the LINK
element in HTML 4.0, and the title pseudo-attribute for the XML
style sheet processing instruction.type of type
DOMString, readonlyownerNode. Also see the
type attribute definition for the LINK
element in HTML 4.0, and the type pseudo-attribute for the XML style
sheet processing instruction.The StyleSheetList interface provides the
abstraction of an ordered collection of style sheets.
The items in the StyleSheetList are accessible via
an integral index, starting from 0.
// Introduced in DOM Level 2:
interface StyleSheetList {
readonly attribute unsigned long length;
StyleSheet item(in unsigned long index);
};
length of type
unsigned long, readonlyStyleSheets
in the list. The range of valid child stylesheet indices is
0 to length-1 inclusive.itemnull.
index of type
unsigned long|
The style sheet at the |
The MediaList interface provides the abstraction of
an ordered collection of
media, without defining or constraining how this
collection is implemented. An empty list is the same as a list that
contains the medium "all".
The items in the MediaList are accessible via an
integral index, starting from 0.
// Introduced in DOM Level 2:
interface MediaList {
attribute DOMString mediaText;
// raises(DOMException) on setting
readonly attribute unsigned long length;
DOMString item(in unsigned long index);
void deleteMedium(in DOMString oldMedium)
raises(DOMException);
void appendMedium(in DOMString newMedium)
raises(DOMException);
};
length of type
unsigned long, readonly0 to length-1 inclusive.mediaText of type
DOMString|
|
SYNTAX_ERR: Raised if the specified string value has a syntax error and is unparsable. NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is readonly. |
appendMediumnewMedium to the
end of the list. If the newMedium is already used, it
is first removed.
newMedium of type
DOMString|
|
INVALID_CHARACTER_ERR: If the medium contains characters that are invalid in the underlying style language. NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. |
deleteMediumoldMedium from the list.
oldMedium of type
DOMString|
|
NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly. NOT_FOUND_ERR: Raised if |
itemindexth in the list.
If index is greater than or equal to the number of
media in the list, this returns null.
index of type
unsigned long|
|
The medium at the |
The LinkStyle interface provides a mechanism by
which a style sheet can be retrieved from the node responsible for
linking it into a document. An instance of the
LinkStyle interface can be obtained using
binding-specific casting methods on an instance of a linking node
(HTMLLinkElement, HTMLStyleElement or
ProcessingInstruction in DOM Level 2).
// Introduced in DOM Level 2:
interface LinkStyle {
readonly attribute StyleSheet sheet;
};
sheet of type StyleSheet,
readonlyThe DocumentStyle interface provides a mechanism by
which the style sheets embedded in a document can be retrieved. The
expectation is that an instance of the DocumentStyle
interface can be obtained by using binding-specific casting methods
on an instance of the Document interface.
// Introduced in DOM Level 2:
interface DocumentStyle {
readonly attribute StyleSheetList styleSheets;
};
styleSheets
of type StyleSheetList,
readonlyHTMLLinkElement interface in the [DOM Level 2 HTML] and [HTML4.0]). 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.HTMLStyleElement interface in the [DOM Level 2 HTML] and [HTML4.0]). 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.