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> 元素