hover()
函數用於為每個匹配元素的hover事件綁定處理函數。
hover事件就是鼠標懸停事件。此外,你還可以額外傳遞給事件處理函數一些數據。
此外,你可以為同一元素多次調用該函數,從而綁定多個事件處理函數。觸發hover事件時,jQuery會按照綁定的先后順序依次執行綁定的事件處理函數。
要刪除通過hover()
綁定的事件,請使用unbind()函數。
該函數屬於jQuery
對象(實例)。
語法
hover()
函數主要有以下兩種用法:
用法一:
jQueryObject.hover( handlerIn , handlerOut )
分別指定鼠標移入、移出元素時的事件處理函數。
用法二:jQuery 1.4 新增支持該用法。
jQueryObject.hover( handlerInAndOut )
用法一的變體。當鼠標移入、移出元素時的事件處理函數相同時,只需直接傳入一個處理函數作為參數即可。
參數
請根據前面語法部分所定義的參數名稱查找對應的參數。
參數 | 描述 |
---|---|
handlerIn | Function類型鼠標移入元素時需要執行的處理函數。 |
handlerOut | Function類型鼠標移出元素時需要執行的處理函數。 |
handlerInAndOut | Function類型鼠標移入、移出元素時需要執行的處理函數。 |
hover()
函數的所有參數都是函數,函數內的this
指向當前DOM元素。hover()
還會為其傳入一個參數:表示當前事件的Event對象。
返回值
hover()
函數的返回值為jQuery類型,返回當前jQuery對象本身。
示例&說明
hover()
函數與on()函數具有以下等價代碼:
$( selector ).hover( handlerInOut );
// 等價於
$( selector ).on( "mouseenter mouseleave", handlerInOut );
請參考下面這段初始HTML代碼:
<a id="a1" href="http://www.365mini.com">CodePlayer</a>
<a id="a2" href="http://www.365mini.com/doc">中文手冊</a>
現在,我們為所有a元素的hover事件綁定處理函數(可以綁定多個,觸發時按照綁定順序依次執行):
// 為所有button元素的hover事件綁定處理函數
// 鼠標移入鏈接時,顯示紅色;移出鏈接時,顯示藍色
$("a").hover( function(event){
$(this).css("color", "red");
}, function(event){
$(this).css("color", "blue");
} );
// 為所有button元素的hover事件綁定處理函數
// 鼠標移入、移出鏈接時,都去掉下划線
$("a").hover( function(event){
$(this).css("textDecoration", "none");
} );