當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文

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()。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。