我們平常綁事件,對象幾乎都是頁面上「已經存在」的元素。但當元素是執行期間才由 JavaScript 產生的,事情就不一樣了。
在開發 app 專案時,我動態建立了一個元素,接著需要為它綁定 click——點擊時在該元素右側複製一份出來。直覺的寫法如下:
$("#動態元素").click(function(){
console.log("事件已被綁定");
});
結果一點反應都沒有,連測試用的 console 都沒印出來。同事一句「你這個元素是不是動態產生的?」才點醒我。
click() 與 bind() 都是直接綁定:它們在執行的那一刻,去 DOM 中尋找符合選擇器的元素並掛上事件處理器。如果那個元素當時還不存在,選擇器選到的是空集合,自然也就什麼都沒綁上。之後元素被加進來時,不會有人回頭幫它補綁。
解決思路是事件委派(event delegation):把監聽器掛在「一定存在」的祖先元素上,利用事件冒泡攔下子元素的觸發。因為監聽器掛在父層而非子層,所以之後才加入的子元素也同樣能被攔下。
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<title>動態元素綁定事件測試</title>
</head>
<body>
<div id="container">
<button id="addSpan">添加元素</button>
</div>
<p id="disc">提示語句</p>
<script src="https://code.jquery.com/jquery-1.7.2.min.js"></script>
<script type="text/javascript">
$("#addSpan").click(function(){
$("#container").append($("<button id='clickAddEle'>click</button>"));
$("#container").append($("<button id='bindAddEle'>bind</button>"));
$("#container").append($("<button id='liveAddEle'>live</button>"));
$("#container").append($("<button id='onAddEle'>on</button>"));
});
// 1. click —— 對動態元素無效
$("#clickAddEle").click(function(){
$("#disc").html("click 為動態元素綁定事件成功");
});
// 2. bind —— 同樣無效
$("#bindAddEle").bind("bind", function(){
$("#disc").html("bind 為動態元素綁定事件成功");
});
// 3. live —— 有效(jQuery 1.7 起已 deprecated)
$("#liveAddEle").live("click", function(event){
$("#disc").html("live 為動態元素綁定事件成功");
});
// 4. on —— 掛在父元素上並傳入子元素選擇器,有效且為目前推薦寫法
$("#container").on("click", "#onAddEle", function(event){
$("#disc").html("on 為動態元素綁定事件成功");
});
</script>
</body>
</html>
打開頁面點「添加元素」後會產生四個按鈕,分別對應上述四種方法。點下去若下方描述文字有更新,就代表該方法的綁定生效。
為動態元素綁事件,click()、bind() 以及直接對該元素呼叫的 on() 都無效。可行的只有兩條路:
live()——它能為「尚未建立」的元素綁定,但自 jQuery 1.7 起已被標記為 deprecated,1.9 之後正式移除,不建議再用。on() 掛在該元素的父層或更上層,並把目標元素選擇器作為第二個參數傳入——這是目前的標準寫法。還有一個容易踩到的細節:第二種寫法要求「掛載點本身在綁定時就必須存在」。如果祖先容器也是動態產生的,就得再往上找一層真正穩定的元素(通常直接用 document)。另外,on() 是 jQuery 1.7 才加入的 API,版本更低時請改用 delegate()。