CKTIS / JavaScript
`HTMLElement.style`: transformaties en aanraakgebaren
Met `style.transform` verander je de visuele geometrie van een element. Met `style.touchAction` bepaal je welke scroll- en zoomgebaren de browser mag afhandelen. Beide schrijven inline CSS-declaraties.
Versie: 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 duidt twee afzonderlijke eigenschappen aan op het style-object van een HTMLElement-instantie; de schuine streep is geen JavaScript-syntaxis. element.style geeft een wijzigbaar CSSOM-object dat het style-attribuut doorlopend weerspiegelt. Een toewijzing aan element.style.transform of element.style.touchAction wijzigt alleen de bijbehorende declaratie. Gebruik bij getPropertyValue() en setProperty() de CSS-namen transform en touch-action.
Voor een ondersteunde eigenschap zonder inline declaratie geeft element.style de lege tekenreeks "" terug, ook als een stylesheet een waarde opgeeft. Gebruik getComputedStyle(element) om de door de browser bepaalde waarde voor een element op de pagina op te vragen. Een toewijzing van "" of een aanroep van removeProperty() met de CSS-naam verwijdert de inline declaratie; daarmee stel je niet de CSS-waarde none in.
transform accepteert none of een lijst van functies gescheiden door spaties, zoals translateX(24px) rotate(10deg). De volgorde maakt uit. Een transformatie verandert de weergave zonder andere elementen in de normale documentstroom te verplaatsen. Bij een transformeerbare CSS-box creëert een transform-waarde anders dan none een stapelcontext en maakt die waarde het element het referentiekader voor nakomelingen met position: absolute of position: fixed. Een gewone, niet-vervangen span met display: inline kan de inline declaratie voor transform opslaan, maar die declaratie creëert daar geen stapelcontext of referentiekader.
touch-action implementeert geen sleepgedrag. Met auto handelt de browser scrollen en zoomen af zoals gewoonlijk. pan-y pinch-zoom staat verticaal scrollen met één vinger en zoomen met een knijpgebaar toe; de app kan daardoor horizontaal slepen zelf implementeren. Aan het begin van het gebaar staat de browser alleen gebaren toe die zowel door het aangeraakte element als door de relevante voorouders zijn toegestaan. Latere wijzigingen hebben geen invloed op het lopende gebaar. Als de browser het scrollen of zoomen overneemt, handel dan pointercancel af om de sleepstatus te wissen. Gebruik touch-action: none niet op grote delen van de pagina: dat kan de zoomfunctie blokkeren die slechtziende mensen nodig hebben.
Dit zijn API’s van het webplatform, geen functies van ECMAScript 2024. Ondersteuning hangt af van de browser en de waarde. CSS.supports("touch-action", "pan-y pinch-zoom") controleert of de declaratie wordt ondersteund, maar vervangt geen gebarentests op een aanraakapparaat.
Voorbeelden
<!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>Resultaat
["translateX(24px)","pan-y"] ["",""]
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de ontwikkelaarsconsole. De code stelt inline declaraties in en verwijdert ze op een element dat niet aan het document is toegevoegd; weergave en gebaren worden niet getest.
Gerelateerde lessen
- JavaScript · Les 35 · Gevorderd · Versie: 4