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.