大网数据广告活动
Web 标准与前端开发

Element:click 事件

· 52CE 我爱测

定点设备按钮(例如鼠标的主按钮)在指针位于元素内时被按下并释放。 - 在该元素上执行了触摸手势。 - 任何等效于点击的用户交互,例如在元素获得焦点时按下 <kbd>Space</kbd> 键或 <kbd>Enter</kbd> 键。请注意,这仅适用于具有默认按键事件处理器的元素,因此不包括通过设置 `tabindex` 属性而变得可聚焦的其他元素。

UI Events

当发生以下任一情况时,元素会收到 click 事件:

  • 定点设备按钮(例如鼠标的主按钮)在指针位于元素内时被按下并释放。
  • 在该元素上执行了触摸手势。
  • 任何等效于点击的用户交互,例如在元素获得焦点时按下 <kbd>Space</kbd> 键或 <kbd>Enter</kbd> 键。请注意,这仅适用于具有默认按键事件处理器的元素,因此不包括通过设置 tabindex 属性而变得可聚焦的其他元素。

如果在某个元素上按下按钮,并在释放按钮之前将指针移出该元素,则事件会在同时包含这两个元素的最具体的祖先元素上触发。

click 会在 Element/mousedown_event 和 Element/mouseup_event 事件均已按该顺序触发之后触发。

该事件是与设备无关的事件——意味着它可由触摸、键盘、鼠标以及辅助技术提供的任何其他机制激活。

语法

在类似 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。

addEventListener("click", (event) => { })

onclick = (event) => { }

事件类型

PointerEvent,继承自 MouseEvent。

PointerEvent

[!NOTE] 在规范的早期版本中,该事件的事件类型是 MouseEvent。更多信息请参见浏览器兼容性。

使用说明

传入 click 事件处理器的 PointerEvent 对象,其 UIEvent/detail 属性会被设置为 Event.target 被点击的次数。换言之,双击时 detail 为 2,三击时为 3,依此类推。该计数器会在一段短暂的无点击间隔后重置;该间隔具体多长可能因浏览器和平台而异。该间隔也很可能受用户偏好设置影响;例如,无障碍选项可能会延长该间隔,以便更容易通过自适应界面执行多次点击。

示例

本示例显示在 button 上连续点击的次数。

HTML

<button>点击</button>

JavaScript

const button = document.querySelector("button");

button.addEventListener("click", (event) => {
  button.textContent = `点击次数:${event.detail}`;
});

结果

尝试快速、反复地点击按钮以增加点击次数。如果在点击之间稍作停顿,计数将会重置。

示例

规范

浏览器兼容性

参见

  • 学习:事件介绍
  • Element/auxclick_event
  • Element/contextmenu_event
  • Element/dblclick_event
  • Element/mousedown_event
  • Element/mouseup_event
  • Element/pointerdown_event
  • Element/pointerup_event

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。