基础篇:键盘、鼠标、触摸事件

用户与页面最频繁的交互,就是键盘、鼠标和触摸。三者都挂在 UIEvent 之下,但坐标、按键标识和触点列表各有一套字段。读事件对象时先分清「物理位置」和「产生的字符、按钮」,再处理默认行为。

键盘(Keyboard)事件

键盘事件继承于 KeyboardEvent 接口,描述用户与键盘的交互。

KeyboardEvent 常量

KeyboardEvent 常量用于识别触发按键事件的键盘位置。

  • DOM_KEY_LOCATION_STANDARD: 0。表示键不是位于键盘的特殊区域。特殊区域不是指数字键盘上(除非它是 NumLock 键)或者位于键盘左右两侧重复的键,而是,不管什么原因,与所处位置没有关联的键。 比如, 标准 PC 101 美国键盘上的字母数字键、NumLock 键和空格键。

  • DOM_KEY_LOCATION_LEFT: 1。表示键可能存在于键盘上的多个位置,在当前情况下,位于键盘的左侧。 比如,左 Control 键、Macintosh 键盘上的左 Command 键或左 Shift 键。

  • DOM_KEY_LOCATION_RIGHT: 2。表示键可能存在于键盘上的多个位置,在当前情况下,位于键盘的右侧。 比如,右 Shift 键和右 Alt 键(Mac 键盘上的选项)。

  • DOM_KEY_LOCATION_NUMPAD: 3。表示键位于数字键盘上,或者是与数字键盘相关联的虚拟键。 比如,数字键盘上的数字、键盘的 “Enter” 键和键盘上的小数点。

    NumLock 键不属于这个组,并且总是使用位置 DOM_KEY_LOCATION_STANDARD 进行编码。

KeyboardEvent.DOM_KEY_LOCATION_STANDARD // 0
KeyboardEvent.DOM_KEY_LOCATION_LEFT     // 1
KeyboardEvent.DOM_KEY_LOCATION_RIGHT    // 2
KeyboardEvent.DOM_KEY_LOCATION_NUMPAD   // 3

KeyboardEvent 属性

KeyboardEvent 接口从 UIEvent 和 Event 接口中继承属性。

altKey(只读)

返回布尔值。表示事件触发时,alt 键(OS X 系统上的 Option 或 ⌥ 键)是(true)否(false)按下。

ctrlKey(只读)

返回布尔值。表示事件触发时,control 键是(true)否(false)按下。

shiftKey(只读)

返回布尔值。表示事件触发时,shift 键是(true)否(false)按下。

metaKey(只读)

返回布尔值。表示事件触发时,Meta 键是(true)否(false)按下。

注意: 在 MAC 键盘上,表示 Command 键(⌘);在 Windows 键盘上,表示 Windows 键(⊞)。

code(只读)

返回字符串,表示触发事件的物理按键。

常用键的 code 属性值:

  • 数字键 0-9:返回 Digit0 ~ Digit9。
  • 字母键 A-Z:返回 KeyA ~ KeyZ(不区分大小写)。
  • 功能键 F1-F12:返回 F1 ~ F12。
  • 方向键:返回 ArrowDown、ArrowUp、ArrowLeft、ArrowRight。
  • Alt、Shift、Ctrl 键:返回 AltLeft 或 AltRight、ShiftLeft 或 ShiftRight、ControlLeft 或 ControlRight。

注意: 该属性会忽略用户的键盘布局。所以如果用户在 QWERTY 布局的键盘上按下 “Y” 位置(第一行字母按键的中间)的按键时,这个属性会返回 “KeyY”,即使用户使用 QWERTZ 布局的键盘(此时用户输入的就是“Z”,其他属性也会提示“Z”)或 Dvorak 键盘(此时用户输入的就是“F”)也是如此。

key(只读)

返回字符串,表示该按键在当前布局下产生的键值(字符或预定义名称),不是物理位置。物理位置看 code。它还与 shiftKey 等修饰键状态以及键盘的区域、布局有关。

