Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

`HTMLElement.style`: transformacije in poteze na dotik

`style.transform` spremeni vidno geometrijo elementa, `style.touchAction` pa določa, katere poteze za pomikanje in povečavo sme obravnavati brskalnik. Obe lastnosti zapišeta deklaracije CSS neposredno na element.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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 ločeni lastnosti objekta style primerka HTMLElement; poševnica ni del sintakse JavaScripta. element.style vrne spremenljiv objekt CSSOM, ki sproti odraža atribut style. Prireditev vrednosti lastnosti element.style.transform ali element.style.touchAction spremeni le ustrezno deklaracijo. Pri metodah getPropertyValue() in setProperty() uporabi imeni CSS transform in touch-action.

Za podprto lastnost brez deklaracije neposredno na elementu element.style vrne prazen niz "", tudi če slogovna predloga določa vrednost. Vrednost, ki jo je brskalnik razrešil za element na strani, prebereš z getComputedStyle(element). Prireditev "" ali klic removeProperty() z imenom CSS odstrani deklaracijo z elementa; ne nastavi vrednosti CSS none.

transform sprejme none ali seznam funkcij, ločenih s presledki, na primer translateX(24px) rotate(10deg). Vrstni red je pomemben. Transformacija spremeni videz elementa, ne da bi premaknila druge elemente v običajnem toku dokumenta. Pri polju CSS, ki ga je mogoče transformirati, vrednost transform, ki ni none, ustvari kontekst zlaganja, element pa postane vsebovalni blok za potomce s position: absolute ali position: fixed. Navaden nenadomeščen span z display: inline lahko hrani deklaracijo transform v atributu style, vendar ta deklaracija na njem ne ustvari ne konteksta zlaganja ne vsebovalnega bloka.

touch-action ne izvaja vlečenja. Pri auto brskalnik obravnava pomikanje in povečavo kot običajno. pan-y pinch-zoom dovoli navpično pomikanje z enim prstom in povečavo s približevanjem ali razmikanjem dveh prstov; aplikacija lahko sama izvede vodoravno vlečenje. Na začetku poteze brskalnik dovoli le tiste poteze, ki jih dopuščajo tako element dotika kot njegovi ustrezni predniki. Poznejše spremembe ne vplivajo na potezo v teku. Če brskalnik prevzame pomikanje ali povečavo, obravnavaj pointercancel in ponastavi stanje vlečenja. Izogibaj se uporabi touch-action: none na velikih območjih: to lahko onemogoči povečavo, ki jo potrebujejo slabovidne osebe.

To so vmesniki spletne platforme, ne funkcije ECMAScript 2024. Podpora je odvisna od brskalnika in vrednosti. CSS.supports("touch-action", "pan-y pinch-zoom") preveri podporo deklaraciji, vendar ne nadomesti preizkusa potez na napravi z zaslonom na dotik.

Primeri

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

Rezultat

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

Primer shrani kot datoteko HTML, odpri jo v brskalniku in preveri razvijalsko konzolo. Koda prikazuje zapis in odstranitev deklaracij na elementu, ki ni vstavljen v dokument; ne preverja prikaza ali potez.

Povezane lekcije

  • JavaScript · Lekcija 35 · Napredna · Različica: 4

Viri