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.
A DOM application can use the hasFeature method of the
DOMImplementation interface to determine whether the
StyleSheets interfaces are supported or not. The feature string for the
fundamental interfaces listed in this section is "StyleSheets" and the
version is "2.0".
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, readonly
The 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, readonly
HTMLLinkElement 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.