Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

`HTMLElement.style` : transformations et gestes tactiles

`style.transform` modifie la géométrie visuelle d’un élément, tandis que `style.touchAction` détermine les gestes de défilement et de zoom que le navigateur peut prendre en charge. Ces deux propriétés écrivent des déclarations en ligne.

Version : 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 désigne deux propriétés distinctes de l’objet style d’une instance de HTMLElement ; la barre oblique ne fait pas partie de la syntaxe JavaScript. element.style donne accès à un objet CSSOM modifiable qui reflète en permanence l’attribut style. Affecter une valeur à element.style.transform ou à element.style.touchAction ne modifie que la déclaration correspondante. Avec getPropertyValue() et setProperty(), utilise les noms CSS transform et touch-action.

Pour une propriété prise en charge sans déclaration en ligne, element.style renvoie la chaîne vide "", même si une feuille de style définit une valeur. Pour lire la valeur résolue d’un élément sur la page, utilise getComputedStyle(element). Affecter "" ou appeler removeProperty() avec le nom CSS retire la déclaration en ligne ; cela ne définit pas la valeur CSS none.

transform accepte none ou une liste de fonctions séparées par des espaces, comme translateX(24px) rotate(10deg). L’ordre compte. Une transformation change l’apparence de l’élément sans déplacer les autres éléments dans le flux normal. Pour une boîte CSS transformable, une valeur de transform autre que none crée un contexte d’empilement et fait de l’élément le bloc englobant de ses descendants en position: absolute ou position: fixed. Un span ordinaire non remplacé avec display: inline peut conserver la déclaration transform en ligne, mais celle-ci ne crée ni contexte d’empilement ni bloc englobant sur cet élément.

touch-action n’implémente pas le glissement. Avec auto, le navigateur gère le défilement et le zoom normalement. pan-y pinch-zoom permet le défilement vertical à un doigt et le zoom par pincement ; l’application peut alors gérer le glissement horizontal. Au début du geste, le navigateur ne retient que les gestes autorisés à la fois par l’élément touché et par les ancêtres concernés. Une modification en cours de geste ne change pas ce geste. Si le navigateur prend en charge le défilement ou le zoom, traite pointercancel pour réinitialiser l’état du glissement. Évite d’appliquer touch-action: none sur de grandes zones : cela peut bloquer le zoom dont dépendent certaines personnes malvoyantes.

Ces API relèvent de la plateforme web, pas d’ECMAScript 2024. La prise en charge dépend du navigateur et de la valeur. CSS.supports("touch-action", "pan-y pinch-zoom") vérifie si la déclaration est prise en charge, mais ne remplace pas des essais sur un appareil tactile.

Exemples

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

Résultat

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

Enregistre l’exemple dans un fichier HTML, ouvre-le dans un navigateur et consulte la console de développement. Le code montre l’ajout et la suppression de déclarations en ligne sur un élément détaché du document, sans tester le rendu ni les gestes.

Leçons associées

  • JavaScript · Leçon 35 · Avancé · Version : 4

Sources