介面元件 核心 B · 官方指南或詞彙 平台: 網頁

Disclosure

展開收合控制

展開收合控制是一個顯示或隱藏相關區段的按鈕。它也會告訴軟體該區段是否已展開。

動手試試看
也有人這樣說 Disclosure顯示隱藏展開器

動手試試看

展開收合控制

展開收合控制是一個顯示或隱藏相關區段的按鈕。它也會告訴軟體該區段是否已展開。

適合使用

用在使用者可以自行決定是否查看的補充內容。隱藏這些內容時,不能妨礙主要任務。

生活中的例子

在帳務頁按下「顯示費用明細」後,會出現三筆項目,`aria-expanded` 也會改為 `true`。焦點仍留在按鈕上。即使 JavaScript 失效,總額仍看得到。

主要部分

  1. 01切換按鈕
  2. 02展開狀態
  3. 03受控區域

什麼時候用

用在使用者可以自行決定是否查看的補充內容。隱藏這些內容時,不能妨礙主要任務。

什麼時候不要用

不要把它當成選單或表單選項,也不要把必讀的錯誤或說明藏在裡面。

程式裡的名稱

button aria-expanded aria-controls + controlled region

上線前要檢查

讓輔助工具知道控制項的名稱(無障礙名稱)、用途(角色)、值與狀態。檢查鍵盤操作、清楚可見的焦點、點按範圍、停用與忙碌狀態、回饋及復原。

可以直接複製的需求

預期成果:使用 展開收合控制 (Disclosure) 解決這項需求,同時保留使用者目前的操作脈絡。 使用者情境:在帳務頁按下「顯示費用明細」後,會出現三筆項目,`aria-expanded` 也會改為 `true`。焦點仍留在按鈕上。即使 JavaScript 失效,總額仍看得到。 建議介面模式:展開收合控制 (Disclosure)。 適用理由:用在使用者可以自行決定是否查看的補充內容。隱藏這些內容時,不能妨礙主要任務。 不應使用的情況:不要把它當成選單或表單選項,也不要把必讀的錯誤或說明藏在裡面。 產品要求:定義預設、載入、沒有內容、錯誤、成功與復原狀態。保留使用者已輸入的內容,每個操作後都提供清楚回饋。 無障礙與韌性:使用結構正確的 HTML(語意化 HTML)和完整鍵盤操作。焦點要清楚可見,版面縮放後仍要好用。也要提供減少動態效果。遵守專案現有規則。除非專案已採用,否則不要新增介面元件庫。 驗收條件:主要任務可只用鍵盤完成,在 320px 寬度也能正常使用。焦點與狀態變化可被輔助工具讀出。載入、失敗、重試、取消與減少動態效果都已驗證。 證據與限制(證據邊界):它只代表該來源的官方說法。其他平台或團隊可能有不同用法。 待確認:產品文字、資料來源、分析事件、支援裝置與語系,以及平台特有限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 展開收合控制 (Disclosure)。 定義:展開收合控制是一個顯示或隱藏相關區段的按鈕。它也會告訴軟體該區段是否已展開。 正式環境檢查:讓輔助工具知道控制項的名稱(無障礙名稱)、用途(角色)、值與狀態。檢查鍵盤操作、清楚可見的焦點、點按範圍、停用與忙碌狀態、回饋及復原。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

B
這個術語有多正式?

官方指南或詞彙

列出的平台、框架、專案或專業組織,有發布這個術語的官方指南。

它只代表該來源的官方說法。其他平台或團隊可能有不同用法。

適用範圍
只包含來源有說明的內容:正式名稱、定義、互動行為、鍵盤行為、無障礙
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · W3C WAI · 穩定 Disclosure Pattern 適用範圍: 正式名稱、定義、互動行為、鍵盤行為、無障礙 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 互動行為, 鍵盤行為, 無障礙

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。