styleSheet | NN 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[] | cssText | href | imports[] | media
ownerNode | ownerRule | owningElement | pages[] | parentStyleSheet
readOnly | rules[] | title | type |
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.

cssText | NN 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.

href | NN 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.

media | NN 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

ownerNode | NN 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.

ownerRule | NN 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

owningElement | NN 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.

parentStyleSheet | NN 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

readOnly | NN 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.

title | NN 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.

type | NN 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.

disabled | NN 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