mousedown event

所属分类：Events > Mouse Events 英文文档：mousedown event

.mousedown( handler(eventObject) )返回: jQuery

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

  • 添加的版本: 1.0.mousedown( handler(eventObject) )

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

  • 添加的版本: 1.4.3.mousedown( [eventData ], handler(eventObject) )

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

  • 添加的版本: 1.0.mousedown()

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

这个方法的前两个用法是 .bind('mousedown', handler) 的快捷方式，第3个不带参数的用法是 .trigger('mousedown') 的快捷方式。

当鼠标指针在元素上和按下鼠标键，mousedown事件被发送到这个元素。任何HTML元素都可以收到此事件。

举例来说，请看下面的HTML：

1
2
3
4
5
6
 
<div id="target">
  Click here
</div>
<div id="other">
  Trigger the handler
</div>

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

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

现在，如果我们点击这个元素，警报显示：

Handler for .mousedown() called.

我们也可以通过点击其它元素，手动触发另一个元素上的该事件：

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

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

任何鼠标按钮被按下时mousedown事件就会被发送。若要区分是哪个键被按下了，我们可以使用 event 对象的which属性。并非所有浏览器都支持这个属性（在 IE 中，要使用 button 属性来代替），但是jQuery对该属性进行了标准化，因此你可以放心的在任何浏览器中使用该属性。敲击鼠标左键which的值是1，敲击鼠标中键which的值是2，敲击鼠标右键which的值是。

此事件主要用于确保主要按钮是用来开始拖动操作;如果不进行这样的判断，当用户尝试使用上下文菜单，可能会出现奇怪的结果。虽然可以通过这些属性，来检测鼠标中键和右键的点击，但不一定是可靠的。例如，在 Opera 和 Safari 中，默认情况下是无法检测鼠标右键的点击的。

如果在一个元素按住了鼠标不放，并且拖动鼠标离开这个元素，并释放鼠标键，这仍然是算作mousedown事件。在大多数的用户界面，这个动作的顺序被视为一个“取消”的按键，所以通常最好使用click事件，除非我们知道mousedown事件针对一个特定情况较好。

例子:

当MouseUp和MouseDown事件触发时，显示文本时。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
<!DOCTYPE html>
<html>
<head>
  <script src="https://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
  <p>Press mouse and release here.</p>
 
<script>
    $("p").mouseup(function(){
      $(this).append('<span style="color:#F00;">Mouse up.</span>');
    }).mousedown(function(){
      $(this).append('<span style="color:#00F;">Mouse down.</span>');
    });
 
</script>
 
</body>
</html>

Demo: