KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLElement.style — inline stijlen van een element

HTMLElement.style geeft toegang tot een aanpasbaar object met inline CSS-declaraties, niet tot het resultaat van de cascade.

Versie: 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 retourneert altijd hetzelfde object met inline declaraties dat aan het style-attribuut is gekoppeld. De specificatie definieert dit als CSSStyleProperties, dat overerft van CSSStyleDeclaration.

Gebruik camelCase-namen zoals marginTop, of gebruik setProperty() met CSS-namen. Gebruik voor aangepaste eigenschappen setProperty(). Geef de prioriteit important op als derde argument, niet als onderdeel van de waarde.

removeProperty() verwijdert een declaratie; een ontbrekende waarde wordt gelezen als "". style geeft niet het resultaat van de cascade weer—gebruik daarvoor getComputedStyle(). Als je tekst aan element.style toewijst, wordt deze doorgegeven aan cssText en wordt het volledige inline blok vervangen, niet slechts één declaratie.

Voorbeelden

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));

Resultaat

true
12px
8px
""

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen