Les interfaces DOM niveau 2 StyleSheets sont des interfaces de base servant à représenter tout type de feuille de style. Les modules DOM représentant un langage de feuille de style spécifique sont censés contenir des interfaces qui en sont dérivées.
Les interfaces trouvées dans cette section ne sont pas obligatoires. Une application DOM peut employer la méthode
hasFeature(feature, version) de l'interface DOMImplementation,
respectivement avec les valeurs de paramètre "StyleSheets" et "2.0", pour déterminer si ce module est reconnu, ou non,
par la mise en œuvre. Pour la gestion complète de ce module, une mise en œuvre doit également gérer la fonctionnalité "Core"
définie dans la spécification du DOM niveau 2 Core [DOM niveau 2 Core].
Consulter la section à propos de la conformité →vf
dans la spécification du DOM niveau 2 Core [DOM niveau 2 Core]
pour d'autres renseignements.
Ce jeu d'interfaces représente la notion générique des feuilles de style.
L'interface StyleSheet est l'interface de base abstraite pour tout type de feuille de style.
Elle représente une seule feuille de style associée à un document structuré. En HTML,
l'interface StyleSheet représente soit une feuille de style externe, incluse via l'élément
LINK →vf,
soit l'élément en-ligne STYLE →vf.
En XML, cette interface représente une feuille de style externe, incluse via une
instruction de traitement de feuille de style→vf.
// Introduite dans DOM niveau 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 de type booleanfalse si la feuille de style est appliquée au document, sinon la valeur true.
La modification de cet attribut peut entraîner une réinterprétation
du style du document. Une feuille de style ne s'applique qu'en présence d'une définition de média adéquate
et si l'attribut disabled a la valeur false. Si l'attribut media ne correspond pas à l'agent utilisateur courant,
l'attribut disabled est donc ignoré.href de type DOMString,
en lecture seulenull.
Cf. la définition de l'attribut href →vf
de l'élément LINK de HTML 4.0 et le pseudo-attribut href de
l'instruction de traitement de feuille de style →vf en XML.media de type MediaList,
en lecture seuleownerNode.
Si aucun média n'est indiqué, la valeur MediaList sera vide.
Cf. la définition de l'attribut media →vf
de l'élément LINK en HTML 4.0 et le pseudo-attribut media de
l'instruction de traitement de feuille de style →vf en XML.disabled.ownerNode de type Node,
en lecture seuleLINK,
ou STYLE, correspondant. Pour XML, ce sera l'instruction de traitement de liaison.
Pour les feuilles de style appelées par d'autres feuilles de style, cet attribut a la valeur null.parentStyleSheet de type StyleSheet,
en lecture seulenull.title de type DOMString,
en lecture seuleownerNode.
Cf. la définition de l'attribut title →vf
de l'élément LINK en HTML 4.0 et le pseudo-attribut title de
l'instruction de traitement de feuille de style →vf en XML.type de type DOMString,
en lecture seuleownerNode. Cf. également la
définition de l'attribut type →vf
de l'élément LINK en HTML 4.0 et le pseudo-attribut type de
l'instruction de traitement de feuille de style →vf en XML.L'interface StyleSheetList fournit l'abstraction d'une collection ordonnée de feuilles de style.
Les éléments de l'objet StyleSheetList sont accessibles via un index entier, commençant à "0".
// Introduite dans DOM niveau 2 :
interface StyleSheetList {
readonly attribute unsigned long length;
StyleSheet item(in unsigned long index);
};
length de type unsigned long,
en lecture seuleStyleSheet dans la liste. L'index des
feuilles de style enfants valides s'étend de 0 à length-1 inclus.itemnull.
index de type unsigned long|
La feuille de style à la position indiquée par le paramètre |
L'interface MediaList fournit l'abstraction d'une collection ordonnée de
médias →vf,
sans définition ni restriction quant à la manière dont cette collection est mise en œuvre. Une liste vide équivaut
à une liste contenant la valeur de média "all".
Les éléments de l'objet MediaList sont accessibles via un index entier, commençant à "0".
// Introduite dans DOM niveau 2 :
interface MediaList {
attribute DOMString mediaText;
// soulève une exception DOMException à l'initialisation
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 de type unsigned long,
en lecture seule0 à length-1 inclus.mediaText de type DOMString|
|
SYNTAX_ERR : Soulevée si la valeur de chaîne indiquée a une syntaxe erronée ou n'est pas analysable. NO_MODIFICATION_ALLOWED_ERR : Soulevée si cette liste de médias est en lecture seule. |
appendMediumnewMedium à la fin de la liste.
Si le média newMedium est déjà utilisé, il est d'abord retiré.
newMedium de type DOMString|
|
INVALID_CHARACTER_ERR : Si le média contient des caractères invalides pour le langage de style sous-jacent. NO_MODIFICATION_ALLOWED_ERR : Soulevée si cette liste est en lecture seule. |
deleteMediumoldMedium de la liste.
oldMedium de type DOMString|
|
NO_MODIFICATION_ALLOWED_ERR : Soulevée si cette liste est en lecture seule. NOT_FOUND_ERR : Soulevée si le média |
itemindex.
Si index est supérieur ou égal au nombre de médias de la liste, retourne la valeur null.
index de type unsigned long|
|
Le média à la position indiquée par le paramètre |
L'interface LinkStyle fournit un mécanisme par lequel on peut récupérer une feuille de style depuis le
nœud qui la lie au document. On peut obtenir une interface de l'interface LinkStyle en utilisant les
méthodes prépondérantes particulières de la liaison sur une
instance de nœud de liaison (HTMLLinkElement, HTMLStyleElement ou
ProcessingInstruction dans DOM niveau 2).
// Introduite dans DOM niveau 2 :
interface LinkStyle {
readonly attribute StyleSheet sheet;
};
sheet de type StyleSheet,
en lecture seuleL'interface DocumentStyle fournit un mécanisme par lequel on peut récupérer les feuilles de style incorporées au document.
L'interface DocumentStyle est censée s'obtenir en utilisant les méthodes prépondérantes spécifiques de la liaison
sur une instance de l'interface Document.
// Introduite dans DOM niveau 2 :
interface DocumentStyle {
readonly attribute StyleSheetList styleSheets;
};
styleSheets de type StyleSheetList,
en lecture seuleHTMLDocument de deux façons :
HTMLLinkElement dans
[DOM niveau 2 HTML] et
[HTML4.0]). La feuille de style sous-jacente sera créée
après l'insertion de l'élément dans le document et après le paramétrage des attributs href et type indiquant que l'objet lié
est une feuille de style ;HTMLStyleElement dans
[DOM niveau 2 HTML] et [HTML4.0]).
La feuille de style sous-jacente sera créée après l'insertion de l'élément et après le paramétrage de l'attribut type indiquant
que l'élément correspond à un langage de feuille de style interprété par l'agent utilisateur.