這幾天工作上遇到一個不算罕見但很磨人的問題:頁面裡有一個可編輯的 div,裡面還包著一個可編輯的 span,我希望在 span 上按下按鍵時能觸發自定的鍵盤事件。埋了監聽之後卻發現——完全沒反應。查了國外討論串、把方案整理成中文筆記如下。
測試用的 JavaScript:
$(function () {
$('#someid').keypress(function (event) {
alert('test');
});
});
HTML 結構:
<div id="mydiv" contenteditable="true"> editable follows:<span id="someid" contenteditable="true">Some TEXT</span> </div>
在瀏覽器裡實際操作會發現:滑鼠點在 Some TEXT 上打字,alert('test') 完全不會跳出來。
關鍵在於焦點。在 contenteditable 容器裡點擊文字,鍵盤事件是由外層那個真正持有焦點的可編輯區塊(這裡是 div)發出的,事件從 div 開始往上冒泡,而 span 位於 div 之內、不在冒泡路徑上,所以掛在 span 上的 keypress 永遠等不到。一句話總結:不是事件被吃掉,而是事件根本不是從 span 出發的。
元素動態插入後,立刻呼叫 .focus() 把焦點搶過來:
function AppendSpan() {
$('#mydiv').append('<span id="someid" contenteditable="true">Some TExt</span>');
// 插入後立刻將焦點移到該元素上
$('#someid').keypress(function (event) {
alert(this.id);
}).focus();
}
這招在 Firefox、Opera、Chrome、Safari、IE8 上都驗證可行。缺點是焦點被強制搶走,使用者可能覺得很突兀,適合用於「新增後就是要立刻編輯」的情境。
把可編輯的 span 包在一個明確標示為「不可編輯」的外層裡,讓瀏覽器把它當成獨立島嶼處理:
function AppendSpan() {
$('#mydiv').append(
'<span contenteditable="false"><span id="someid" contenteditable="true">Some TExt</span></span>'
);
$('#someid').keypress(function (event) {
alert('test');
});
}
$(function () {
$('#mydiv').keypress(function (event) { AppendSpan(); });
});
<div id="mydiv" contenteditable="true"> editable follows: </div>
如果 span 只在特定階段需要互動,最乾脆的做法是在那個階段把父層的 contenteditable 拿掉:
function AppendSpan() {
$('#mydiv')
.removeAttr('contenteditable')
.append('<span id="someid" contenteditable="true">Some TExt</span>');
$('#someid').keypress(function (event) {
alert('test');
});
}
$(function () {
$('#mydiv').keypress(function (event) { AppendSpan(); });
});
attr('contenteditable', 'true') 還原,否則使用者會發現整段文字突然不能編輯了。另外提醒一個實作上的小陷阱:contenteditable 巢狀時,鍵盤事件的冒泡行為在各瀏覽器版本間有過一些差異,若你的專案需要支援舊版 IE,最好把這三種寫法都實測一遍再定案。與其依賴事件冒泡,把監聽掛在真正持有焦點的那一層、再判斷 event.target,往往比跟焦點機制對抗來得省心。