LESSON-17 · TOPIC 04

Escape 關閉與焦點歸還

能讓鍵盤使用者按 Escape 關閉內容後回到原控制項。

code-edit事件傳遞與焦點歸還|Escape 關閉與焦點歸還本頁只練一個責任

本頁只練什麼

能讓鍵盤使用者按 Escape 關閉內容後回到原控制項。

只把內容隱藏卻讓焦點留在已移除區域,鍵盤使用者會失去目前位置。

要修改的檔案:files/starter/main.js

定位:先在每一步讀 document.activeElement.id。|依 module-4 定位,只修改「Escape 關閉與焦點歸還」的責任。

任務情境

先結果,再原理;完成後要能說出自己看見的證據。

現在的問題

使用者關閉 FAQ 詳情後不知道焦點在哪。

起始狀態:opener 未展開,panel hidden。

完成後要看到

expanded=false、panelHidden=true、activeId=faq-opener。

驗收證據:expanded=false、panelHidden=true、activeId=faq-opener

何時會用到

選單、對話框、popover 與可展開內容。

常見混淆:focus return 不是把 DOM 視覺捲回去;它更新 document.activeElement。

觀念與最小範例

這段程式是理解起點,不是要你直接跳過 Starter。

Escape 關閉與焦點歸還 Escape dismissal and focus return

關閉後把鍵盤游標送回剛才打開它的按鈕。

正式說法:dismiss handler 在 Escape keydown 後同步更新 visibility/ARIA state,並以 HTMLElement.focus() 恢復控制焦點。

if (event.key==='Escape') { close(); opener.focus(); }。

三步完成本主題

每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。

  1. Step 1|先看見目前缺口,不急著貼答案。

    檔案:files/starter/main.js 定位:先在每一步讀 document.activeElement.id。

    要做:先重新載入 Starter,記錄目前畫面、DOM、Computed、Console 或文件內容。

    預期:能指出「先在每一步讀 document.activeElement.id。」目前的缺口。

    證據:保存 files/starter/main.js 的目前狀態,並指出下一步只會修改哪個檔案責任。

    卡住先查:確認開啟的是 files/starter/main.js,且定位到 先在每一步讀 document.activeElement.id。。

  2. Step 2|只修改本主題的一個責任。

    檔案:files/starter/main.js 定位:先在每一步讀 document.activeElement.id。

    要做:展開 panel,派送 Escape,更新 aria-expanded/hidden 並 focus opener。

    預期:expanded=false、panelHidden=true、activeId=faq-opener。

    證據:expanded=false、panelHidden=true、activeId=faq-opener

    卡住先查:先在每一步讀 document.activeElement.id。

  3. Step 3|重新載入並以證據驗收,不以『看起來差不多』判定完成。

    檔案:files/starter/main.js 定位:先在每一步讀 document.activeElement.id。

    要做:重新整理頁面,再逐項比對預期結果與 evidence。

    預期:expanded=false、panelHidden=true、activeId=faq-opener。

    證據:expanded=false、panelHidden=true、activeId=faq-opener

    卡住先查:先在每一步讀 document.activeElement.id。

觀察示範

這個示範只讓你看懂概念,不會替你修改 Starter,也不會自動宣告完成。

Escape 關閉與焦點歸還runtime fixture · read-only demo
本主題示範畫面:

驗收證據

勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。

提示 1|方向

關閉 UI 與恢復焦點是兩個步驟。

提示 2|關鍵片段

Escape branch 最後呼叫 opener.focus()。

提示 3|完整解答與原因

完整解答與原因:Escape 時將 aria-expanded=false、panel.hidden=true,再 opener.focus();因為被關閉內容不應繼續保有焦點。

完成後進入下一階段,或回到入口選下一個 topic。

開始 Starter →回到主題清單