ARIA: article 角色

article 角色表示頁面、文件或網站上的一個獨立的部分。它通常用於相關的、可以獨立存在的或一起分組在同一頁面上的內容項,例如評論、論壇帖子、報紙文章等。

html
<div role="article">
  <h2>Heading of the segment</h2>
  <p>Paragraph for the segment.</p>
  <p>Another paragraph.</p>
  Controls to interact with the article, share it, etc.
</div>
<div role="article">…</div>

此示例並排顯示了頁面上的兩個文章,它們結構相似且內容相關。

注意: 請使用 <article> 元素,而不是帶有 article 角色的 <div>如果原生元素可用,請始終使用原生元素

不要使用 role="article"。請使用 <article> 元素。

html
<article>
  <h2>Heading of the segment</h2>
  <p>Paragraph for the segment.</p>
  <p>Another paragraph.</p>
  Controls to interact with the article, share it, etc.
</article>
<article>…</article>

描述

article 文件結構角色表示文件、頁面或站點的一部分,如果獨立存在,可以被視為完整的文件、頁面或站點。一組文章部分旨在表明它們之間的關係。

文章不被視為導航地標,但許多支援地標的輔助技術也支援在文章之間進行導航的方法。它們還可能支援指示文章內的巢狀關係。

文章可以巢狀,表示巢狀的文章直接與其所在的父文章相關,但不一定與巢狀層級之外的文章相關。請參考示例以瞭解具體用例。

如果一篇文章是提要(feed)的一部分,它可以設定 aria-posinsetaria-setsize 屬性,以指示該文章在提要中的位置。

application 或其他導致螢幕閱讀器和其他輔助技術處於直通模式的控制元件中,可以使用 article 來指示這些內容應切換回將包含的內容視為常規 Web 內容。

不要將 article 角色包含在非語義元素上,而應使用 <article> 元素。使用者代理就像對待 article 角色一樣,將其轉換為相應的可訪問性資訊。使用 <article> 元素也有助於搜尋引擎更好地發現頁面的結構。role="article"(或首選 <article>)的適當用法包括部落格文章、論壇帖子、論壇或部落格帖子的評論、社交媒體提要中的任何專案。

關聯的 WAI-ARIA 角色、狀態和屬性

aria-posinset

在提要(feed)的上下文中,表示該特定文章在提要中的位置,計數從 1 開始。

aria-setsize

在提要(feed)的上下文中,表示提要中共有多少篇文章項。

鍵盤互動

此角色不支援任何特定的鍵盤互動。

所需的 JavaScript 功能

事件處理器

此角色不需要任何事件處理程式。

更改屬性值

構建提要(feed)時,為每個 article 角色設定適當的 aria-posinsetaria-setsize 屬性值,請記住 aria-posinset 是從 1 開始的。

注意: 如果原生元素可用,請始終使用原生元素。 請使用 <article> 元素,而不是帶有 article 角色的 <div>

示例

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# article
未知規範

優先順序順序

此角色對應於 HTML 中的 <article> 元素,如果可能,應優先使用該元素。此角色不要求其子元素中存在任何特定角色。它是 feed 角色元素的唯一允許的直接子角色。

另見