CKTIS / JavaScript
Inline-Breite und -Höhe: `style.width` und `style.height`
Mit `element.style.width` und `element.style.height` liest, setzt und entfernst du Inline-CSS-Deklarationen. Eine Deklaration auszulesen ist nicht dasselbe wie das Element zu messen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.style.width
element.style.height
element.style.width = cssWidth
element.style.height = cssHeight
element.style.width = ""
element.style.height = ""Mit element.style.width und element.style.height liest und änderst du CSS-Deklarationen im style-Attribut eines HTML-Elements, nicht seine HTML-Attribute width und height. element.style liefert ein Deklarationsobjekt, das Änderungen direkt widerspiegelt, keine Momentaufnahme. Jede Eigenschaft liefert CSS-Text oder "", wenn keine Inline-Deklaration vorliegt, selbst wenn ein Stylesheet einen Wert vorgibt.
Weise Zeichenketten wie "120px", "50%" oder "auto" zu. Gib px an, wenn du Pixel meinst: Die API ergänzt bei einer Zahl keine Einheit. Ein ungültiger Wert wie "invalid" lässt die bestehende Deklaration unverändert. "" entfernt die Inline-Deklaration, sodass die Kaskade den Wert bestimmt; "auto" setzt dagegen eine Deklaration.
Eine Inline-Deklaration garantiert nicht die endgültige Größe. Kaskade, Layout und Einschränkungen wie max-width können sie beeinflussen. Die Eigenschaften gelten nicht für nicht ersetzte Inline-Elemente wie ein gewöhnliches span. box-sizing bestimmt, ob die Größe für den Inhaltsbereich gilt (content-box) oder Innenabstand und Rahmen einschließt (border-box).
Bei einem Element, das am Layout teilnimmt, liefern getComputedStyle(element).width und .height den aufgelösten CSS-Wert als Text. Für die Maße des umschließenden Rechtecks in CSS-Pixeln rufst du element.getBoundingClientRect() auf und liest die numerischen Werte width und height. Das Rechteck schließt Innenabstand und Rahmen ein und berücksichtigt CSS-Transformationen. Das sind Browser-APIs, kein Teil von ECMAScript 2024; du brauchst eine Umgebung mit DOM.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>Inline width and height</title>
<script>
const element = document.createElement("div");
const style = element.style;
const log = () => console.log(JSON.stringify([style.width, style.height]));
log();
element.style.width = "50%";
element.style.height = "80px";
log();
element.style.width = "invalid";
log();
element.style.width = "";
element.style.height = "auto";
log();
</script>Ergebnis
["",""] ["50%","80px"] ["50%","80px"] ["","auto"]
Speichere das Beispiel als `.html`-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Das `div` wird nicht ins Dokument eingefügt. Die vier Zeilen zeigen daher Deklarationen, keine Layout-Messwerte.
Zugehörige Lektionen
- JavaScript · Lektion 12 · Fortgeschritten · Version: 4