AdminLTE 4 handleEscapeKey() bypasses Bootstrap 5 keyboard: false on modals

[braytac]

AdminLTE 4 handleEscapeKey() bypasses Bootstrap 5 keyboard: false on modals

Environment: AdminLTE 4.x + Bootstrap 5.3.x (standalone) / any browser

Steps to reproduce

1. Open a modal with data-bs-keyboard="false" and data-bs-backdrop="static".
2. Press Escape → modal closes. Expected: stays open.
3. Open a second modal stacked on top of the first.
4. Press Escape → both modals close. Expected: only the topmost closes.

Root cause

initFocusManagement() registers a document-level keydown listener (bubble phase). Its handleEscapeKey() has two bugs:

Bug 1 — keyboard: false is ignored

handleEscapeKey(event) {
    const activeModal = document.querySelector('.modal.show');
    if (activeModal) {
        activeModal.querySelector('[data-bs-dismiss="modal"]')?.click(); // synthetic click
        event.preventDefault();
    }
}

[puikinsh]

Hi @braytac, thanks for the detailed bug report! This is now fixed in master (commit 3910990).

The root cause was that AdminLTE's accessibility handleEscapeKey() was intercepting Escape at the document level and synthetically clicking the dismiss button — completely bypassing Bootstrap's native modal keyboard handling.

The fix: when a modal is open, we now defer entirely to Bootstrap, which correctly handles keyboard: false, backdrop: static, and stacked modals on its own. The AdminLTE Escape handler now only handles dropdown menus.