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