CSSStyleDeclaration

Res√ļmen

CSSStyleDeclaration representa una colección CSS de pares propiedad-valor. Se utiliza en unas cuantas APIs:

Atributos

CSSStyleDeclaration.cssText
Representación textual del bloque de declaración. Estableciendo este atributo cambia el estilo.
CSSStyleDeclaration.length
El n√ļmero de propiedades. Ver el m√©todo del elemento inferior.
CSSStyleDeclaration.parentRule
El contenedor CssRule.

Métodos

CSSStyleDeclaration.getPropertyPriority()
Retorna la prioridad opcional, "important". Ejemplo: priString= styleObj.getPropertyPriority('color')
CSSStyleDeclaration.getPropertyValue()
Retorna el valor de la propiedad. Ejemplo: valString= styleObj.getPropertyValue('color')
CSSStyleDeclaration.item()
Retorna un nombre de propiedad. Ejemplo: nameString= styleObj.item(0) Alternative: nameString= styleObj[0]
CSSStyleDeclaration.removeProperty()
Retorna el valor borrado. Ejemplo: valString= styleObj.removeProperty('color')
CSSStyleDeclaration.setProperty()
Sin retorno. Ejemplo: styleObj.setProperty('color', 'red', 'important')
CSSStyleDeclaration.getPropertyCSSValue()
Solo soportado a través de getComputedStyle. Devuelve un ROCSSPrimitiveValue en Firefox (CSSPrimitiveValue, en otros, los cuales implementan CSSValue), o nulo para Propiedades taquigráficas. Ejemplo: cssString= window.getComputedStyle(elemento, null).getPropertyCSSValue('color').cssText;
Observación: Gecko 1.9 devuelve null a menos que se utilice getComputedStyle().
Observaci√≥n: Este m√©todo puede estar desaconsejado por el W3C , y no est√° presente en el √ļltimo borrador CSSOM. No est√° soportado por IE e incluso aunque la funci√≥n existe en Opera, llamarla lanza una excepci√≥n DOMException NOT_SUPPORTED_ERR.

Ejemplo

var styleObj= document.styleSheets[0].cssRules[0].style;
alert(styleObj.cssText);
for (var i = styleObj.length-1; i >= 0; i--) {
   var nameString = styleObj[i];
   styleObj.removeProperty(nameString);
}
alert(styleObj.cssText);

Notas

El bloque de declaración es esa parte de la regla de estilo que aparece dentro de las llaves ({}) y que actualmente proporciona las definiciones de estilo (para el selector, la parte que precede a las llaves).

Ver también

Especificación