triggerHandler() 用來觸發被選元素的指定事件類型。名字只差幾個字,行為卻有三個關鍵差異,選錯很容易造成難查的 bug。
<a> 使用它觸發 click,瀏覽器不會真的跳轉。$('div').triggerHandler('click').css(...) 這種鏈式寫法會出錯。$(selector).triggerHandler(event, [param1, param2, ...])
參數:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>triggerHandler 示例</title>
<style type="text/css">
div { width: 200px; height: 200px; border: 1px solid blue; }
</style>
<script type="text/javascript" src="mytest/jQuery/jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function () {
$("div").click(function () {
$("div").append("博客園");
});
$("button").click(function () {
$("div").triggerHandler("click");
});
});
</script>
</head>
<body>
<div></div>
<button>查看效果</button>
</body>
</html>
最典型的場景是表單驗證。你想在送出前跑一次既有的驗證邏輯,但不希望真的觸發 submit 造成頁面跳轉,這時 triggerHandler('submit') 剛好合適,因為它還會把驗證函式的回傳值交給你:
var isValid = $("#myForm").triggerHandler("submit");
if (isValid === false) {
// 驗證未通過,留在當前頁
}
另一個常見用法是「取得第一個元素的狀態」而不影響其他元素,例如只檢查驗證訊息的第一個顯示結果。
它不觸發自訂事件的完整生命週期。若你的邏輯依賴冒泡(例如文件層級的統一事件處理),triggerHandler() 會跳過那段,行為就與真實操作不同。
它只跑第一個元素。對集合呼叫時,其餘元素的事件處理函式完全不會執行。若需要全部執行,用 .each() 搭配 trigger(),或直接用 trigger()。
回傳值只有第一個 handler 的。多個函式綁在同一事件上時,只會拿到最後執行那個的回傳值,別依賴它做複雜判斷。