From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/html/element%2Fmain.html | 125 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 devdocs/html/element%2Fmain.html (limited to 'devdocs/html/element%2Fmain.html') diff --git a/devdocs/html/element%2Fmain.html b/devdocs/html/element%2Fmain.html new file mode 100644 index 00000000..b2f6a0cb --- /dev/null +++ b/devdocs/html/element%2Fmain.html @@ -0,0 +1,125 @@ +

<main>

The <main> HTML element represents the dominant content of the <body> 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 central functionality of an application.

+

Try it

+
+

A document mustn't have more than one <main> element that doesn't have the hidden attribute specified.

Content categories +Flow content, palpable content.
Permitted content +Flow content.
Tag omission None; both the starting and ending tags are mandatory.
Permitted parents Where flow content is expected, but only if it is a hierarchically correct main element.
Implicit ARIA role main
Permitted ARIA roles No role permitted
DOM interface HTMLElement
+
+

Attributes

+

This element only includes the global attributes.

+

Usage notes

+
+

The content of a <main> element should be unique to the document. Content that is repeated across a set of documents or document sections such as sidebars, navigation links, copyright information, site logos, and search forms shouldn't be included unless the search form is the main function of the page.

<main> doesn't contribute to the document's outline; that is, unlike elements such as <body>, headings such as h2, and such, <main> doesn't affect the DOM's concept of the structure of the page. It's strictly informative.

+
+

Examples

+
+

html

+
<!-- other content -->
+
+<main>
+  <h1>Apples</h1>
+  <p>The apple is the pomaceous fruit of the apple tree.</p>
+
+  <article>
+    <h2>Red Delicious</h2>
+    <p>
+      These bright red apples are the most common found in many supermarkets.
+    </p>
+    <p>…</p>
+    <p>…</p>
+  </article>
+
+  <article>
+    <h2>Granny Smith</h2>
+    <p>These juicy, green apples make a great filling for apple pies.</p>
+    <p>…</p>
+    <p>…</p>
+  </article>
+</main>
+
+<!-- other content -->
+
+
+

Result

+
+ + +
+

Accessibility concerns

+ +

Landmark

+

The <main> element behaves like a main landmark role. Landmarks can be used by assistive technology to quickly identify and navigate to large sections of the document. Prefer using the <main> element over declaring role="main", unless there are legacy browser support concerns.

+

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 lets the user access the main content of the page faster.

Adding an id attribute to the <main> element lets it be a target of a skip navigation link.

+

html

+
<body>
+  <a href="#main-content">Skip to main content</a>
+
+  <!-- navigation and header content -->
+
+  <main id="main-content">
+    <!-- main page content -->
+  </main>
+</body>
+
+
+
+

Reader mode

+
+

Browser reader mode functionality looks for the presence of the <main> element, as well as heading and content sectioning elements when converting content into a specialized reader view.

+
+

Specifications

+
+ + +
Specification
HTML Standard
# the-main-element
+

Browser compatibility

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebView AndroidChrome AndroidFirefox for AndroidOpera AndroidSafari on IOSSamsung Internet
main261221No1674.426211471.5
+

See also

+
+

+ © 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
+ https://developer.mozilla.org/en-US/docs/Web/HTML/Element/main +

+
-- cgit v1.2.3