WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement.style — Inline-Stile eines Elements

HTMLElement.style stellt ein veränderbares CSS-Deklarationsobjekt für Inline-Stile bereit, nicht das Ergebnis der Kaskade.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.style.propertyName = "value";
element.style.setProperty("property-name", "value", "important");
element.style.removeProperty("property-name");

HTMLElement.style gibt immer dasselbe Inline-Deklarationsobjekt zurück, das mit dem style-Attribut verknüpft ist. Die Spezifikation definiert es als CSSStyleProperties, das von CSSStyleDeclaration erbt.

Verwende camelCase-Namen wie marginTop oder setProperty() mit CSS-Namen. Für benutzerdefinierte Eigenschaften verwendest du setProperty(). Gib die Priorität important als drittes Argument an, nicht als Teil des Werts.

removeProperty() entfernt eine Deklaration; ein nicht vorhandener Wert wird als "" ausgelesen. style stellt nicht das Ergebnis der Kaskade bereit – verwende dafür getComputedStyle(). Wird Text element.style zugewiesen, wird er an cssText weitergereicht und ersetzt den gesamten Inline-Block statt nur einer Deklaration.

Beispiele

const element = document.createElement("div");
const style = element.style;
style.marginTop = "12px";
style.setProperty("--gap", "8px");
console.log(style === element.style);
console.log(style.marginTop);
console.log(style.getPropertyValue("--gap"));
style.removeProperty("margin-top");
console.log(JSON.stringify(style.marginTop));

Ergebnis

true
12px
8px
""

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen