styleSheetNN 6 IE 4 DOM 2

L'objet styleSheet représente une feuille de style créée comme élément style ou importée par le biais d'un élément link ou d'une instruction @import d'un élément style. Cet objet diffère de l'objet style qui représente uniquement l'élément HTML style et ses attributs. La collection styleSheets[] contient zéro, un ou plusieurs objets styleSheet. La propriété disabled partagée est disponible dans tous les navigateurs qui la prennent en charge et facilitent l´activation et la désactivation de feuilles de style entières avec de simples affectations booléennes.

 
Référence de modèle d'objet
 
[window.]document.styleSheets[i]
 
Propriétés spécifiques à l´objet
 
cssRules[]cssTexthrefimports[]media
ownerNodeownerRuleowningElementpages[]parentStyleSheet
readOnlyrules[]titletype
 
Méthodes spécifiques à l´objet
 
addImport()addRule()deleteRule()insertRule()removeRule()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

cssRules[]NN 6 IE 5(Mac) DOM 2

Lecture seule

Renvoie une collection d´objets cssRule imbriqués dans l´objet @styleSheet courant. L´équivalent IE est la propriété rules. Reportez-vous à l´objet cssRules dans ce chapitre pour une description de la propriété et des méthodes de cet objet de collection; reportez-vous à l´objet cssRule précédemment dans ce chapitre pour une description des éléments individuels de cette collection.

 
Exemple
 
var allCSSRules = document.styleSheets[0].cssRules;
 
Valeur

Référence à un objet de collection CSSRules.

 
Par défaut

Tableau de longueur zéro.

cssTextNN s.o. IE 5 DOM s.o.

Lecture/écriture

Contient le texte entier (sous forme de chaîne) de toutes les règles définies dans la feuille de style. C´est utile essentiellement si vous voulez remplacer tout l´ensemble de règles par un nouvel ensemble. Pour agir sur le texte d´une règle individuelle dans IE, accédez à la propriété cssText d´un objet rule (par le biais de la propriété rules[i].cssText de l´objet styleSheet); ou, dans Netscape 6, vous pouvez utiliser la propriété cssRules[i].cssText.

 
Exemple
 
var allCSSText = document.styleSheets[0].cssText;
 
Valeur

Chaîne.

 
Par défaut

Une chaîne vide.

hrefNN 6 IE 4 DOM 2

Lecture/écriture

L´URL spécifiée par l´attribut href d´un élément link (lorsque le lien est utilisé pour importer une feuille de style). Cette valeur est en lecture/écriture dans IE pour Windows, mais en lecture seule dans Netscape 6 et IE pour Mac.

 
Exemple
 
document.styleSheets[1].href = "css/altStyles.css";
 
Valeur

Chaîne d'une adresse URL complète ou relative.

 
Par défaut

Aucune.

imports[]NN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie une collection (tableau) d´objets styleSheet importés dans un objet styleSheet explicite avec la règle @import. Reportez-vous à l´objet de collection imports précédemment dans ce chapitre pour de plus amples détails. Pour Netscape 6, vous devez passer en revue tous les objets cssRule d´un objet styleSheet pour trouver ceux ayant des valeurs de propriété type égales à 3 (identique à la constante IMPORT_RULE de l´objet cssRule).

 
Exemple
 
var allImportRules = document.styleSheets[0].imports;
 
Valeur

Référence à un objet de collection import.

 
Par défaut

Tableau de longueur zéro.

mediaNN 6 IE 4 DOM 2

Lecture/écriture

Définit le périphérique de sortie prévu pour le contenu indiqué par la feuille de style (reflétant l´attribut media des éléments link et style. La propriété media sera particulièrement utile le jour où les navigateurs seront capables d'adapter le contenu en fonction du type de périphérique (ordinateur de poche, synthétiseur vocal, téléviseur, etc.) Cette propriété n'est pas disponible dans Internet Explorer 4 pour Macintosh.

 
Exemple
 
if (document.styleSheets[2].media == "print") {
    // process for print output
}
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): all | print | screen.

 
Par défaut

all

ownerNodeNN 6 IE s.o DOM 2

Lecture seule

Renvoie une référence à un noeud d´arborescence de documents qui comprend l´objet styleSheet. Ce noeud est un élément style ou link, selon la façon dont la feuille de style est définie dans le document. L´équivalent IE (Windows et Mac) est la propriété owningElement. IE pour Macintosh fournit une propriété owningNode supplémentaire, ce qui est très probablement une implémentation erronée de la propriété ownerNode du DOM W3C.

 
Exemple
 
var mama = document.styleSheets[2].ownerNode;
 
Valeur

Référence d´objet

 
Par défaut

Aucune.

ownerRuleNN 6 IE s.o DOM 2

Lecture seule

