The touch-action
CSS property sets how an element's region can be manipulated by a touchscreen user (for example, by zooming features built into the browser).
/* Keyword values */ touch-action: auto; touch-action: none; touch-action: pan-x; touch-action: pan-left; touch-action: pan-right; touch-action: pan-y; touch-action: pan-up; touch-action: pan-down; touch-action: pinch-zoom; touch-action: manipulation; /* Global values */ touch-action: inherit; touch-action: initial; touch-action: unset;
By default, panning (scrolling) and pinching gestures are handled exclusively by the browser. An application using Pointer events will receive a pointercancel
event when the browser starts handling a touch gesture. By explicitly specifying which gestures should be handled by the browser, an application can supply its own behavior in pointermove
and pointerup
listeners for the remaining gestures. Applications using Touch events disable the browser handling of gestures by calling preventDefault()
, but should also use touch-action
to ensure the browser knows the intent of the application before any event listeners have been invoked.
When a gesture is started, the browser intersects the touch-action
values of the touched element and its ancestors, up to the one that implements the gesture (in other words, the first containing scrolling element). This means that in practice, touch-action
is typically applied only to top-level elements which have some custom behavior, without needing to specify touch-action
explicitly on any of that element's descendants.
After a gesture starts, changes to touch-action
will not have any impact on the behavior of the current gesture.
The touch-action
property may be specified as either:
auto
, none
, manipulation
, or
pan-x
, pan-left
, pan-right
, and/or one of the keywords pan-y
, pan-up
, pan-down
, plus optionally the keyword pinch-zoom
.auto
none
pan-x
pan-y
manipulation
pan-left
, pan-right
, pan-up
, pan-down
pinch-zoom
A declaration of touch-action: none;
may inhibit operating a browser's zooming capabilities. This will prevent people experiencing low vision conditions from being able to read and understand page content.
Initial value | auto |
---|---|
Applies to | all elements except: non-replaced inline elements, table rows, row groups, table columns, and column groups |
Inherited | no |
Computed value | as specified |
Animation type | discrete |
auto | none | [ [ pan-x | pan-left | pan-right ] || [ pan-y | pan-up | pan-down ] || pinch-zoom ] | manipulation
The most common usage is to disable all gestures on an element (and its non-scrollable descendants) that provides its own dragging and zooming behavior – such as a map or game surface.
<div id="map"></div>
#map { height: 150vh; width: 70vw; background: linear-gradient(blue, green); touch-action: none; }
Specification | Status | Comment |
---|---|---|
Compatibility Standard The definition of 'touch-action' in that specification. | Living Standard | Added pinch-zoom property value. |
Pointer Events – Level 3 The definition of 'touch-action' in that specification. | Editor's Draft | Added pan-left , pan-right , pan-up , pan-down property values. |
Pointer Events – Level 2 The definition of 'touch-action' in that specification. | Recommendation | Latest recommendation. |
Pointer Events The definition of 'touch-action' in that specification. | Obsolete | Initial definition. |
Desktop | ||||||
---|---|---|---|---|---|---|
touch-action |
36 | 12 | 52
|
11
|
23 | 13 |
pan-x and pan-y
|
36 | 12 | 52
|
11
|
23 | 13 |
double-tap-zoom
|
No | 12 — 79 | No | 11
|
No | No |
manipulation |
36 | 12 | 52
|
11
|
23 | 13 |
none |
36 | 12 | 52
|
11
|
23 | 13 |
pinch-zoom |
56 | 12 | No
|
11
|
43 | 13 |
pan-up , pan-down , pan-left and pan-right
|
55 | 79 | No
|
No | 42 | No |
Mobile | ||||||
---|---|---|---|---|---|---|
touch-action |
37 | 36 | 52
|
24 | 9.3 | 3.0 |
pan-x and pan-y
|
37 | 36 | 52
|
24 | 13 | 3.0 |
double-tap-zoom
|
No | No | No | No | No | No |
manipulation |
37 | 36 | 52
|
24 | 9.3 | 3.0 |
none |
37 | 36 | 52
|
24 | 13 | 3.0 |
pinch-zoom |
56 | 56 | No
|
43 | 13 | 6.0 |
pan-up , pan-down , pan-left and pan-right
|
55 | 55 | No
|
42 | No | 6.0 |
Pointer Events
© 2005–2020 Mozilla and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/touch-action