KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

CSSStyleDeclaration.setProperty — CSS-declaraties instellen

Stel CSS-declaraties in met setProperty() door een eigenschapsnaam, een waarde en een optionele prioriteit mee te geven.

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

style.setProperty(property, value, priority = "")

CSSStyleDeclaration.setProperty wijzigt een declaratie, bijvoorbeeld in element.style. Dit is een browser-API, geen ECMAScript-functie. Gebruik CSS-namen zoals margin-top, niet marginTop; namen van aangepaste eigenschappen zoals --accent zijn hoofdlettergevoelig.

priority accepteert "" of "important", waarbij hoofdletters en kleine letters niet van belang zijn. Zet !important niet in value. In een beschrijfbaar declaratieblok verwijdert een lege waarde de declaratie voordat de prioriteit wordt gecontroleerd, ook als die ongeldig is. Bij een niet-lege waarde verandert er niets als de prioriteit ongeldig is.

Niet-ondersteunde eigenschappen en ongeldige waarden veroorzaken geen wijziging. Een alleen-lezen blok veroorzaakt NoModificationAllowedError. De methode retourneert undefined.

Voorbeelden

const style = document.createElement("div").style;
style.setProperty("margin-top", "12px", "important");
console.log(style.getPropertyValue("margin-top"));
console.log(style.getPropertyPriority("margin-top"));
style.setProperty("margin-top", "");
console.log(JSON.stringify(style.getPropertyValue("margin-top")));

Resultaat

12px
important
""

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