WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement.style: transform und height

Setze Transformation und Höhe eines Elements mit JavaScript und unterscheide Inline-Deklarationen von den Werten, die sich aus der CSS-Kaskade ergeben.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const style = element.style;
style.transform = "translateY(12px)";
style.height = "80px";
style.removeProperty("transform");
style.height = "";

HTMLElement.style liefert ein Live-Objekt, das das style-Attribut des Elements abbildet. Eine gespeicherte Referenz spiegelt Änderungen weiterhin wider. Laut aktueller Spezifikation ist das Objekt vom Typ CSSStyleProperties, der von CSSStyleDeclaration erbt; manche Browser liefern möglicherweise noch CSSStyleDeclaration. Diese APIs gehören zur Webplattform, nicht zu ECMAScript 2024.

Das Objekt lässt sich nicht austauschen: Eine direkte Zuweisung an element.style setzt cssText und ersetzt den Deklarationsblock. Mit element.style.transform und element.style.height liest oder änderst du einzelne Deklarationen. Weise gültige CSS-Zeichenketten wie "80px" zu. Im Standardmodus wird bei height ein von null verschiedener Wert ohne Einheit wie "81" ohne Ausnahme ignoriert; der bisherige Wert bleibt erhalten. Im Quirks-Modus können Browser einen solchen Wert dagegen als Länge in Pixeln interpretieren.

transform ändert die Darstellung einer transformierbaren Box: translateY(12px) verschiebt sie um 12 CSS-Pixel nach unten, ohne den Platz zu ändern, den sie im normalen Fluss einnimmt. height gibt eine Höhe für das Layout vor: standardmäßig für die Inhaltsbox, mit box-sizing: border-box dagegen für die Rahmenbox.

Fehlt eine Inline-Deklaration, ergibt das Auslesen "". Die Zuweisung von "" oder ein Aufruf von removeProperty() entfernt die Deklaration. Das ist nicht dasselbe wie transform: none oder height: auto. Verwende das schreibgeschützte Objekt von getComputedStyle(element), um die nach der Kaskade aufgelösten Werte auszulesen.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLElement.style: transform and height</title>
</head>
<body>
<script>
(() => {
  const element = document.createElement("div");
  const style = element.style;
  const log = () => console.log(JSON.stringify([style.transform, style.height]));

  style.transform = "translateY(12px)";
  style.height = "80px";
  log();

  style.height = "81";
  log();

  style.removeProperty("height");
  log();
})();
</script>
</body>
</html>

Ergebnis

["translateY(12px)","80px"]
["translateY(12px)","80px"]
["translateY(12px)",""]

Speichere das vollständige Beispiel als HTML-Datei und öffne sie im Browser. Lass `<!doctype html>` stehen, damit die Seite im Standardmodus läuft. Prüfe die Ausgabe in der Browserkonsole. Das Element ist nicht in das Dokument eingefügt; die Ausgabe zeigt daher Inline-Deklarationen und keine gerenderten Abmessungen.

Zugehörige Lektionen

  • JavaScript · Lektion 11 · Fortgeschritten · Version: 4

Quellen