dblclick

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

在单个元素上单击两次鼠标的指针设备按钮 (通常是小鼠的主按钮) 时,将触发 dblclick 事件。

常规信息

规范

DOM L3

接口
MouseEvent
是否冒泡

可取消默认行为

目标对象

元素(Element)

默认行为

多种:开始 drag/drop 操作;开始文本选择、开始滚动或移动操作(若支持该操作时,可与鼠标中键协同)

属性

属性 类型 描述
target 只读 EventTarget 事件对象 (位于 DOM 树最上面的元素).
type 只读 DOMString 事件类型。
bubbles 只读 Boolean 是否冒泡
cancelable 只读 Boolean 是否可被取消
view 只读 WindowProxy document.defaultView (该文档的window 对象)
detail 只读 long (float) 在短时间内发生的连续点击次数的计数。
currentTarget 只读 EventTarget 被事件监听触发的节点。
relatedTarget 只读 EventTarget 对于 mouseover, mouseout, mouseentermouseleave 事件:值为与其互补的事件 (比如mouseenter 就为mouseleave). 否则为null.
screenX 只读 long 点击事件发生时鼠标对应的屏幕 x 轴坐标。
screenY 只读 long 点击事件发生时鼠标对应的屏幕 y 轴坐标。
clientX 只读 long 点击事件发生时鼠标对应的浏览器窗口的 x 轴坐标。
clientY 只读 long 点击事件发生时鼠标对应的浏览器窗口的 y 轴坐标。
button 只读 unsigned short 点击时按下的鼠标按钮:左键=0,中间按钮=1 (如果实现的话), 右键=2. 对于配置为左手使用按钮的操作被反转的鼠标,这些值从右向左读取。
buttons 只读 unsigned short 当鼠标事件被触发时按钮的 buttons: 左键=1,右键=2,中间按钮=4,第四个按钮 (通常是"返回")=8,第五个按钮 (通常是"前进")=16.若有两个或以上的按钮按下,返回以逻辑或运算形成的合并值。例如左键右键同时按下就返回 3 (=1 | 2). 更多信息.
ctrlKey 只读 boolean 当事件被触发时 ctrl 按键被按下时为 true,否则为 false。
shiftKey 只读 boolean 当事件被触发时 shift 按键被按下时为 true,否则为 false。
altKey 只读 boolean 当事件被触发时 alt 按键被按下时为 true,否则为 false。
metaKey 只读 boolean 当事件被触发时 meta 按键被按下时为 true,否则为 false。

规范

Specification
UI Events
# event-type-dblclick
HTML Standard
# handler-ondblclick

浏览器兼容性

BCD tables only load in the browser

参见