ARIA: article 角色
article 角色表示页面、文档或网站上的一个独立的部分。它通常用于相关的、可以独立存在的或一起分组在同一页面上的内容项,例如评论、论坛帖子、报纸文章等。
<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> 元素。
<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-posinset 和 aria-setsize 属性,以指示该文章在提要中的位置。
在 application 或其他导致屏幕阅读器和其他辅助技术处于直通模式的控件中,可以使用 article 来指示这些内容应切换回将包含的内容视为常规 Web 内容。
不要将 article 角色包含在非语义元素上,而应使用 <article> 元素。用户代理就像对待 article 角色一样,将其转换为相应的可访问性信息。使用 <article> 元素也有助于搜索引擎更好地发现页面的结构。role="article"(或首选 <article>)的适当用法包括博客文章、论坛帖子、论坛或博客帖子的评论、社交媒体提要中的任何项目。
关联的 WAI-ARIA 角色、状态和属性
aria-posinset-
在提要(feed)的上下文中,表示该特定文章在提要中的位置,计数从 1 开始。
aria-setsize-
在提要(feed)的上下文中,表示提要中共有多少篇文章项。
键盘交互
此角色不支持任何特定的键盘交互。
所需的 JavaScript 功能
- 事件处理器
-
此角色不需要任何事件处理程序。
- 更改属性值
-
构建提要(feed)时,为每个 article 角色设置适当的
aria-posinset和aria-setsize属性值,请记住aria-posinset是从 1 开始的。
注意: 如果原生元素可用,请始终使用原生元素。 请使用 <article> 元素,而不是带有 article 角色的 <div>。
示例
规范
| 规范 |
|---|
| 无障碍富互联网应用程序 (WAI-ARIA) # article |
| 未知规范 |
优先级顺序
此角色对应于 HTML 中的 <article> 元素,如果可能,应优先使用该元素。此角色不要求其子元素中存在任何特定角色。它是 feed 角色元素的唯一允许的直接子角色。
另见
feed角色section角色<article>元素- RSS 词汇表定义