其值由以下因素决定:

  • 如果按下字符键,则返回一个非空的 Unicode 字符。
  • 如果按下功能键,则返回一个事先定义好的值,见预定义键值列表
  • 如果按下死键,则返回 "Dead"
  • 有些特殊键盘的键(比如多媒体键盘上用来控制媒体播放的扩展按键)在 Windows 下会触发 WM_APPCOMMAND 事件,而不会产生按键代码。虽然没有按键代码,这些事件将映射到 DOM 键盘事件中,并将列入 Windows 的“虚拟按键码”列表中。
  • 如果按键无法识别,则返回 "Unidentified"

常用键的 key 属性值:

  • 数字键 0-9:返回 0 ~ 9。
  • 字母键 A-Z:返回 A ~ Z、a ~ z(区分大小写)。
  • 功能键 F1-F12:返回 F1 ~ F12。
  • 方向键:返回 ArrowDown、ArrowUp、ArrowLeft、ArrowRight。
  • Alt、Shift、Ctrl 键:返回 Alt、Shift、Control。

keyCode(只读)(已废弃)

返回按下的非字符键的唯一标识值。其值依据于一个系统和实现相关的数字代码,通常是与密钥对应的二进制的 ASCII(RFC 20)码或 Windows 1252 码。如果这个键不能被标志,这个值为 0。

该属性值在浏览器之间不兼容,比如:

  • 在 FF、Opera 中,分号键返回 59,但 IE、Chrome、Safari 返回 186。

  • 在 Safari 3 之前的版本中,上、下、左、右箭头和上翻(PageUp)、下翻(PageDown)键返回大于 63000的值。

注意: 在处理 keydownkeyup 事件时,不应使用字符键keyCode 属性。keyCode 对字符键的输入无效,尤其是按下 Shift 或 Alt 键的输入。

注意: keyCode 属性在不同浏览器,不同事件中,其返回值有很大的兼容性问题,建议用 KeyboardEvent.code 或者 KeyboardEvent.key 属性代替。如果一定要用该属性,请先阅读该文章

charCode(只读)(已废弃)(非标准)

返回按下的字符键的字符 Unicode 值。

charCode 属性值不会在 keydown、keyup 事件中被设置。在 keypress 事件中,按键的 Unicode 值保存在 keyCode 或 charCode 属性其中之一,不会二者同时都有。如果按下的是字符键(如, 'a'),charCode 属性被设置为字符的代码值,并区分大小写; 否则,被按下的键的代码被存储在 keyCode 属性中。

注意: 该属性已被废弃,请使用 KeyboardEvent.key 属性代替。

// Chrome: 依次按下 a -> 1 -> 右方向 -> F3 -> CapsLock 键,各属性的打印值如下: 
document.querySelector('input').addEventListener('keydown', event => {
    console.log(event.code) // KeyA -> Digit1 -> ArrowRight -> F3 -> CapsLock
    console.log(event.key)  // a -> 1 -> ArrowRight -> F3 -> CapsLock
    console.log(event.keyCode)  // 65 -> 49 -> 39 -> 114 -> 20
    console.log(event.charCode) // 0 -> 0 -> 0 -> 0 -> 0
}, false)
document.querySelector('input').addEventListener('keypress', event => {
    console.log(event.charCode) // 97 -> 49,其余三个功能键不会触发 keypress 事件
}, false)

location(只读)

返回一个无符号的长整型(Number 类型,0、1、3...),表示按键在键盘或其他设备上的位置。

其返回值表示的位置,可以查看上一节 【KeyboardEvent 常量】

isComposing(只读)

返回布尔值。表示该事件是否在 compositionstart 之后和 compositionend 之前被触发。

repeat(只读)

返回布尔值。如果按键被一直按住,返回值为true。

KeyboardEvent 方法

KeyboardEvent 接口从 UIEvent 和 Event 接口中继承方法。

getModifierState()

返回布尔值,指定修饰键(区分大小写)是否处于活动状态(即被按下或锁定)。

常见的修饰键有:

Alt、CapsLock、Control、NumLock、Shift

KeyboardEvent 事件

