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

CKTIS / CSS

touch-action — gestos permitidos pelo navegador

A propriedade touch-action define os gestos táteis de deslocamento e zoom permitidos. Permite restringir um eixo sem desativar o zoom desnecessariamente.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

touch-action: auto | none | [ [ pan-x | pan-left | pan-right ] || [ pan-y | pan-up | pan-down ] || pinch-zoom ] | manipulation;

touch-action controla os gestos permitidos pelo navegador: auto mantém o comportamento predefinido, enquanto none bloqueia o deslocamento e o zoom por toque. pan-x e pan-y permitem os respetivos eixos; as variantes direcionais restringem a direção em que o deslocamento pode começar. pinch-zoom permite deslocar e fazer zoom com vários dedos. manipulation equivale a pan-x pan-y pinch-zoom.

O valor inicial é auto; a propriedade não é herdada nem animável. O exemplo usa pan-y pinch-zoom, mantendo disponíveis o deslocamento vertical e o zoom. Não implementa um carrossel nem o arrastamento. Evita bloquear o zoom desnecessariamente com none.

Exemplos

<!doctype html>
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>touch-action</title>
<style>
  body { min-height: 200vh; }
  #surface {
    touch-action: pan-y pinch-zoom;
    padding: 3rem;
    background: lightblue;
  }
</style>
<div id="surface">pan-y pinch-zoom</div>
<pre id="result"></pre>
<script>
  const surface = document.getElementById('surface');
  document.getElementById('result').textContent =
    getComputedStyle(surface).touchAction;
</script>

Resultado

pan-y pinch-zoom

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes