.mousemove()
.mousemove( handler )
描述:把某个事件函数绑定到JavaScript事件“mousemove”上,或者在某个元素上触发该事件。
- eventData类型:Anything一个对象,它包含了要传递给事件处理函数的数据。
- handler一个函数,在每次事件被触发时执行它。
该签名不接受任何参数。
该方法,在前两种变体中,是.on( "mousemove", handler )
的简写,在第三种变体中,是.trigger( "mousemove" )
的简写。
当鼠标指针在一个元素内部移动时,mousemove
事件被发送到该元素上。任何HTML元素都能接收该事件。
举个例子,设想下面的HTML:
<div id="target"> Move here </div> <div id="other"> Trigger the handler </div> <div id="log"></div>
事件处理函数可以绑定到目标上:
$( "#target" ).mousemove(function( event ) { var msg = "Handler for .mousemove() called at "; msg += event.pageX + ", " + event.pageY; $( "#log" ).append( "<div>" + msg + "</div>" ); });
现在,当鼠标指针在目标按钮内部移动时,消息会追加到<div id="log">中:
Handler for .mousemove() called at (399, 48) Handler for .mousemove() called at (398, 46) Handler for .mousemove() called at (397, 44) Handler for .mousemove() called at (396, 42)要想人为触发该事件,请不带参数地调用.mousemove()
。
$( "#other" ).click(function() { $( "#target" ).mousemove(); });
在代码执行之后,在触发按钮上点击,也将追加这条消息:
Handler for .mousemove() called at (undefined, undefined)在跟踪鼠标移动的时候,你通常需要知道鼠标指针的实际位置。这个事件对象会传给处理函数,它包含了一些关于鼠标坐标的信息。像.clientX
、.clientY
和.pageX
、.pageY
这样的属性是可用的,但是在不同的浏览器中有不同的支持。幸好jQuery规范化了.pageX
属性和.pageY
属性,从而可以在所有浏览器中使用它们。这些属性提供了鼠标指针相对于document的左上角的X坐标和Y坐标,如上面的示例输出所示。
请记住,每当鼠标指针移动时,就会触发mousemove
事件,哪怕只移动了一像素。这意味着在一小段时间内会生成几百次事件。如果处理函数不得不做任何明显的处理,或者如果对这个事件绑定了多个处理函数,这可能造成浏览器的严重的性能问题。因此,尽可能地优化mousemove
处理函数很重要,而且当不再需要它们时应尽快解除绑定。
一个常见的模式是在mousedown
事件的处理函数内部绑定mousemove
事件处理函数,而且在相应的mouseup
事件处理函数上对它解除绑定。如果实现了这一系列事件,请记住mouseup
事件可能会发送到别的HTML元素上,而不是发送到mousemove
事件绑定的元素。出于这个原因,mouseup
事件处理函数通常应该绑定到DOM树中层次较高的元素上,比如说<body>
上。
其它说明
- 因为
.mousemove()
方法是.on( "mousemove", handler )
的简写,所以可以使用.off( "mousemove" )
来分离。
示例
当鼠标在黄色div内部移动时,显示鼠标的坐标位置。坐标位置相对于窗口,在这个案例是指iframe。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>mousemove demo</title> <style> div { width: 220px; height: 170px; margin: 10px 50px 10px 10px; background: yellow; border: 2px groove; float: right; } p { margin: 0; margin-left: 10px; color: red; width: 220px; height: 120px; padding-top: 70px; float: left; font-size: 14px; } span { display: block; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <p> <span>Move the mouse over the div.</span> <span> </span> </p> <div></div> <script> $( "div" ).mousemove(function( event ) { var pageCoords = "( " + event.pageX + ", " + event.pageY + " )"; var clientCoords = "( " + event.clientX + ", " + event.clientY + " )"; $( "span:first" ).text( "( event.pageX, event.pageY ) : " + pageCoords ); $( "span:last" ).text( "( event.clientX, event.clientY ) : " + clientCoords ); }); </script> </body> </html>
演示结果