Bootstrap 提供了不少好用的元件,Modal(彈跳視窗)是最常用的一個。不過不少人遇到過這樣的狀況:按 Esc 鍵關不掉視窗,即使明確傳入 keyboard 選項也一樣沒反應。
典型的初始化寫法如下,看起來完全正確:
$('#editFormItemModal').modal({ show: true, keyboard: true });
但 Esc 就是無效。這個問題大約從 2.1 版之後出現,原因不在 keyboard 參數,而在 Modal 對焦(focus)的機制。
Bootstrap 的 Modal 靠 focus trap 把鍵盤焦點留在視窗內,Esc 的監聽也建立在「焦點確實落在 Modal 上」這個前提。如果那個 div 沒有可聚焦的依據,焦點就沒能真正進入視窗,Esc 自然也收不到。替 Modal 的容器加上 tabindex 屬性即可:
<div class="fade modal" tabindex="-1">
tabindex="-1" 的意思是「這個元素可以被程式化聚焦,但不進入 Tab 鍵的走訪順序」,正好符合 Modal 容器的需求:JS 能 focus 它,使用者按 Tab 時又不會跳上去。
如果加了 tabindex 仍然無效,可以依序確認:
一是元素 id 與初始化時的選擇器是否一致,拼錯一個字就會靜默失敗。
二是同一頁面上是否有多個 Modal,或 yourself 有另一段程式去覆寫了 $('#xxx').modal() 的設定。
三是 Bootstrap 的 JS 是否正確載入,以及版本之間是否存在變更;官方文件裡 keyboard 的預設值一直是 true,若行為與預期不符,通常代表初始化沒真正作用到那個元素。
四是若你有自行攔截 keydown 或 keyup 的事件,記得別把 Esc 的 propagation 擋掉。
問題很簡單,修復起來也只要一個屬性,希望這篇能幫你省下搜尋的時間。