CSSStyleDeclaration
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
CSSStyleDeclaration
représente une collection de paires propriété/valeur CSS. Elle est utilisée dans quelques API :
HTMLElement.style
- pour manipuler le style d'un seul élément (<elem style="...">) ;- L'API
CSSStyleSheet
. Par exemple,document.styleSheets[0].cssRules[0].style
renvoie un objetCSSStyleDeclaration
décrivant la première règle CSS dans la première feuille de style du document. CSSStyleDeclaration
est également une interface en lecture seule pour le résultat de window.getComputedStyle().
Attributs
CSSStyleDeclaration.cssText
-
Représentation textuelle du bloc de déclaration. La définition de cet attribut modifie le style.
CSSStyleDeclaration.length
Lecture seule-
Le nombre de propriétés. Voir la méthode
item()
ci-dessous. CSSStyleDeclaration.parentRule
Lecture seule-
Le contenant
CSSRule
.
Méthodes
CSSStyleDeclaration.getPropertyPriority()
-
Retourne la priorité facultative "important".
CSSStyleDeclaration.getPropertyValue()
-
Retourne la valeur de la propriété avec un nom de propriété.
CSSStyleDeclaration.item()
-
Retourne un nom de propriété.
CSSStyleDeclaration.removeProperty()
-
Supprime une propriété du bloc de déclaration CSS.
CSSStyleDeclaration.setProperty()
-
Modifie une propriété CSS existante ou crée une nouvelle propriété CSS dans le bloc de déclaration.
CSSStyleDeclaration.getPropertyCSSValue()
Obsolète-
Uniquement supporté via getComputedStyle dans Firefox. Retourne la valeur de la propriété en tant que
CSSPrimitiveValue
ounull
pour les propriétés raccourcies.
Exemple
var objStyle = document.styleSheets[0].cssRules[0].style;
console.log(objStyle.cssText);
for (var i = objStyle.length; i--; ) {
var chaineNom = objStyle[i];
objStyle.removeProperty(chaineNom);
}
console.log(objStyle.cssText);
Notes
Le bloc de déclaration est la partie de la règle de mise en forme qui apparaît dans les accolades et qui fournit les définitions de mise en forme (pour le sélecteur, la partie qui précède les accolades).
Spécifications
Specification |
---|
CSS Object Model (CSSOM) # the-cssstyledeclaration-interface |