加载中...

dblclick()


概述    .dblclick( handler(eventObject) )

返回值:jQuery

描述:为JavaScript 的 "dblclick" 事件绑定一个处理函数,或者触发元素上的 "dblclick" 事件。

  • V : 1.0.dblclick( handler(eventObject) )

    • handler(eventObject)
      类型: Function()
      每次事件触发时会执行的函数。
  • V : 1.4.3.dblclick( [eventData ], handler(eventObject) )

    • eventData
      类型: Anything
      一个对象,它包含的数据键值对映射将被传递给事件处理程序。
    • handler(eventObject)
      类型: Function()
      每次事件触发时会执行的函数。
  • V : 1.0.dblclick()

    • 这个方法不接受任何参数

这个函数的前两个用法是 .bind('dblclick', handler) 的快捷方式,第3个不带参数的用法是 .trigger('dblclick') 的快捷方式。一个元素被双击时将触发 dblclick 事件。任何HTML元素都可以收到此事件。请看下面的HTML:

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

这个事件处理器可以绑定到任何 <div>:

  1. $('#target').dblclick(function() {
  2. alert('Handler for .dblclick() called.');
  3. });

现在,如果我们双击这个元素,警报显示:

Handler for .dblclick() called.

应用不带参数的.dblclick(),我们可以手动触发这个事件:

  1. $('#other').click(function() {
  2. $('#target').dblclick();
  3. });

这些代码执行后,单击Trigger the handler同样警报显示。

dblclick事件只有在满足以下条件的情况下才能被触发:

  • 鼠标指针在元素里面时点击。
  • 鼠标指针在元素里面时释放。
  • 鼠标指针在元素里面时再次点击,点击间隔时间,是系统而定。
  • 鼠标指针在元素里面时再次释放。

在同一元素上同时绑定 clickdblclick 事件是不可取的。各个浏览器事件触发的顺序是不同的,一些浏览器在dblclick之前接受两个 click 事件 ,而和其它浏览器只接受一个 click 事件。用户往往可通过不同的操作系统和浏览器配置双击灵敏度(两次点击之间的最大时间被检测为双击)。

Additional Notes(其他注意事项):

  • .dblclick()方法只是作为.on( "dblclick", handler )的一个速记写法,移除该事件可以使用.off( "dblclick" )

示例

实例

在段落上双击时,显示 "Hello World!" 提示框:

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

实例

双击时改变背景色。

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <style>
  5. div { background:blue;
  6. color:white;
  7. height:100px;
  8. width:150px;
  9. }
  10. div.dbl { background:yellow;color:black; }
  11. </style>
  12. <script src="http://code.jquery.com/jquery-latest.js"></script>
  13. </head>
  14. <body>
  15. <div></div><span>Double click the block</span>
  16. <script>
  17. var divdbl = $("div:first");
  18. divdbl.dblclick(function () {
  19. divdbl.toggleClass('dbl');
  20. });
  21. </script>
  22. </body>
  23. </html>

运行一下


还没有评论.