大网数据广告活动
Web 标准与前端开发

ARIA: navigation role

· 52CE 我爱测

The `navigation` role is used to identify major groups of links used for navigating through a website or page content.

The navigation role is used to identify major groups of links used for navigating through a website or page content.

<div role="navigation" aria-label="Main">
  
</div>

This is a website's main navigation.

Description

The navigation role is a landmark role. Landmark roles provide a way to identify the organization and structure of a web page. By classifying and labeling sections of a page, structural information conveyed visually through layout is represented programmatically. Screen readers use landmark roles to provide keyboard navigation to important sections of a page. Like the HTML nav element, navigation landmarks provide a way to identify groups (e.g., lists) of links that are intended to be used for website or page content navigation. If a page includes more than one navigation landmark, each should have a unique label. If two or more navigational landmark on a page have the same set of links, use the same label for each.

It is preferable to use the HTML5 <nav> element to define a navigation landmark. If the HTML5 nav element technique is not being used, use a role="navigation" attribute to define a navigation landmark.

[!NOTE] Using the nav element will automatically communicate a section has a role of navigation. Developers should always prefer using the correct semantic HTML element over using ARIA

Associated WAI-ARIA roles, states, and properties

  • aria-label
    • : A brief description of the purpose of the navigation, omitting the term "navigation", as the screen reader will read both the role and the contents of the label.

Keyboard interactions

None.

Required JavaScript features

None.

Examples

<div role="navigation" aria-label="Customer service">
  <ul>
    <li><a href="#">Help</a></li>
    <li><a href="#">Order tracking</a></li>
    <li><a href="#">Shipping &amp; Delivery</a></li>
    <li><a href="#">Returns</a></li>
    <li><a href="#">Contact us</a></li>
    <li><a href="#">Find a store</a></li>
  </ul>
</div>

Accessibility concerns

Landmark roles are intended to be used sparingly, to identify larger overall sections of the document. Using too many landmark roles can create "noise" in screen readers, making it difficult to understand the overall layout of the page.

Best practices

Prefer HTML

Using the nav element will automatically communicate that the element has a role of navigation. If possible, prefer using the semantic <nav> element instead of the navigation role.

Labeling landmarks

Multiple landmarks

If there is more than one navigation landmark role or nav element in a document, provide a label for each landmark. This label will allow an assistive technology user to be able to quickly understand the purpose of each landmark.

<div id="main-nav" role="navigation" aria-label="Main">
  
</div>

…

<nav id="footer-nav" aria-label="Footer">
  
</nav>

Repeated landmarks

If a navigation landmark role or nav element in a document is repeated in a document, and both landmarks have identical content, use the same label for each landmark. An example of this would be repeating the main navigation at the top and bottom of the page.

<header>
  <nav id="main-nav" aria-label="Main">
    
  </nav>
</header>

…

<footer>
  <nav id="footer-nav" aria-label="Main">
    
  </nav>
</footer>

Redundant descriptions

Screen readers will announce the type of role the landmark is. Because of this, you do not need to describe what the landmark is in its label. For example, a declaration of role="navigation" with an aria-label="Primary navigation" may be announced redundantly as, "primary navigation navigation".

Specifications

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。