Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

`HTMLElement.style`: transformace a dotyková gesta

`style.transform` mění vizuální geometrii prvku a `style.touchAction` určuje, která gesta posouvání a přibližování smí zpracovat prohlížeč. Obě vlastnosti zapisují deklarace CSS přímo na prvek.

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

Syntaxe

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 označuje dvě samostatné vlastnosti objektu style instance HTMLElement; lomítko není součástí syntaxe JavaScriptu. element.style zpřístupňuje měnitelný objekt CSSOM, který průběžně odráží atribut style. Přiřazení do element.style.transform nebo element.style.touchAction mění jen příslušnou deklaraci. U metod getPropertyValue() a setProperty() používej názvy CSS transform a touch-action.

Pro podporovanou vlastnost bez deklarace přímo na prvku vrací element.style prázdný řetězec "", i když hodnotu určuje seznam stylů. Výslednou hodnotu prvku na stránce zjistíš pomocí getComputedStyle(element). Přiřazením "" nebo voláním removeProperty() s názvem CSS odstraníš deklaraci z prvku; nenastavíš tím hodnotu CSS none.

transform přijímá none nebo seznam funkcí oddělených mezerami, například translateX(24px) rotate(10deg). Na pořadí záleží. Transformace změní vzhled prvku, ale neposune ostatní prvky v běžném toku dokumentu. U transformovatelného boxu CSS hodnota transform odlišná od none vytvoří kontext vykreslování vrstev a z prvku udělá obsahující blok pro potomky s position: absolute nebo position: fixed. Běžný nenahrazovaný span s display: inline může mít deklaraci transform přímo na prvku, ale tato deklarace u něj nevytvoří kontext vykreslování vrstev ani obsahující blok.

touch-action neimplementuje přetahování. S hodnotou auto prohlížeč zpracovává posouvání a přibližování obvyklým způsobem. pan-y pinch-zoom povoluje svislé posouvání jedním prstem a změnu přiblížení gestem dvou prstů; aplikace si může sama zajistit vodorovné přetahování. Na začátku gesta prohlížeč povolí jen gesta, která dovoluje dotčený prvek i příslušní předci. Pozdější změny probíhající gesto neovlivní. Pokud prohlížeč převezme posouvání nebo přibližování, zpracuj pointercancel a vymaž stav přetahování. Nepoužívej touch-action: none na rozsáhlé části stránky: může zamezit přibližování, na které spoléhají slabozrací lidé.

Jde o rozhraní webové platformy, nikoli o funkce ECMAScriptu 2024. Podpora závisí na prohlížeči a hodnotě. CSS.supports("touch-action", "pan-y pinch-zoom") ověří podporu deklarace, ale nenahradí zkoušku gest na dotykovém zařízení.

Příklady

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

Výsledek

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

Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj vývojářskou konzoli. Ukazuje zápis a odstranění deklarací na prvku, který není vložený do dokumentu; neověřuje vykreslení ani gesta.

Související lekce

  • JavaScript · Lekce 35 · Pokročilá · Verze: 4

Zdroje