ARIA: mark 角色

描述

mark 角色在语义上表示包含文本的 HTML 元素，这些文本是出于参考目的而被标记/高亮的。这在语义上等同于 HTML 的 <mark> 元素。如果可能，您应该使用此元素代替。

mark 的用法与 <mark> 元素完全相同。例如，突出显示引文中标注的文本，但该文本在原始材料中并未被标记；这类似于使用荧光笔标记印刷文章中的段落；还包括指示与用户当前活动相关的内容部分，例如高亮显示搜索功能找到的文本匹配项。

不要将 mark 用于纯粹的装饰性样式，例如语法高亮。

mark 元素不应具有可访问名称；mark 上禁止使用 aria-label 和 aria-labelledby 属性。

示例

在下面的示例中，我们有一个已被注释的文档部分。注释部分使用 <span role="mark"> 进行标记。

<p>
  The last half of the song is a slow-rising crescendo that peaks at the
  <span role="mark" aria-details="thread-1">end of the guitar solo</span>,
  before fading away sharply.
</p>

<div role="comment" id="thread-1" data-author="chris">
  <h3>Chris said</h3>
  <p class="comment-text">I really think this moment could use more cowbell.</p>
  <p><time datetime="2022-03-30T19:29">March 30 2022, 19:29</time></p>
</div>

相关的注释使用 HTML 结构进行标记，该结构用包含 role="comment" 的 <div> 包装。

为了将注释与被注释的文本关联起来，我们需要将注释文本包装在一个包含 aria-details 属性的元素中，该属性的值应为注释的 ID。

最佳实践

优先使用 HTML

使用 <mark> 元素将自动传达节点具有 mark 的角色。如果可能，请优先使用它。

规范

将成为 WAI-ARIA 1.3 的一部分，该标准仍在起草中。

另见

• HTML <mark> 元素