键盘事件可在获得焦点的任意元素上触发,并不限于 inputtextareawindowdocument 也可监听。contenteditable 或设置了 tabindex 的元素同样可以接收键盘事件。

document.querySelector('input').addEventListener('keydown', event => {}, false)
window.addEventListener('keydown', event => {}, false)
document.addEventListener('keydown', event => {}, false)

keydown

当键盘按键按下时触发。当用户按下任意键时触发,而且按住不放的话,会重复触发此事件。

keypress(已弃用)

当用户按下字符键时触发,而且按住不放的话,会重复触发此事件。但是,功能键不一定能触发该事件。现行代码应使用 keydown

keyup

在键盘按键被松开时触发。

KeyboardEvent 事件取值兼容情况:

  • keydownkeyup 表现一致,keypress 与两者有差异:keydownkeyup 事件中,字符键、功能键可获取 keyCodewhich 属性值,但 charCode 属性值为 0;而 keypress 事件中,字符键可获取 keyCodewhichcharCode 属性值。但有些浏览器中,功能键不一定能触发此事件。
  • keydown、keyup 事件捕获键盘按键的操作,对大小写不敏感,而 keypress 响应具体输入某个字符的值,对大小写敏感。比如,在 keydown、keyup 事件中,小写 a 和大写 A 输出的都是大写 A 的 Unicode 编码 65;而在 keypress 事件中,小写 a 输出的 Unicode 编码是 97,而大写 A 输出的 Unicode 编码是 65。

  • keypress 事件的 which 属性值无法区分主键盘上的数字键和附键盘数字键的,而 keydown、keyup 的 which 属性值对主附键盘的数字键敏感。

注意: keyup 事件中,无法阻止浏览器默认事件。因为在 keypress 时浏览器默认行为往往已经完成,文字已进入文本框(尽管这时还没显示),此时无论调用 preventDefault() 还是设置 returnValue = false 都不能阻止输入。如要阻止默认行为,必须在 keydownkeypress 中阻止。

键盘键分类

键盘中的键分为字符键(可打印)和功能键(不可打印),系统功能键包括如下:

Esc
Tab
Caps Lock
Shift
Ctrl
Alt
Enter
Backspace
Print Screen
Scroll Lock
Pause Break
Insert
Delete
Home
End
Page Up
Page Down
F1 ~ 12
Num Lock
The Arrow Keys

keydown、keyup 均可以对系统功能键进行有效的拦截,但事件截获的位置不同;keypress 事件不能对系统功能键(例如:后退、删除等)、中文输入法进行正常的响应。

keypress 事件的系统功能键兼容问题:

  • Firefox: 支持 Esc、Enter、Backspace、Pause Break、Insert、Delete、Home、End、Page Up、Page Down、F1 ~ F12、The Arrow Keys

  • Chrome、Opera、Safari:支持 Enter、不支持 The Arrow Keys

  • IE:支持 Esc、Enter、不支持 The Arrow Keys

中文输入法兼容问题:

  • Firefox:字符键输入触发 keydown,回车确认输入触发 keyup

  • Chrome:字符键输入触发 keydownkeyup,回车确认输入只触发 keydown

  • IE、Opera:字符键输入触发 keydownkeyup,回车确认输入触发 keydownkeyup

ASCII 码表

信息在计算机上是用二进制表示的,这种表示法让人理解就很困难。因此计算机上都配有输入和输出设备,这些设备的主要目的就是,以一种人类可阅读的形式将信息在这些设备上显示出来供人阅读理解。为保证人类和设备,设备和计算机之间能进行正确的信息交换,人们编制的统一的信息交换代码,这就是 ASCII 码(American Standard Code for Information Interchange)表,它的全称是「美国信息交换标准代码」。

一些常见的:

  • 字母:大写 [A-Z] -> [65-90],小写 [a-z] -> [97-122]。不要写成 [A-z],那会把 91-96 之间的符号也算进去。

  • 数字:[0-9] -> [48-57]