Pour un objet styleSheet importé dans un document par le biais d´une règle @import, renvoie une référence à cet objet de règle @import (un objet CSSImportRule du DOM W3C). L´objet cssRule décrit précédemment dans ce chapitre fournit les propriétés et les méthodes qui s´appliquent à l´objet CSSImportRule. Pour les autres types de feuille de style, la propriété renvoie null.

 
Exemple
 
var hostRule = document.styleSheets[2].ownerRule;
 
Valeur

Référence objet ou null.

 
Par défaut

null

owningElementNN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie une référence à l'objet élément style ou link, qui définit l'objet styleSheet courant. Chaque document maintient une collection de feuilles de style créées avec les éléments style et link. Dans Netscape 6, la propriété comparable est ownerNode.

 
Exemple
 
var firstStyleID = document.styleSheets[0].owningElement.id;
 
Valeur

Référence de l'objet élément.

 
Par défaut

Aucune.

pages[]NN s.o. IE 5,5 (Win) DOM s.o.

Lecture seule

Renvoie une collection (tableau d´objets page (règles @page) imbriqués dans un objet styleSheet. Pour Netscape 6, vous devez passer en revue tous les objets cssRule d´un objet styleSheet pour trouver ceux ayant des valeurs de propriété type égales à 6 (identique à la constante PAGE_RULE de l´objet cssRule). Voir l'objet page.

 
Exemple
 
var allPageRules = document.styleSheets[0].pages;
 
Valeur

Référence à un objet de collection pages.

 
Par défaut

Tableau de longueur zéro.

parentStyleSheetNN 6 IE 4 DOM 2

Lecture seule

Pour un objet styleSheet généré par inclusion avec une règle @page, la propriété parentStyleSheet renvoie une référence à l´objet styleSheet (créé comme élément link ou style) qui a importé la feuille de style courante. Pour une feuille de style non importée, la propriété renvoie null.

 
Exemple
 
var myMaker = document.styleSheets[0].parentStyleSheet;
 
Valeur

Référence à un objet styleSheet.

 
Par défaut

null

readOnlyNN s.o. IE 4 DOM s.o.

Lecture seule

Indique si la feuille de style peut être modifiée sous contrôle d'un script. Les feuilles de style importées par le biais d'un élément link ou d'une règle @import ne peuvent pas être modifiées; elles renvoient donc une valeur true.

 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

rules[]NN s.o. IE 4 DOM s.o.

Lecture seule

Renvoie une collection d´objets rule imbriqués dans l´objet styleSheet courant. L´équivalent dans le DOM W3C (implémenté dans Netscape 6 et IE 5 pour Mac) est la propriété cssRules. Reportez-vous à l´objet cssRules dans ce chapitre pour une description de la propriété et des méthodes de cet objet de collection; reportez-vous à l´objet cssRule précédemment dans ce chapitre pour une description des éléments individuels de cette collection.

 
Exemple
 
var allrules = document.styleSheets[0].rules;
 
Valeur

Référence à un objet de collection rules.

 
Par défaut

Tableau de longueur zéro.

titleNN 6 IE 4 DOM 2

Lecture/écriture

Présente l´attribut title de l´élément style ou link auquel appartient l´objet styleSheet courant. Puisque l´attribut n´affecte pas les éléments de l´interface utilisateur (les éléments ne sont pas affichés et les info-bulles ne sont donc pas affichées non plus), il est disponible pour transmettre d´autres informations de chaîne à l´objet styleSheet sous contrôle de script.

 
Exemple
 
if (document.styleSheets[2].title == "corpStyleWindows") {
    // process for the designated style
}
 
Valeur

Valeur de chaîne.

 
Par défaut

Une chaîne vide.

typeNN 6 IE 4 DOM 2

Lecture seule

Renvoie le type MIME de la feuille de style spécifié par l'attribut type de l'élément style ou link.

 
Exemple
 
if (document.styleSheets[0].type == "text/css") {
    ...
}
 
Valeur

Chaîne (text/css pour les feuilles de style CSS typiques).

 
Par défaut

Aucune.

addImport()NN s.o. IE 4 DOM s.o.

addImport(adresse_url, [index])

Ajoute une spécification de feuille de style externe à un objet styleSheet.

 
Paramètres
 
  • Adresse URL complète ou relative d'un fichier de feuille de style (.css).
  • Nombre entier facultatif indiquant l'emplacement que devrait occuper le nouvel élément dans la collection.
 
Valeur renvoyée

Nombre entier désignant la position d'index de la feuille de style ajoutée dans la collection styleSheets[], (si vous n'entrez pas de deuxième paramètre et laissez le navigateur trouver la position de fin).

addRule()NN s.o. IE 4 DOM s.o.

addRule("selector", "style"[, index])

