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 | |||||||||||||||
|
|||||||||||||||
Méthodes spécifiques à l´objet | |||||||||||||||
|
|||||||||||||||
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 |