touchstart 事件在一个或多个触点与触控设备表面接触时被触发。
语法
在类似 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。
addEventListener("touchstart", (event) => {});
ontouchstart = (event) => {};
事件类型
一个 TouchEvent。继承自 Event。
TouchEvent
事件属性
此接口从其父接口 UIEvent 和 Event 继承属性。
- TouchEvent.altKey
- : 一个布尔值,表示在事件触发时 Alt 键是否被按下。
- TouchEvent.changedTouches
- : 一个包含所有的 Touch 对象的 TouchList,这些
Touch对象表示在前一个 touch 事件和当前的事件之间,状态发生变化的独立触点。
- : 一个包含所有的 Touch 对象的 TouchList,这些
- TouchEvent.ctrlKey
- : 一个布尔值,表示在事件触发时控制键是否被按下。
- TouchEvent.metaKey
- : 一个布尔值,表示在事件触发时 Meta 键是否被按下。
- TouchEvent.shiftKey
- : 一个布尔值,表示在事件触发时 Shift 键是否被按下。
- TouchEvent.targetTouches
- : 一个包含所有的 Touch 对象的 TouchList,这些
Touch对象表示当前与触摸表面接触的触点,且触点起始于事件发生的目标元素。
- : 一个包含所有的 Touch 对象的 TouchList,这些
- TouchEvent.touches
- : 一个包含所有的 Touch 对象的 TouchList,这些
Touch对象表示当前与表面接触的触点(不论事件目标或状态变化)。
- : 一个包含所有的 Touch 对象的 TouchList,这些
- TouchEvent.rotation
- : 自事件开始以来的旋转角度变化(以度为单位)。正值表示顺时针旋转;负值表示逆时针旋转。初始值为
0.0。
- : 自事件开始以来的旋转角度变化(以度为单位)。正值表示顺时针旋转;负值表示逆时针旋转。初始值为
- TouchEvent.scale
- : 自事件开始以来,两个数值之间的距离(缩放倍数)。表示事件开始至现在,触点距离的缩放倍数(浮点数)。小于 1.0 表示向内收缩(缩小),大于 1.0 表示向外松开(放大)。初始值为
1.0。
- : 自事件开始以来,两个数值之间的距离(缩放倍数)。表示事件开始至现在,触点距离的缩放倍数(浮点数)。小于 1.0 表示向内收缩(缩小),大于 1.0 表示向外松开(放大)。初始值为
示例
这些事件的代码示例可在这个专用页面查看:Touch 事件。
规范
浏览器兼容性
参见
- Touch 事件
- 以 Document 为目标的相同事件:Document/touchstart_event
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
