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

ARIA: main role

· 52CE 我爱测

The `main` landmark role is used to indicate the primary content of a document. The main content area consists of content that is directly related to or expands upon the central topic of a document, or the main function of an application.

The main landmark role is used to indicate the primary content of a document. The main content area consists of content that is directly related to or expands upon the central topic of a document, or the main function of an application.

<div id="main" role="main">
  <h1>Avocados</h1>
  
</div>

This is the main section of a document that discusses avocados. Subsections of this document could discuss their history, the different types, regions where they grow, etc.

Description

The main role is a navigational landmark role identifying the main content of a document. Landmarks can be used by assistive technology such as screen readers to quickly identify and navigate to large sections of the document.

By classifying and labeling sections of a page, structural information conveyed visually through layout can be represented programmatically. Screen readers use landmark roles to provide keyboard navigation to important sections of a page. For those navigating via landmark roles, the main role is an alternative for "skip to main content" links.

There should only be one main landmark role per document.

The main element has a role of main. Developers should use semantic HTML — in this case main — over using ARIA.

Associated ARIA roles, states, and properties

  • aria-owns

    • : The aria-owns attribute establishes relationships in the accessibility layer that aren't present in the DOM. Documents and applications can be nested in the DOM, which may lead to having more than one main element as DOM descendants. If this is the case, include aria-owns to identify the relationship of the main to its document or application ancestor.
  • aria-label or aria-labelledby

    • : Identify the accessible name with aria-labelledby if a visible header is present. Otherwise, including an aria-label can be helpful for orienting assistive technology users, especially in single-page applications where main content changes happen without generating a page load event.

Example

<body>
  

  <div role="main">
    <h1>The First Indochina War</h1>
    
  </div>

  
</body>

Accessibility concerns

Use only one main role per document

The main landmark role should only be used once per document.

If a document contains two main roles, say updating page content when triggered by JavaScript, the inactive main role's presence should be removed from assistive technology via techniques such as toggling the hidden attribute.

<main>
  <h1>Active `main` element</h1>
  
</main>

<main hidden>
  <h1>Hidden `main` element</h1>
  
</main>

It is also helpful to include an accessible name to help orient assistive technology users, especially in single-page applications where main content changes happen without generating a page load event. This can be added with aria-labelledby if there is an appropriate name in the content, or aria-label if not.

Best practices

Prefer HTML

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

Skip navigation

Skip navigation, also known as "skipnav", is a technique that allows an assistive technology user to quickly bypass large sections of repeated content (main navigation, info banners, etc.). This allows the user to access the main content of the page faster.

Adding an id attribute to the element with a declaration of role="main" allows it to be a target of a skip navigation link users.

<body>
  <a href="#main-content">Skip to main content</a>

  

  <div id="main-content" role="main">
    
  </div>
</body>

Which is the equivalent of:

<body>
  <a href="#main-content">Skip to main content</a>

  

  <main id="main-content">
    
  </main>
</body>

Specifications

See also

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

资料来源与适用范围

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

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

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