Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

`HTMLElement.style`: transformacje i gesty dotykowe

`style.transform` zmienia geometrię elementu, a `style.touchAction` określa, które gesty przesuwania i powiększania może obsłużyć przeglądarka. Obie właściwości służą do zapisu deklaracji bezpośrednio na elemencie.

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

Składnia

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;

Zapis HTMLElement.style.transform/touchAction oznacza dwie osobne właściwości obiektu style instancji HTMLElement; ukośnik nie jest częścią składni JavaScriptu. element.style zwraca aktualizowany na bieżąco, modyfikowalny obiekt CSSOM powiązany z atrybutem style. Przypisanie do element.style.transform lub element.style.touchAction zmienia tylko daną deklarację. W metodach getPropertyValue() i setProperty() używaj nazw CSS: transform i touch-action.

Odczyt z element.style zwraca pusty łańcuch "", jeśli obsługiwana właściwość nie ma deklaracji bezpośrednio na elemencie, nawet gdy wartość nadaje arkusz stylów. Aby odczytać wartość ustaloną przez przeglądarkę dla elementu na stronie, użyj getComputedStyle(element). Przypisanie "" lub wywołanie removeProperty() z nazwą CSS usuwa deklarację, ale nie ustawia wartości CSS none.

transform przyjmuje none albo listę funkcji rozdzielonych spacjami, np. translateX(24px) rotate(10deg). Kolejność ma znaczenie. Transformacja zmienia wygląd elementu, ale nie przesuwa innych elementów w normalnym przepływie. Gdy pudełko CSS podlega transformacji, wartość transform inna niż none tworzy kontekst stosu i sprawia, że element staje się blokiem zawierającym dla potomków z position: absolute lub position: fixed. Zwykły niezastępowany span z display: inline może przechowywać deklarację transform w atrybucie style, ale ta deklaracja nie tworzy na nim kontekstu stosu ani bloku zawierającego.

touch-action nie implementuje przeciągania. Przykładowo auto pozwala przeglądarce standardowo obsługiwać przesuwanie i powiększanie, a pan-y pinch-zoom dopuszcza pionowe przewijanie jednym palcem i powiększanie gestem szczypania. Aplikacja może wtedy samodzielnie obsłużyć przeciąganie w poziomie. Na początku gestu przeglądarka wyznacza część wspólną gestów dozwolonych przez dotknięty element i odpowiednich przodków. Zmiany w trakcie gestu na niego nie wpływają. Jeśli przeglądarka przejmie gest przewijania lub powiększania, obsłuż pointercancel, aby wyczyścić stan przeciągania. Unikaj stosowania touch-action: none na dużych obszarach: może to uniemożliwić powiększanie potrzebne osobom słabowidzącym.

To interfejsy platformy webowej, a nie funkcje ECMAScript 2024. Obsługa zależy od przeglądarki i wartości. CSS.supports("touch-action", "pan-y pinch-zoom") sprawdza obsługę tej deklaracji, ale nie zastępuje testu gestów na urządzeniu dotykowym.

Przykłady

<!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>

Wynik

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

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź konsolę deweloperską. Kod pokazuje zapis i usuwanie deklaracji na elemencie niepodłączonym do dokumentu; nie testuje wyglądu ani gestów.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4

Źródła