当前位置: 首页>>代码示例 >>用法及示例精选 >>正文

JQuery .dblclick()用法及代码示例


用法 
.dblclick( handler ) => jQuery

说明：将事件处理程序绑定到 "dblclick" JavaScript 事件，或在元素上触发该事件。

  • 添加的版本：1.0.dblclick( handler )

    • handler
      类型：Function(Event eventObject)
      每次触发事件时执行的函数。

  • 添加的版本：1.4.3.dblclick( [eventData ], handler )

    • eventData
      类型：Anything
      包含将传递给事件处理程序的数据的对象。
    • handler
      类型：Function(Event eventObject)
      每次触发事件时执行的函数。

  • 添加的版本：1.0.dblclick()

    • 此签名不接受任何参数。

此方法是前两个变体中.on( "dblclick", handler ) 和第三个变体中.trigger( "dblclick" ) 的快捷方式。当元素被双击时，dblclick 事件被发送到元素。任何 HTML 元素都可以接收此事件。例如，考虑 HTML：

<div id="target">
  Double-click here
</div>
<div id="other">
  Trigger the handler
</div>
图 1 - 呈现的 HTML 的插图

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

$( "#target" ).dblclick(function() {
  alert( "Handler for .dblclick() called." );
});

现在此元素上的 double-clicking 显示警报：

.dblclick() 的处理程序被调用。

要手动触发事件，请在不带参数的情况下调用 .dblclick()：

$( "#other" ).click(function() {
  $( "#target" ).dblclick();
});

这段代码执行后，(单)点击触发处理程序也会提醒消息。

dblclick 事件仅在这一系列事件之后触发：

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

不建议将处理程序绑定到同一元素的 click 和 dblclick 事件。触发的事件顺序因浏览器而异，有些在 dblclick 之前收到两个 click 事件，而另一些则只收到一个。双击敏感度(检测为双击的两次单击之间的最长时间)可能因操作系统和浏览器而异，通常为 user-configurable。

其他注意事项：

  • 由于 .dblclick() 方法只是 .on( "dblclick", handler ) 的简写，因此可以使用 .off( "dblclick" ) 进行分离。

例子：

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

$( "p" ).dblclick(function() {
  alert( "Hello World!" );
});

双击切换背景颜色。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>dblclick demo</title>
  <style>
  div {
    background: blue;
    color: white;
    height: 100px;
    width: 150px;
 }
  div.dbl {
    background: yellow;
    color: black;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.5.0.js"></script>
</head>
<body>
 
<div></div>
<span>Double click the block</span>
 
<script>
var divdbl = $( "div" ).first();
divdbl.dblclick(function() {
  divdbl.toggleClass( "dbl" );
});
</script>
 
</body>
</html>

演示：

相关用法


注：本文由纯净天空筛选整理自jquery.com大神的英文原创作品 .dblclick()。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。