CKTIS / JavaScript
CSSStyleDeclaration: Rahmenbreiten und transform
Lege die Breite einzelner Rahmenseiten und eine CSS-Transformation über `element.style` fest. Unterscheide Inline-Deklarationen von den Werten, die der Browser nach Anwendung der Kaskade ermittelt.
Version: 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 liefert ein Objekt, das Änderungen direkt widerspiegelt. Über seine Eigenschaften liest und bearbeitest du Deklarationen im style-Attribut eines Elements. Im aktuellen CSSOM ist es ein CSSStyleProperties-Objekt, das von CSSStyleDeclaration erbt; ältere Dokumentation nennt möglicherweise die Basisschnittstelle. Diese Browser-API gehört nicht zu ECMAScript 2024.
borderWidth ist die Kurzschreibweise border-width. Ein Wert gilt für alle Seiten; zwei Werte gelten für oben/unten und rechts/links; drei für oben, rechts/links und unten; vier für oben, rechts, unten und links. Für nur eine Seite nutze borderTopWidth, borderRightWidth, borderBottomWidth oder borderLeftWidth. Verwende CSS-Werte als Zeichenketten, etwa "3px", "0" oder "thin"; die Zahl 3 bedeutet nicht drei Pixel. Die Breite allein macht keinen Rahmen sichtbar: Bei none oder hidden ergibt sich eine Breite von null. Setze etwa borderStyle = "solid".
style.transform = "translateX(12px)" ersetzt die gesamte Inline-Deklaration transform. Wenn das Element transformierbar ist und sich diese Deklaration in der Kaskade durchsetzt, wird es 12 CSS-Pixel weiter rechts dargestellt, ohne dass sich sein Platz im normalen Layout ändert. Eine für das Element geltende !important-Deklaration in einem Autoren-Stylesheet kann die Inline-Deklaration übersteuern. Schreibe mehrere Funktionen durch Leerzeichen getrennt in eine Zeichenkette; ihre Reihenfolge ist wichtig.
setProperty("border-top-width", "3px") und getPropertyValue("border-top-width") verwenden im Gegensatz zu style.borderTopWidth den CSS-Namen mit Bindestrichen. Ohne Inline-Deklaration für diese Seite liefert style.borderTopWidth den leeren String "". Für den nach der Kaskade ermittelten Wert eines Elements im Dokument nutze getComputedStyle(element); das Ergebnis wird laufend aktualisiert, ist aber schreibgeschützt.
Beispiele
<!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>Ergebnis
3px 4px 6px 8px 3px translateX(12px)
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Die Kurzschreibweise setzt alle vier Breiten; `setProperty()` ändert nur die obere. Das Element wird nicht ins Dokument eingefügt. Die Ausgabe zeigt daher Inline-Deklarationen und keine gerenderte Darstellung.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Mittlere Stufe · Version: 3