CKTIS / JavaScript
`HTMLElement.style`: transformácie a dotykové gestá
`style.transform` mení vizuálnu geometriu prvku a `style.touchAction` určuje, ktoré gestá posúvania a približovania môže spracovať prehliadač. Obe vlastnosti zapisujú deklarácie CSS priamo na prvok.
Verzia: 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 označuje dve samostatné vlastnosti objektu style inštancie HTMLElement; lomka nepatrí do syntaxe JavaScriptu. element.style sprístupňuje meniteľný objekt CSSOM, ktorý priebežne odráža atribút style. Priradenie do element.style.transform alebo element.style.touchAction zmení iba príslušnú deklaráciu. Pri metódach getPropertyValue() a setProperty() používaj názvy CSS transform a touch-action.
Pri podporovanej vlastnosti bez deklarácie priamo na prvku vráti element.style prázdny reťazec "", aj keď hodnotu určuje šablóna štýlov. Výslednú hodnotu prvku na stránke zistíš pomocou getComputedStyle(element). Priradením "" alebo volaním removeProperty() s názvom CSS odstrániš deklaráciu z prvku; nenastavíš tým hodnotu CSS none.
transform prijíma none alebo zoznam funkcií oddelených medzerami, napríklad translateX(24px) rotate(10deg). Na poradí záleží. Transformácia zmení vzhľad prvku bez toho, aby posunula ostatné prvky v bežnom toku dokumentu. Pri transformovateľnom boxe CSS hodnota transform iná ako none vytvorí kontext vrstvenia a z prvku urobí obsahujúci blok pre potomkov s position: absolute alebo position: fixed. Bežný nenahrádzaný span s display: inline môže mať deklaráciu transform priamo na prvku, ale táto deklarácia pri ňom nevytvorí kontext vrstvenia ani obsahujúci blok.
touch-action neimplementuje ťahanie. S hodnotou auto prehliadač spracúva posúvanie a približovanie ako obvykle. pan-y pinch-zoom povoľuje zvislé posúvanie jedným prstom a zmenu priblíženia gestom dvoch prstov; aplikácia môže sama implementovať vodorovné ťahanie. Na začiatku gesta prehliadač povolí iba gestá, ktoré umožňuje dotknutý prvok aj príslušní predkovia. Neskoršie zmeny prebiehajúce gesto neovplyvnia. Ak prehliadač prevezme posúvanie alebo približovanie, spracuj pointercancel a vymaž stav ťahania. Nepoužívaj touch-action: none na rozsiahle oblasti: môže zablokovať približovanie, ktoré potrebujú slabozrakí ľudia.
Ide o rozhrania webovej platformy, nie o funkcie ECMAScriptu 2024. Podpora závisí od prehliadača a hodnoty. CSS.supports("touch-action", "pan-y pinch-zoom") overí podporu deklarácie, ale nenahrádza skúšku gest na dotykovom zariadení.
Prí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ýsledok
["translateX(24px)","pan-y"] ["",""]
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj vývojársku konzolu. Ukazuje zápis a odstránenie deklarácií na prvku, ktorý nie je vložený do dokumentu; netestuje vykreslenie ani gestá.
Súvisiace lekcie
- JavaScript · Lekcia 35 · Pokročilá · Verzia: 4