内容目录
mouseout()
函数用于为每个匹配元素的mouseout事件绑定处理函数。该函数还可用于触发mouseout事件。此外,你还可以额外传递给事件处理函数一些数据。
mouseout事件会在鼠标离开某个元素时触发。它与mouseleave事件相似,但mouseleave事件只会在鼠标离开当前元素时触发,而mouseout事件会在鼠标离开当前元素及其任何后代元素时触发(换句话说,mouseout事件支持冒泡)。
此外,你可以为同一元素多次调用该函数,从而绑定多个事件处理函数。触发mouseout事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。
要删除通过mouseout()
绑定的事件,请使用unbind()函数。
该函数属于jQuery
对象(实例)。
语法
jQueryObject.mouseout( [[ data ,] handler ] )
如果指定了至少一个参数,则表示绑定mouseout事件的处理函数;如果没有指定任何参数,则表示触发mouseout事件。
参数
参数 | 描述 |
---|---|
data | 可选/任意类型触发事件时,需要通过event.data传递给事件处理函数的任意数据。 |
handler | 可选/Function类型指定的事件处理函数。 |
jQuery 1.4.3 新增支持:mouseout()
支持data
参数。
参数handler
中的this
指向当前DOM元素。mouseout()
还会为handler
传入一个参数:表示当前事件的Event对象。
返回值
mouseout()
函数的返回值为jQuery类型,返回当前jQuery对象本身。
示例&说明
请参考以下HTML示例代码:
<div>
<p id="p1">CodePlayer</p>
<p id="p2">专注于编程技术开发分享</p>
<p id="p3">https://codeplayer.vip</p>
</div>
<span id="msg"></span>
现在,我们为<div>元素的mouseout事件绑定处理函数(可以绑定多个,触发时按照绑定顺序依次执行):
mouseleave只会在鼠标离开<div>元素时才会触发,而mouseout会在鼠标离开<div>元素或任何<p>元素时触发。例如:鼠标从p1进入p2(即离开p1)会触发<div>元素的mouseout事件,但不会触发<div>元素的mouseleave的事件。
var count = 0;
//记录触发div元素的mouseout事件的次数
$("div").mouseout(function(){
$("#msg").html( "触发mouseout的次数:" + ( ++count ) );
});
//鼠标离开div元素就改变背景颜色
$("div").mouseout(function(){
$(this).css( "color", "purple" );
});
// 触发mouseout事件
// $("div").mouseout( );
运行代码(以下代码请自行复制到演示页面运行)
我们还可以为事件处理函数传递一些附加的数据。此外,通过jQuery为事件处理函数传入的参数Event对象,我们可以获取当前事件的相关信息(比如事件类型、触发事件的DOM元素、附加数据等):
var cssStyle = { background: "#eee", color: "blue" };
//鼠标离开div元素就设置指定的css样式
$("div").mouseout( cssStyle, function(event){
var style = event.data;
$(this).css( style );
} );
0 条评论
撰写评论