Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

`HTMLElement.style`: transformações e gestos táteis

`style.transform` altera a geometria visual de um elemento e `style.touchAction` determina que gestos de deslocamento e ampliação o navegador pode gerir. Ambas escrevem declarações CSS em linha.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

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 designa duas propriedades distintas do objeto style de uma instância de HTMLElement; a barra não faz parte da sintaxe de JavaScript. element.style disponibiliza um objeto CSSOM modificável que reflete continuamente o atributo style. Atribuir um valor a element.style.transform ou a element.style.touchAction altera apenas a declaração correspondente. Com getPropertyValue() e setProperty(), usa os nomes CSS transform e touch-action.

Ao ler em element.style uma propriedade suportada sem declaração em linha, obténs a cadeia vazia "", mesmo que uma folha de estilos lhe atribua um valor. Para consultar o valor resolvido de um elemento na página, usa getComputedStyle(element). Atribuir "" ou chamar removeProperty() com o nome CSS remove a declaração em linha, sem definir o valor CSS none.

transform aceita none ou uma lista de funções separadas por espaços, como translateX(24px) rotate(10deg). A ordem é importante. Uma transformação muda o aspeto do elemento sem deslocar outros elementos no fluxo normal. Numa caixa CSS transformável, um valor de transform diferente de none cria um contexto de empilhamento e torna o elemento o bloco de referência para os descendentes com position: absolute ou position: fixed. Um span normal não substituído com display: inline pode guardar a declaração transform em linha, mas essa declaração não cria nele um contexto de empilhamento nem um bloco de referência.

touch-action não implementa o arrastamento. Com auto, o navegador gere o deslocamento e a ampliação como habitualmente. pan-y pinch-zoom permite o deslocamento vertical com um dedo e a ampliação por gesto de pinça; a aplicação pode assim implementar o arrastamento horizontal. No início do gesto, o navegador só admite gestos permitidos tanto pelo elemento tocado como pelos seus antepassados relevantes. Alterações posteriores não afetam o gesto em curso. Se o navegador assumir o deslocamento ou a ampliação, trata pointercancel para repor o estado do arrastamento. Evita aplicar touch-action: none a áreas extensas: pode bloquear a ampliação de que dependem pessoas com baixa visão.

Estas API pertencem à plataforma Web, não ao ECMAScript 2024. O suporte depende do navegador e do valor. CSS.supports("touch-action", "pan-y pinch-zoom") verifica o suporte da declaração, mas não dispensa testar os gestos num dispositivo tátil.

Exemplos

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

Resultado

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

Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola de programador. Mostra a escrita e a remoção de declarações em linha num elemento que não foi inserido no documento; não testa a apresentação visual nem os gestos.

Lições relacionadas

  • JavaScript · Lição 35 · Avançado · Versão: 4

Fontes