介面元件 核心 A1 · 正式標準 平台: 網頁

Current Item (aria-current)

目前項目

aria-current 會告訴輔助工具,相關項目中哪一個是目前位置。它不代表項目已被選取。

看看怎麼運作
也有人這樣說 Current Item (aria-current)目前項目指示目前頁面標記目前步驟標記

看看怎麼運作

原創情境範例目前項目
無障礙介面規則目前項目one item in a set + aria-current=page|step|date|location|time|true
麵包屑導覽1 current
首頁專案Aurora
目前頁面Auroraaria-current="page"
ATAurora,目前頁面可見標記+輔助工具語意page
相關項目集合剛好一個目前項目
通過同一組中只有一個項目具有可見和語意標記。避免目前位置和已選取選項是不同狀態。
one item in a set + aria-current=page|step|date|location|time|trueA11Y
目前項目無障礙介面實作

另一個例子

麵包屑導覽包含「首頁」、「專案」和「Aurora」。只有 Aurora 設定 aria-current=page。

主要部分

  1. 01相關項目集合
  2. 02目前項目
  3. 03目前位置的值
  4. 04看得見的標記
  5. 05輔助工具讀法
  6. 06與選取狀態的界線

什麼時候用

需要標示一組項目中的目前頁面、步驟、日期或位置時,可以使用它。請選擇符合意思的值。

什麼時候不要用

同一組項目中不要標示多個目前位置。可選取元件應改用 aria-selected。

程式裡的名稱

one item in a set + aria-current=page|step|date|location|time|true

上線前要檢查

發布前檢查頁面結構、鍵盤操作、清楚可見的焦點、對比與縮放。也要檢查載入、沒有內容、錯誤、成功、取消與減少動態效果。

可以直接複製的需求

預期成果:使用 目前項目 (Current Item (aria-current)) 解決這項需求,同時保留使用者目前的操作脈絡。 使用者情境:麵包屑導覽包含「首頁」、「專案」和「Aurora」。只有 Aurora 設定 aria-current=page。 建議介面模式:目前項目 (Current Item (aria-current))。 適用理由:需要標示一組項目中的目前頁面、步驟、日期或位置時,可以使用它。請選擇符合意思的值。 不應使用的情況:同一組項目中不要標示多個目前位置。可選取元件應改用 aria-selected。 產品要求:定義預設、載入、沒有內容、錯誤、成功與復原狀態。保留使用者已輸入的內容,每個操作後都提供清楚回饋。 無障礙與韌性:使用結構正確的 HTML(語意化 HTML)和完整鍵盤操作。焦點要清楚可見,版面縮放後仍要好用。也要提供減少動態效果。遵守專案現有規則。除非專案已採用,否則不要新增介面元件庫。 驗收條件:主要任務可只用鍵盤完成,在 320px 寬度也能正常使用。焦點與狀態變化可被輔助工具讀出。載入、失敗、重試、取消與減少動態效果都已驗證。 證據與限制(證據邊界):標準只涵蓋列出的範圍,不會替你決定外觀、產品做法或 Vibulary 的教學範例。 待確認:產品文字、資料來源、分析事件、支援裝置與語系,以及平台特有限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 目前項目 (Current Item (aria-current))。 定義:aria-current 會告訴輔助工具,相關項目中哪一個是目前位置。它不代表項目已被選取。 正式環境檢查:發布前檢查頁面結構、鍵盤操作、清楚可見的焦點、對比與縮放。也要檢查載入、沒有內容、錯誤、成功、取消與減少動態效果。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

A1
這個術語有多正式?

正式標準

本頁說明的規則,可在列出的正式標準中找到。

標準只涵蓋列出的範圍,不會替你決定外觀、產品做法或 Vibulary 的教學範例。

適用範圍
只包含來源有說明的內容:正式名稱、定義、語意、實作
文件狀態
正式建議標準
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · W3C · 正式建議標準 Accessible Rich Internet Applications (WAI-ARIA) 1.2 — aria-current state aria-current state 適用範圍: 正式名稱、定義、語意、實作 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 語意, 實作 正式來源 · W3C · 正式建議標準 Accessible Rich Internet Applications (WAI-ARIA) 1.2 適用範圍: 正式名稱、定義、語意、實作 本頁用途: 只支援寫明的範圍 來源涵蓋內容: 正式名稱, 定義, 語意, 實作 背景資料 W3C WAI-ARIA APG — Breadcrumb Pattern 本頁用途: 提供背景,不是正式定義

自行複製

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