CKTIS / JavaScript
CSSStyleDeclaration: randdiktes en transform
Stel de randdikte per zijde en een CSS-transformatie in met `element.style`. Maak onderscheid tussen inline declaraties en de waarden die de browser na toepassing van de cascade bepaalt.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const style = element.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.borderTopWidth = "3px";
style.borderRightWidth = "4px";
style.borderBottomWidth = "6px";
style.borderLeftWidth = "8px";
style.transform = "translateX(12px)";
style.setProperty("border-top-width", "3px");
style.getPropertyValue("border-top-width");
getComputedStyle(element).borderTopWidth;element.style geeft toegang tot een object dat wijzigingen direct weerspiegelt. Via de eigenschappen ervan lees en wijzig je declaraties in het style-attribuut van een element. In het huidige CSSOM is het een CSSStyleProperties-object, dat erft van CSSStyleDeclaration; oudere documentatie noemt mogelijk de basisinterface. Deze browser-API is geen onderdeel van ECMAScript 2024.
borderWidth is de CSS-verkorting border-width. Eén waarde geldt voor alle zijden; twee gelden voor boven/onder en rechts/links; drie voor boven, rechts/links en onder; vier voor boven, rechts, onder en links. Gebruik borderTopWidth, borderRightWidth, borderBottomWidth of borderLeftWidth voor één zijde. Geef CSS-waarden op als strings, zoals "3px", "0" of "thin"; het getal 3 betekent niet drie pixels. Alleen een dikte instellen maakt de rand niet zichtbaar: bij none of hidden komt de dikte uit op nul. Stel bijvoorbeeld borderStyle = "solid" in.
style.transform = "translateX(12px)" vervangt de hele inline declaratie transform. Als het element getransformeerd kan worden en deze declaratie wint in de cascade, wordt het element 12 CSS-pixels naar rechts weergegeven zonder dat zijn plek in de normale lay-out verandert. Een toepasselijke !important-declaratie in een stylesheet van de auteur kan voorrang krijgen op de inline declaratie. Zet meerdere functies in één string met spaties ertussen; de volgorde maakt uit.
setProperty("border-top-width", "3px") en getPropertyValue("border-top-width") gebruiken de CSS-naam met koppeltekens, anders dan style.borderTopWidth. Zonder inline declaratie voor die zijde geeft style.borderTopWidth de lege string "" terug. Gebruik getComputedStyle(element) voor de waarde die na de cascade geldt voor een element in het document; het resultaat wordt bijgewerkt, maar is alleen-lezen.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Border widths and transform</title>
</head>
<body>
<script>
{
const box = document.createElement("div");
const style = box.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.setProperty("border-top-width", "3px");
style.transform = "translateX(12px)";
console.log([
style.borderTopWidth,
style.borderRightWidth,
style.borderBottomWidth,
style.borderLeftWidth,
].join(" "));
console.log(style.getPropertyValue("border-top-width"));
console.log(style.transform);
}
</script>
</body>
</html>Resultaat
3px 4px 6px 8px 3px translateX(12px)
Sla het voorbeeld op als HTML-bestand, open het in een browser en controleer de browserconsole. De verkorting stelt vier diktes in; `setProperty()` verandert alleen de bovenste. Het element wordt niet aan het document toegevoegd, dus de uitvoer toont inline declaraties, geen gerenderd resultaat.
Gerelateerde lessen
- JavaScript · Les 35 · Gemiddeld · Versie: 3