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 角色元素的唯一允许的直接子角色。

另见