WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

`HTMLElement.style`: Transformationen und Touch-Gesten

`style.transform` ändert die sichtbare Geometrie eines Elements. `style.touchAction` legt fest, welche Verschiebe- und Zoomgesten der Browser übernehmen darf. Beide schreiben Inline-Deklarationen.

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

Syntax

element.style.transform = "translateX(24px) rotate(10deg)";
element.style.touchAction = "pan-y";
element.style.getPropertyValue("touch-action");
element.style.setProperty("touch-action", "pan-y");
element.style.transform = "";
element.style.removeProperty("touch-action");
getComputedStyle(element).transform;
getComputedStyle(element).touchAction;

HTMLElement.style.transform/touchAction bezeichnet zwei getrennte Eigenschaften des style-Objekts einer HTMLElement-Instanz; der Schrägstrich gehört nicht zur JavaScript-Syntax. element.style liefert ein veränderbares CSSOM-Objekt, das mit dem style-Attribut verknüpft ist und Änderungen sofort widerspiegelt. Eine Zuweisung an element.style.transform oder element.style.touchAction ändert nur die jeweilige Deklaration. Verwende mit getPropertyValue() und setProperty() die CSS-Namen transform und touch-action.

Für eine unterstützte Eigenschaft ohne Inline-Deklaration liefert element.style den leeren String "", selbst wenn ein Stylesheet einen Wert vorgibt. Den aufgelösten Wert eines Elements auf der Seite liest du mit getComputedStyle(element). Eine Zuweisung von "" oder ein Aufruf von removeProperty() mit dem CSS-Namen entfernt die Inline-Deklaration, statt den CSS-Wert none zu setzen.

transform akzeptiert none oder eine durch Leerzeichen getrennte Funktionsliste wie translateX(24px) rotate(10deg). Die Reihenfolge spielt eine Rolle. Eine Transformation ändert die Darstellung, ohne andere Elemente im normalen Layoutfluss zu verschieben. Bei einer transformierbaren CSS-Box erzeugt ein transform-Wert ungleich none einen Stapelkontext und macht das Element zum umschließenden Block für Nachfahren mit position: absolute oder position: fixed. Ein gewöhnliches, nicht ersetztes span mit display: inline kann die Inline-Deklaration für transform speichern; die Deklaration erzeugt dort aber weder einen Stapelkontext noch einen umschließenden Block.

touch-action implementiert kein Ziehen. Mit auto übernimmt der Browser Verschieben und Zoomen wie gewohnt. pan-y pinch-zoom erlaubt vertikales Scrollen mit einem Finger und Zoomen mit einer Zweifingergeste; die Anwendung kann horizontales Ziehen selbst implementieren. Zu Beginn der Geste berücksichtigt der Browser nur Gesten, die sowohl das berührte Element als auch die maßgeblichen Vorfahren zulassen. Spätere Änderungen beeinflussen die laufende Geste nicht. Übernimmt der Browser das Scrollen oder Zoomen, reagiere auf pointercancel, um den Ziehzustand zurückzusetzen. Setze touch-action: none nicht großflächig ein: Das kann die Zoomfunktion blockieren, auf die Menschen mit Sehbeeinträchtigung angewiesen sind.

Dies sind APIs der Webplattform, keine Funktionen von ECMAScript 2024. Die Unterstützung hängt vom Browser und vom Wert ab. CSS.supports("touch-action", "pan-y pinch-zoom") prüft die Unterstützung der Deklaration, ersetzt aber keinen Gestentest auf einem Touchgerät.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>Inline transform and touch-action</title>
<script>
  if (typeof CSS === "undefined" || typeof CSS.supports !== "function") {
    console.log("CSS.supports() is not available.");
  } else if (CSS.supports("transform", "translateX(24px)") && CSS.supports("touch-action", "pan-y")) {
    const element = document.createElement("div");
    const style = element.style;
    style.transform = "translateX(24px)";
    style.touchAction = "pan-y";
    console.log(JSON.stringify([style.transform, style.getPropertyValue("touch-action")]));

    style.transform = "";
    style.removeProperty("touch-action");
    console.log(JSON.stringify([style.transform, style.touchAction]));
  } else {
    console.log("Required CSS values are not supported.");
  }
</script>

Ergebnis

["translateX(24px)","pan-y"]
["",""]

Speichere das Beispiel als HTML-Datei, öffne es im Browser und prüfe die Entwicklerkonsole. Es zeigt, wie Inline-Deklarationen an einem nicht ins Dokument eingefügten Element gesetzt und entfernt werden; Darstellung und Gesten werden nicht getestet.

Zugehörige Lektionen

  • JavaScript · Lektion 35 · Fortgeschritten · Version: 4

Quellen