Ajoute une nouvelle règle de feuille de style. Cette méthode permet d'ajouter, par script, une règle à un objet styleSheet existant:

document.styleSheets[1].addRule("p b","color:red");
 

Vous pouvez dupliquer un sélecteur existant dans l'objet styleSheet et donc annuler une règle existante pour ce sélecteur. La seule chose que vous ne puissiez faire, c'est convertir une règle de style normale en règle de style qui crée un élément positionnable (ou vice versa). La nouvelle règle est régie par les mêmes règles en cascade que toutes les règles de feuille de style (notamment en ce qui concerne la position du code source de la règle parmi d'autres règles ayant le même sélecteur). Par conséquent, une nouvelle règle d'objet styleSheet ne peut pas se substituer à un style défini dans la propriété style d´un élément.

 
Paramètres
 
  • Sélecteur d'une règle de style sous forme de chaîne.
  • Une ou plusieurs paires attribute:value de style. S'il y a plusieurs paires de valeurs, elles sont séparées par des points-virgules, comme dans la définition normale de la feuille de style.
  • Nombre entier facultatif indiquant l'emplacement que devrait occuper le nouvel élément dans la collection.
 
Valeur renvoyée

Les anciennes versions de IE ne renvoyaient pas de valeur. Plus récemment, IE pour Windows renvoie -1 et IE pour Macintosh renvoie null. Dans le futur, il est possible que la valeur renvoyée devienne le nombre entier de l´emplacement d´index de la nouvelle règle.

deleteRule()NN 6 IE 5(Mac) DOM 2

deleteRule(index)

Supprime une règle de l´objet styleSheet. La valeur de paramètre d´index sous forme de nombre entier pointe sur l´élément à base zéro à supprimer dans le tableau cssRules. Remarque: IE 5 pour Macintosh implémente la méthode removeRule() de Microsoft et la méthode deleteRule() du DOM W3C pour la même opération.

 
Paramètres
 
  • Nombre entier à base zéro indiquant la règle de la collection cssRules à supprimer.
 
Valeur renvoyée

Aucune.

insertRule()NN 6 IE 5(Mac) DOM 2

insertRule("ruleText", index)

Ajoute une nouvelle règle de feuille de style. Cette méthode permet d'ajouter, par script, une règle à un objet styleSheet du DOM W3C existant:

document.styleSheets[1].insertRule("p b {color:red}", 0);
 

Vous pouvez dupliquer un sélecteur existant dans l'objet styleSheet et donc annuler une règle existante pour ce sélecteur. La seule chose que vous ne puissiez faire, c'est convertir une règle de style normale en règle de style qui crée un élément positionnable (ou vice versa). La nouvelle règle est régie par les mêmes règles en cascade que toutes les règles de feuille de style (notamment en ce qui concerne la position du code source de la règle parmi d'autres règles ayant le même sélecteur). Par conséquent, une nouvelle règle d'objet styleSheet ne peut pas se substituer à un style défini dans la propriété style d´un élément. Remarque: IE 5 pour Macintosh implémente la méthode insertRule() du DOM W3C et la méthode addRule() de Microsoft pour accomplir la même chose.

 
Paramètres
 
  • Tout le sélecteur de règles de style sous forme de chaîne dans exactement le même format qu´affecté dans un élément de style: selector {attribute:value; attribute:value;...}.
  • Nombre entier à base zéro indiquant l'emplacement que devrait occuper la nouvelle règle dans la collection cssRules.
 
Valeur renvoyée

Nombre entier de l´emplacement d´index de la nouvelle règle.

removeRule()NN s.o. IE 4 DOM s.o.

removeRule(index)

Supprime une règle de l´objet styleSheet. La valeur de paramètre d´index sous forme de nombre entier pointe sur l´élément à base zéro à supprimer dans le tableau rules.

 
Paramètres
 
  • Nombre entier à base zéro indiquant la règle de la collection rules à supprimer.
 
Valeur renvoyée

Aucune.

disabledNN 6 IE 4 DOM 1

Lecture/écriture

Détermine si l'élément est disponible pour une action interactive de l'utilisateur. S'il est défini sur la valeur true , l'utilisateur ne peut pas activer ni modifier cet élément, qui apparaît généralement en grisé sur cette page. Cette propriété est disponible pour tous les objets éléments dans IE 5.5 pour Windows et versions ultérieures. Pour IE 4 et IE 5, elle ne s'applique qu'aux contrôles de formulaire, alors que Netscape 6 et versions ultérieures reconnaissent cette propriété pour les contrôles de formulaire et l'objet élément style . La paire désactivée nom  /  valeur d'un contrôle de formulaire n'est pas transmise avec le formulaire.

 
Exemple
 
document.getElementById("myButton").disabled = true;
 
Valeur

Valeur booléenne: true | false .

 
Par défaut

false