Bootstrap dựa trên HTML、CSS 與 JavaScript 打造,凭着樣式完整、元件齊全,長年是最受歡迎的前端框架之一。不過框架再成熟,實際開發時還是會遇到一些邊角問題,本文記錄的就是一個很多人碰過的 Modal 鍵盤操作失效的狀況。
使用 Bootstrap 的 Modal 元件時,按 Esc 鍵理應可以關掉彈窗,卻完全沒有反應。即使明確在初始化時傳入 keyboard 選項也一樣無效:
$('#editFormItemModal').modal({ show: true, keyboard: true });
這個問題大約從 2.1 版之後開始出現。Bootstrap 的鍵盤事件是綁在 Modal 元素上,而元素若無法取得焦點,鍵盤事件自然不會觸發。解法非常簡單——幫 Modal 的 div 補上一個 tabindex 屬性,讓它可以被聚焦:
<div class="fade modal" tabindex="-1">
加上 tabindex="-1" 之後,元素能被程式化聚焦但不會出現在 Tab 鍵的切換順序中,剛好符合彈窗的需求,Esc 關閉也就恢復正常了。
如果你用的是較新版本的 Bootstrap,鍵盤事件失效通常還可能來自這幾個原因:一是頁面中有其他程式呼叫了 e.preventDefault() 把事件吃掉;二是 Modal 尚未完全顯示就搶著操作;三是同時開啟多層 Modal,焦點落在上層遮罩上。遇到時可以先在 DevTools 的 Elements 面板確認 tabindex 是否存在,再逐步往事件傳遞的方向排查。