字符 编码 字符 编码 字符 编码 字符 编码
nul 0 sp 32 @ 64 ` 96
soh 1 ! 33 A 65 a 97
stx 2 " 34 B 66 b 98
etx 3 # 35 C 67 c 99
eot 4 $ 36 D 68 d 100
enq 5 % 37 E 69 e 101
ack 6 & 38 F 70 f 102
bel 7 ' 39 G 71 g 103
bs 8 ( 40 H 72 h 104
ht 9 ) 41 I 73 i 105
nl 10 * 42 J 74 j 106
vt 11 + 43 K 75 k 107
ff 12 , 44 L 76 l 108
er 13 - 45 M 77 m 109
so 14 . 46 N 78 n 110
si 15 / 47 O 79 o 111
dle 16 0 48 P 80 p 112
dc1 17 1 49 Q 81 q 113
dc2 18 2 50 R 82 r 114
dc3 19 3 51 S 83 s 115
dc4 20 4 52 T 84 t 116
nak 21 5 53 U 85 u 117
syn 22 6 54 V 86 v 118
etb 23 7 55 W 87 w 119
can 24 8 56 X 88 x 120
em 25 9 57 Y 89 y 121
sub 26 : 58 Z 90 z 122
esc 27 ; 59 [ 91 { 123
fs 28 < 60 \ 92 \ 124
gs 29 = 61 ] 93 } 125
re 30 > 62 ^ 94 ~ 126
us 31 ? 63 _ 95 del 127

鼠标(Mouse)事件

鼠标事件继承于 MouseEvent 接口。MouseEvent 接口指用户与指针设备(如鼠标)交互时发生的事件。MouseEvent 接口继承自 UIEvent 接口,UIEvent 接口继承自 Event 接口。

MouseEvent 属性

MouseEvent 接口继承 UIEvent 和 Event 接口上的属性。

altKey(只读)

当鼠标事件触发时,alt 键是否被按下。

ctrlKey(只读)

当鼠标事件触发时,control 键是否被按下。

metaKey(只读)

当鼠标事件触发时,meta 键是否被按下。

shiftKey(只读)

当鼠标事件触发时,shift 键是否被按下。

button(只读)

当鼠标事件触发时,返回一个值,代表用户按下并触发了事件的鼠标按键。

返回值代表按下的鼠标按键:

  • 0:主按键,通常指鼠标左键或默认值(Element.click() 触发事件就是默认值)。

  • 1:辅助按键,通常指鼠标滚轮中键。

  • 2:次按键,通常指鼠标右键。
  • 3:第四个按钮,通常指浏览器后退按钮。
  • 4:第五个按钮,通常指浏览器的前进按钮。

注意: 用户可以改变鼠标按键的配置,因此 button 属性值为 0 时,它可能不是由物理上设备最左边的按键触发的。比如,对于配置为左手使用的鼠标,按键操作将正好相反。此种情况下,从右至左读取值。

注意: button 属性只能够表明在触发事件的单个或多个按键按下或释放过程中哪些按键被按下了。因此,它对判断 mouseenter、mouseleave、mouseover、mouseout、mousemove 这些事件并不可靠。

buttons(只读)

当鼠标事件触发时,哪些鼠标按键被按下。

返回值代表按下的鼠标按键:

  • 0: 没有按键或者是没有初始化。
  • 1: 鼠标左键。
  • 2: 鼠标右键。
  • 4: 鼠标滚轮或者是中键。
  • 8: 第四个按钮,通常指浏览器后退按钮。
  • 16: 第五个按钮,通常指浏览器的前进按钮。

如果按下的键为多个,则值等于所有按键对应数值进行或(|)运算的结果。

1 | 2 // 3。左键和右键同时按下
2 | 4 // 6。右键和中键同时按下

clientX(只读)

返回一个双精度浮点值。表示当事件触发时,鼠标指针在客户端区域中的 X 坐标。

例如,不论页面是否有水平滚动,当你点击客户端区域的左上角时,其值都将为 0 。

clientY(只读)

返回一个双精度浮点值。表示当事件触发时,鼠标指针在客户端区域中的 Y 坐标。

例如,不论页面是否有垂直滚动,当你点击客户端区域的左上角时,其值都将为 0 。

movementX(只读)

返回一个数字。表示当前事件和上一个 mousemove 事件之间鼠标在 X 轴方向上的移动值。

换句话说,这个值是这样计算的:

currentEvent.movementX = currentEvent.screenX - previousEvent.screenX

movementY(只读)

返回一个数字。表示当前事件和上一个 mousemove 事件之间鼠标在 Y 轴方向上的移动值。

换句话说,这个值是这样计算的:

currentEvent.movementY = currentEvent.screenY - previousEvent.screenY

offsetX(只读)

返回一个双精度浮点值。表示鼠标指针相对于事件目标内填充边在 X 轴方向上的偏移量。

offsetY(只读)

返回一个双精度浮点值。表示鼠标指针相对于事件目标内填充边在 Y 轴方向上的偏移量。

pageX(只读)

返回一个双精度浮点值。表示鼠标指针相对于整个文档的 X 坐标。该属性基于文档边缘,计入页面水平滚动。

pageY(只读)

返回一个双精度浮点值。表示鼠标指针相对于整个文档的 Y 坐标。该属性基于文档边缘,计入页面垂直滚动。

screenX(只读)

返回一个双精度浮点值。表示鼠标指针相对于全局(屏幕)的 X 坐标。

screenY(只读)

返回一个双精度浮点值。表示鼠标指针相对于全局(屏幕)的 Y 坐标。

x(只读)

clientX 属性的别名。

y(只读)

clientY 属性的别名。

region(只读)

返回被点击事件影响的点击区域的 id,如果没有区域被影响则返回 null。

relatedTarget(只读)

鼠标事件的次要目标(如果有的话)。

which(只读)(非标准)

表示鼠标事件是由哪个鼠标按键被按下所触发的。现行代码应优先使用 buttonbuttons

返回值表示按键:

  • 0:无(部分实现)。
  • 1:左键。
  • 2:中间滚轮(如果有的话)。
  • 3:右键。

MouseEvent 方法

MouseEvent 接口从 UIEvent 和 Event 接口中继承方法。

getModifierState()

返回布尔值,指定修饰键是否处于活动状态(即被按下或锁定)。同 KeyboardEvent.getModifierState() 方法。

MouseEvent 事件

click

在一个元素上单击(按下和放开)一次鼠标的指针设备按钮(通常是鼠标左键)时触发。

dblclick

在一个元素上连续单击两次鼠标的指针设备按钮(通常是鼠标左键)时触发。

contextmenu

在用户尝试打开上下文菜单时被触发。

该事件通常在鼠标点击右键或者按下键盘上的菜单键时被触发,如果使用菜单键,该上下文菜单会被展示到所聚焦元素的左下角,但是如果该元素是一棵 DOM 树的话,上下文菜单便会展示在当前这一行的左下角。

任何没有被禁用的鼠标右击事件(通过调用事件的 preventDefault() 方法)的元素都可以触发该事件。

mousedown

在指针设备按钮按下时触发。

mouseup

在指针设备按钮放开时触发。

mouseenter

当指针设备(通常指鼠标)的指针移动到元素时触发。

类似 mouseover 事件,两者区别是:mouseenter 不会冒泡,而 mouseover 会。也就是说,当指针在该元素和其子元素之间移动时,不会触发 mouseenter 事件,但会触发 mouseover 事件。

mouseleave

当指针设备(通常是鼠标)的指针移出元素时触发。

类似 mouseout 事件,两者区别是:mouseleave 不会冒泡,而 mouseout 会。也就是说,当指针在该元素和其子元素之间移动时,不会触发 mouseleave 事件,但会触发 mouseout 事件。

mouseover

当指针设备(通常指鼠标)的指针移动到当前元素或其子元素时触发。当指针从一个元素移入其子元素时也会触发,因为子元素遮盖了父元素的可视区域。

mouseout

当指针设备(通常指鼠标)的指针移出当前元素或其子元素时触发。当指针从一个元素移入其子元素时也会触发,因为子元素遮盖了父元素的可视区域。

mousemove

当指针设备(通常指鼠标)在元素上移动时触发。

select

有文本被选中。

wheel

滚轮向任意方向滚动。

触摸(Touch)事件

TouchEvent 是一类描述手指在触摸平面(触摸屏、触摸板等)的状态变化的事件。这类事件用于描述一个或多个触点,使开发者可以检测触点的移动、触点的增加和减少等等。

每个 Touch 对象代表一个触点,每个触点都由其位置、大小、形状、压力大小、目标元素描述组成。 TouchList 对象代表多个触点的一个列表。

在很多情况下,触摸事件和鼠标事件会同时被触发(目的是让没有对触摸设备优化的代码仍然可以在触摸设备上正常工作)。如果使用了触摸事件,可以调用 event.preventDefault() 来阻止鼠标事件被触发。

TouchEvent 属性

TouchEvent 接口继承 UIEvent 和 Event 接口的属性。

touches(只读)

返回一个 TouchList,表示当前仍与触摸表面接触的所有 Touch 对象,不论这些触点的目标元素是谁。

targetTouches(只读)

返回一个 TouchList,表示仍与触摸面接触、且起始目标仍是当前元素的触点。

注意: 事件目标是触发 touchstart 的那个元素。即使手指移到其他元素上,该触点仍会出现在原目标的 targetTouches 中。

changedTouches(只读)

返回一个 TouchList 对象,表示所有从上一次触摸事件到此次事件过程中,状态发生了改变的触点的 Touch 对象。

  • touchstart 事件: 列出在此次事件中新增加的触点集合。
  • touchmove 事件: 列出和上一次事件相比较,发生了变化的触点集合。
  • touchend 事件: 列出已经从触摸面的离开的触点集合。

TouchEvent 事件

touchstart

当一个或多个触摸点与触控设备表面接触时触发。

touchmove

当一个或多个触摸点沿触摸设备表面移动时触发。当触点的半径、旋转角度以及压力大小发生变化时,也将触发此事件。

touchend

当一个或多个触摸点沿触摸设备表面移除时触发。

touchcancel

当一个或多个触摸点沿触摸设备表面被中断时触发。中断方式基于特定实现而有所不同,例如, 创建了太多的触摸点。

有几种可能的原因如下:

  • 由于某个事件出现而取消了触摸:例如触摸过程被弹窗打断。
  • 触点离开了文档窗口,而进入了浏览器的界面元素、插件或者其他外部内容区域。
  • 当用户产生的触点个数超过了设备支持的个数,从而导致 TouchList 中最早的 Touch 对象被取消。

Touch 接口

Touch 对象表示在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作。

Touch 对象代表一个触点,每个触点包含位置、大小、形状、压力大小和目标元素属性。

Touch 接口没有父类,不继承任何属性,且该接口没有方法。

Touch 对象很多属性的值需要依赖硬件设备去获取。

例如,如果设备本身不支持侦测压感,那么 force 属性的值将始终是 0;对于 radiusX 和 radiusY 来说同样可能有这种情况,如果设备认为触点只是一个点而不是一个面,它们始终为 1。

clientX: 341.6842346191406
clientY: 229.68423461914062
force: 1
identifier: 0
pageX: 341.6842346191406
pageY: 229.68423461914062
radiusX: 12.105263710021973
radiusY: 12.105263710021973
region: null
rotationAngle: 0
screenX: 345.6000061035156
screenY: 356
target: canvas.element_canvas1

identifier(只读)

返回一个整数,唯一标识与触摸平面接触的点。这个值在这根手指(或触摸笔等)所引发的所有事件中保持一致,直到它离开触摸平面。

screenX(只读)

返回触点相对于屏幕左边沿的 X 坐标。不包含页面滚动的偏移量。

screenY(只读)

返回触点相对于屏幕上边沿的 Y 坐标。不包含页面滚动的偏移量。

clientX(只读)

返回触点相对于可见视区(Visual Viewport)左边沿的 X 坐标。不包括任何滚动偏移。这个值会根据用户对可见视区的缩放行为而发生变化。

clientY(只读)

返回触点相对于可见视区(Visual Viewport)上边沿的 Y 坐标。不包括任何滚动偏移。这个值会根据用户对可见视区的缩放行为而发生变化。

pageX(只读)

返回触点相对于 HTML 文档左边沿的 X 坐标。当存在水平滚动的偏移时,这个值包含了水平滚动的偏移。

pageY(只读)

返回触点相对于 HTML 文档上边沿的 Y 坐标。当存在垂直滚动的偏移时,这个值包含了垂直滚动的偏移。

target(只读)

返回触摸点最初接触的元素,即使这个触摸点已经移出那个元素的交互区域。

注意: 即使该元素在触摸过程中被移除,事件的 target 属性仍然会指向它,因此这个事件也不会冒泡到 window 或 document 对象。因此,如果有元素在触摸过程中可能被移除,最佳实践是将触摸事件的监听器绑定到这个元素本身,防止元素被移除后,无法再从它的上一级元素上侦测到从该元素冒泡的事件。

radiusX(只读)

返回能够包围用户和触摸平面的接触面的最小椭圆的水平轴(X 轴)半径。

radiusY(只读)

返回能够包围用户和触摸平面的接触面的最小椭圆的垂直轴(Y 轴)半径。

rotationAngle(只读)

返回以度为单位的旋转角,可能值是从 0 到 90。由 radiusX 和 radiusY 描述的正方向的椭圆,通过顺时针旋转这个角度后,能最精确地覆盖住用户和触摸平面的接触面的角度。

由 radiusX 和 radiusY 描述的正方向椭圆,顺时针旋转这个角度后,能最精确地覆盖用户和触摸平面的接触面。这三个值一起描述接触面的形状和大小。例如手指接触时可能是较大椭圆,触控笔则可能很小。

注意: radiusX、radiusY、rotationAngle 一起,描述了用户和触摸平面的接触面。这在面向非精确触摸设备(由手指直接操作的触摸屏)开发时非常有用。这些值描述了一个尽可能接近实际接触面(例如用户的指尖)的椭圆。

force(只读)

返回用户对触摸平面的压力大小,是一个从 0.0(没有压力)到 1.0(最大压力)的浮点数。

TouchList 接口

TouchList 接口代表一个触摸平面上所有触点的列表。例如,如果一个用户用三根手指接触屏幕(或者触控板),与之对应的 TouchList 会包含每根手指的 Touch 对象,总共三个。

TouchList 对象主要通过触摸事件的 touches、changedTouches、targetTouches 属性获取。

length 属性(只读)

返回 TouchList 中 Touch 对象的数量。

item() 方法

返回列表中以指定值作为索引的 Touch 对象。

常见问题

300ms 延迟

历史上,移动浏览器会在 touchendclick 之间等待约 300-350 ms,判断用户是否双击缩放。现行浏览器在视口设为 width=device-width 时,多数已取消该延迟。

解决方案一: 使用 touch-action: manipulation。禁止双击缩放手势,保留捏合缩放,现行优先做法。

html {
    touch-action: manipulation;
}

解决方案二: 禁用缩放。会损害无障碍,不推荐。部分浏览器可能仍不因此取消延迟。

<meta name="viewport" content="user-scalable=no" />

解决方案三: 改变视口宽度。页面按设备宽度适配后,浏览器不必再等双击缩放,多数会取消 click 的 300ms 延迟。Safari 旧版可能仍有例外。

<meta name="viewport" content="width=device-width" />

解决方案四: 引用 FastClick 库(历史方案,不推荐)。

原理: 移动端点击时常会触发 touchstart -> touchmove -> touchend -> click。FastClick 在监听到 touchend 时立即派发 click,并阻止原来的延迟点击。

缺点: 可能导致表单 input 获取焦点时唤起软键盘异常,以及其他 bug。现行项目应优先用视口和 touch-action,不必再引入该库。

参考链接

MDN - KeyboardEvent

MDN - 鼠标事件

MDN - TouchEvent

MDN Touch

MDN - TouchList

© lizhao all right reserved,powered by Gitbook文件修订时间: 2026-08-31 21:29:40

results matching ""

    No results matching ""