ARIA：文件結構角色

ARIA 文件結構角色用於提供內容部分的結構描述。

結構化 ARIA 角色最初是為了橋接，告知輔助技術尚未在瀏覽器中完全支援的 HTML5 元素。一些角色，如 presentation、toolbar 和 tooltip，在不存在等效的原生 HTML 元素的情況下，會向輔助技術提供有關文件結構的資訊。其他角色，包括下表中列出的角色，則不需要，因為存在具有相同含義的語義化 HTML 元素。在很多情況下，這些等效的 HTML 元素一直都受到支援。

注意：這些結構角色都有語義化 HTML 等效項。它們在這裡是為了文件完整性而包含。Web 作者最好不要使用它們。

一些結構角色，如 suggestion，沒有 HTML 等效項，因此有單獨的文件。一些具有 HTML 等效項的結構角色，如 heading，具有 ARIA 屬性要求。它們列在下面，並連結到各自的角色文件。

以下大多數角色從不需要，但為了完整性而新增到了 ARIA。我們也在這裡為了完整性而包含了它們。

具有 HTML 等效項的結構角色

具有 HTML 等效項的結構角色列在下面

ARIA 角色和描述 HTML 等效項
associationlist
僅包含 associationlistitemkey 子元素及其同級 associationlistitemvalue。		 <dl>
associationlistitemkey
必須包含在 associationlist 中。		 <dt>
associationlistitemvalue
始終是緊隨 associationlistitemkey 的同級元素。		 <dd>
blockquote
引用自其他來源的內容部分。		 <blockquote>
caption
可見的內容，命名並可能描述 figure、table、grid 或 treegrid。
僅存在於這 4 個角色中。標題的 id 通常由 figure、grid、table 或 treegrid 的 aria-labelledby 屬性引用。
禁止的屬性：aria-label 和 aria-labelledby。		 <caption>
<figcaption>
code
代表計算機程式碼片段的部分。
禁止的屬性：aria-label 和 aria-labelledby。		 <code>
deletion
被標記為已刪除或建議刪除的內容。
禁止的屬性：aria-label 和 aria-labelledby。		 <del>
emphasis
用於強調或突出內容，但不建議使用它來表明重要性。
禁止的屬性：aria-label 和 aria-labelledby。		 <em>
figure
圖形文件、影像、程式碼片段或示例文字的容器。		 <figure>
heading
頁面部分的標題。
需要使用 aria-level 屬性來指示巢狀級別。
有關詳細資訊，請參閱 heading 角色。		 h1、h2、h3、h4、h5 和 h6
image
包含構成影像的元素集合的容器。是 img 角色的同義詞。		 <img>
img
包含構成影像的元素集合的容器。
需要可訪問名稱。
有關詳細資訊，請參閱 img 角色。		 <img>
insertion
被標記為已新增或建議新增的內容。
禁止的屬性：aria-label 和 aria-labelledby。		 <ins>
list
包含 listitem 元素的部分。
有關詳細資訊，請參閱 list 角色		 <ol>
<ul>
listitem
list 或 directory 中的單個專案。
必須包含在 list 中（如 <li>）。
有關詳細資訊，請參閱 listitem 角色。		 <li>
mark
為了引用或註釋的目的而標記或突出顯示的內容。
有關詳細資訊，請參閱 mark 角色。		 <mark>
meter
已知範圍內的標量測量值或分數值。
需要可訪問名稱。需要使用 aria-valuenow。
有關詳細資訊，請參閱 meter 角色。		 <meter>
paragraph
一段內容。
禁止的屬性：aria-label 和 aria-labelledby。		 <p>
強
重要、嚴肅或緊急內容。
禁止的屬性：aria-label 和 aria-labelledby。		 <strong>
下標
一個或多個下標字元。
僅當缺少角色會改變內容含義時才使用。
禁止的屬性：aria-label 和 aria-labelledby。		 <sub>
上標
一個或多個上標字元。
僅當缺少角色會改變內容含義時才使用。
禁止的屬性：aria-label 和 aria-labelledby。		 <sup>
術語
帶有可選對應定義的詞語或短語。
禁止的屬性：aria-label 和 aria-labelledby。
有關更多資訊，請參閱 term 角色。		 <dfn>
時間
一個有效的日期或時間字串格式，列出某個特定的時間點。
禁止的屬性：aria-label 和 aria-labelledby。		 <time>

注意：aria-label 和 aria-labelledby 屬性在 code、caption、deletion、emphasis、generic、insertion、mark、paragraph、presentation、none、strong、subscript、superscript、suggestion、term 和 time 上是被禁止的，並且應該只用於互動式內容。

最佳實踐

不要使用結構化角色。選擇 HTML 語義元素代替。

規範

規範
可訪問的富網際網路應用 (WAI-ARIA)
# document_structure_roles

另請參閱