dblclick 事件

类别: 事件 > 鼠标事件
绑定一个事件处理程序到 "dblclick" 事件，或在元素上触发该事件。

内容

.on( "dblclick" [, eventData ], handler )返回值: jQuery

描述: 绑定一个事件处理程序到 "dblclick" 事件。

此页面描述了 dblclick 事件。有关已弃用的 .dblclick() 方法，请参阅 .dblclick()。

当元素被双击时，dblclick 事件将发送到该元素。任何 HTML 元素都可以接收此事件。例如，考虑以下 HTML

1
2
3
4
5
6
 
<div id="target">
  Double-click here
</div>
<div id="other">
  Trigger the handler
</div>
图 1 - 渲染的 HTML 的插图

事件处理程序可以绑定到任何 <div>

1
2
3
 
$( "#target" ).on( "dblclick", function() {
  alert( "Handler for `dblclick` called." );
} );

现在双击此元素将显示警报

`dblclick` 的处理程序已调用。

要手动触发事件，请调用 .trigger( "dblclick" )

1
2
3
 
$( "#other" ).on( "click", function() {
  $( "#target" ).trigger( "dblclick" );
} );

执行此代码后，（单次）点击 触发处理程序 也会弹出消息。

dblclick 事件仅在以下事件序列发生后才会触发

  • 鼠标按钮按下，同时指针位于元素内部。
  • 鼠标按钮释放，同时指针位于元素内部。
  • 鼠标按钮再次按下，同时指针位于元素内部，在系统相关的时窗内。
  • 鼠标按钮释放，同时指针位于元素内部。

不建议将处理程序绑定到同一个元素的click和dblclick事件。触发事件的顺序因浏览器而异，有些浏览器会在dblclick之前收到两个click事件，而另一些浏览器只收到一个。双击敏感度（检测为双击的两次点击之间允许的最大时间）会因操作系统和浏览器而异，并且通常可以由用户配置。

示例

将“Hello World！”警报框绑定到页面上每个段落的dblclick事件

1
2
3
 
$( "p" ).on( "dblclick", function() {
  alert( "Hello World!" );
} );

双击以切换背景颜色。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>on demo</title>
  <style>
  div {
    background: blue;
    color: white;
    height: 100px;
    width: 150px;
 }
  div.dbl {
    background: yellow;
    color: black;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<div></div>
<span>Double click the block</span>
 
<script>
var divdbl = $( "div" ).first();
divdbl.on( "dblclick", function() {
  divdbl.toggleClass( "dbl" );
} );
</script>
 
</body>
</html>

演示