touch-action css属性 滚动和缩放手势

05/31 22:43
阅读数 18

CSS 属性 touch-action 用于指定某个给定的区域是否允许用户操作,以及如何响应用户操作(比如浏览器自带的划动,缩放等)

默认情况下,平移(滚动) 和 缩放手势由浏览器专门处理。该属性用于取消浏览器默认手势行为,开发人员自定义滚动和手势行为。

touch-action的值:

auto : 当触控事件发送在元素上时,由浏览器来决定进行那些操作,比如viewport进行平滑 缩放。

none : 当触控事件发生在元素上时,不进行任何操作

pan-x : 启用单指水平平移手势

pan-y : 启用单指垂直平移手势。

manipulation : 只可以进行滚动和持续缩放操作。如双击缩放等别的手势

pinch-zoom : 启用多手指平移和缩放页面,这可以和任何平移值组合 如 touch-action:pan-x pan-y pinch-zoom;

 


最常见的用法时禁用元素(及其不可滚动的后代)上的所有手势,以使用自己提供的拖放和缩放的行为

touch-action:none;

还有一个用法是使用指针事件处理水平平移的图片轮播,但不想干扰页面的垂直滚动或缩放

touch-action:pan-y pinch-zoom;

解决双击缩放手势引起的点击事件延迟

touch-action:manipulation;

 

ps:

https://developer.mozilla.org/zh-CN/docs/Web/CSS/touch-action

touch-action

 

CSS属性 touch-action 用于设置触摸屏用户如何操纵元素的区域(例如,浏览器内置的缩放功能)。

/* 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; 

 

初始值 auto
适用元素 all elements except: non-replaced inline elements, table rows, row groups, table columns, and column groups
是否是继承属性
计算值 as specified
Animation type discrete

 

默认情况下,平移(滚动)和缩放手势由浏览器专门处理。 使用 Pointer_events 的应用程序将在浏览器开始处理触摸手势时收到一个 pointercancel 事件。 通过明确指定浏览器应该处理哪些手势,应用程序可以在 pointermove 和 pointerup 监听器中为其余的手势提供自己的行为。 使用 Touch_events 的应用程序通过调用 preventDefault() 禁用浏览器处理手势,但也应使用触摸操作确保浏览器在调用任何事件侦听器之前,了解应用程序的意图。

当手势开始时,浏览器与触摸的元素及其所有祖先的触摸动作值相交直到一个实现手势(换句话说,第一个包含滚动元素)的触摸动作值。 这意味着在实践中,触摸动作通常仅适用于具有某些自定义行为的单个元素,而无需在该元素的任何后代上明确指定触摸动作。 手势开始之后,触摸动作值的更改将不会对当前手势的行为产生任何影响。

语法

touch-action 属性可以被指定为:

auto

当触控事件发生在元素上时,由浏览器来决定进行哪些操作,比如对viewport进行平滑、缩放等。

none

当触控事件发生在元素上时,不进行任何操作。

pan-x

启用单指水平平移手势。可以与 pan-y 、pan-up、pan-down 和/或 pinch-zoom 组合使用。

pan-y

启用单指垂直平移手势。可以与 pan-x 、pan-left 、pan-right 和/或 pinch-zoom 组合使用。

manipulation

浏览器只允许进行滚动和持续缩放操作。任何其它被auto值支持的行为不被支持。启用平移和缩小缩放手势,但禁用其他非标准手势,例如双击以进行缩放。 禁用双击可缩放功能可减少浏览器在用户点击屏幕时延迟生成点击事件的需要。 这是“pan-x pan-y pinch-zoom”(为了兼容性本身仍然有效)的别名。

pan-leftpan-right,pan-up,pan-down 

启用以指定方向滚动开始的单指手势。 一旦滚动开始,方向可能仍然相反。 请注意,滚动“向上”(pan-up)意味着用户正在将其手指向下拖动到屏幕表面上,同样 pan-left 表示用户将其手指向右拖动。 多个方向可以组合,除非有更简单的表示(例如,“pan-left pan-right”无效,因为“pan-x”更简单,而“pan-left pan-down”有效)。

pinch-zoom

启用多手指平移和缩放页面。 这可以与任何平移值组合。

正式语法

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

示例

最常见的用法是禁用元素(及其不可滚动的后代)上的所有手势,以使用自己提供的拖放和缩放行为(如地图或游戏表面)。

#map { touch-action: none; }

另一种常见的模式是使用指针事件处理水平平移的图像轮播,但不想干扰网页的垂直滚动或缩放。

.image-carousel { width: 100%; height: 150px; touch-action: pan-y pinch-zoom; }

触摸动作也经常用于完全解决由支持双击缩放手势引起的点击事件的延迟。

html { touch-action: manipulation; }

Specifications

Specification Status Comment
Compatibility Standard
touch-action
Living Standard Added pinch-zoom property value.
Pointer Events – Level 2
touch-action
Recommendation Added pan-leftpan-rightpan-uppan-downproperty values.
Pointer Events
touch-action
Obsolete Initial definition

Browser compatibility

Report problems with this compatibility data on GitHub

  desktop mobile
  Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet
touch-action
Full support36
 
Full support12
 
Full support52
footnote
Open
Full support11
 
Open
Full support23
 
Full support13
 
Full support37
 
Full support36
 
Full support52
 
Full support24
 
Full support9.3
 
Full support3.0
 
pan-x and pan-y
Full support36
 
Full support12
 
Full support52
footnote
Open
Full support11
 
Open
Full support23
 
Full support13
 
Full support37
 
Full support36
 
Full support52
 
Full support24
 
Full support13
 
Full support3.0
 
double-tap-zoom
Non-standard
No supportNo
 
No support12 — 79
 
No supportNo
 
Full support11
 
Open
No supportNo
 
No supportNo
 
No supportNo
 
No supportNo
 
No supportNo
 
No supportNo
 
No supportNo
 
No supportNo
 
manipulation
Full support36
 
Full support12
 
Full support52
footnote
Open
Full support11
 
Open
Full support23
 
Full support13
 
Full support37
 
Full support36
 
Full support52
 
Full support24
 
Full support9.3
 
Full support3.0
 
none
Full support36
 
Full support12
 
Full support52
footnote
Open
Full support11
 
Open
Full support23
 
Full support13
 
Full support37
 
Full support36
 
Full support52
 
Full support24
 
Full support13
 
Full support3.0
 
pinch-zoom
Full support56
 
Full support12
 
Full support85
footnote
Open
Full support11
 
Open
Full support43
 
Full support13
 
Full support56
 
Full support56
 
Full support85
footnote
Open
Full support43
 
Full support13
 
Full support6.0
 
pan-uppan-downpan-left and pan-right
Full support55
 
Full support79
 
No supportNo
footnote
Open
No supportNo
 
Full support42
 
No supportNo
 
Full support55
 
Full support55
 
No supportNo
footnote
Open
Full support42
 
No supportNo
 
Full support6.0
 

 

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部