メインコンテンツへスキップ

main要素


1.仕様

MAIN要素は、
ドキュメントの
主要なコンテンツを
表します。

MAIN - - (%Flow)* -- The dominant contents of the document. (Normal elements.) [Flow|Palpable] --

main

文書の主な内容 (The dominant contents of the document.)

種類

通常要素

カテゴリ

使用できるコンテキスト
フローコンテンツを受け入れる要素

フローコンテンツを受け入れる要素のコンテンツとして、使用できます。

フローコンテンツを受け入れる要素は、<body>要素, <section>要素, <nav>要素, <aside>要素, <article>要素, <header>要素, <footer>要素, <main>要素, <address>要素, <li>要素, <dt>要素, <dd>要素, <caption>要素, <th>要素, <td>要素, <form>要素, <fieldset>要素, <search>要素, <blockquote>要素, <figure>要素, <figcaption>要素, <div>要素, <dialog>要素, <details>要素 です。

ただし、それが階層的に正しいmain要素である場合に限ります。

タグの省略

どちらのタグも省略できません。

コンテンツ属性

グローバル属性のみ

DOM インターフェイス
HTMLElement
  1. [Exposed=Window]
  2. interface HTMLElement : Element {
  3. [HTMLConstructor] constructor();
  4.  
  5. // metadata attributes
  6. [CEReactions] attribute DOMString title;
  7. [CEReactions] attribute DOMString lang;
  8. [CEReactions] attribute boolean translate;
  9. [CEReactions] attribute DOMString dir;
  10.  
  11. // user interaction
  12. [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
  13. [CEReactions] attribute DOMString inert;
  14. undefined click();
  15. [CEReactions] attribute DOMString accessKey;
  16. readonly attribute DOMString accessKeyLabel;
  17. [CEReactions] attribute boolean draggable;
  18. [CEReactions] attribute boolean spellcheck;
  19. [CEReactions] attribute DOMString writingSuggestions;
  20. [CEReactions] attribute DOMString autocapitalize;
  21.  
  22. [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
  23. [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
  24.  
  25. ElementInternals attachInternals();
  26.  
  27. // The popover API
  28. undefined showPopover();
  29. undefined hidePopover();
  30. boolean togglePopover(optional boolean force);
  31. [CEReactions] attribute DOMString? popover;
  32. };
  33.  
  34. HTMLElement includes GlobalEventHandlers;
  35. HTMLElement includes ElementContentEditable;
  36. HTMLElement includes HTMLOrSVGElement;
Element
  1. [Exposed=Window]
  2. interface Element : Node {
  3. readonly attribute DOMString? namespaceURI;
  4. readonly attribute DOMString? prefix;
  5. readonly attribute DOMString localName;
  6. readonly attribute DOMString tagName;
  7.  
  8. [CEReactions] attribute DOMString id;
  9. [CEReactions] attribute DOMString className;
  10. [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
  11. [CEReactions, Unscopable] attribute DOMString slot;
  12.  
  13. boolean hasAttributes();
  14. [SameObject] readonly attribute NamedNodeMap attributes;
  15. sequence<DOMString> getAttributeNames();
  16. DOMString? getAttribute(DOMString qualifiedName);
  17. DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
  18. [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
  19. [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
  20. [CEReactions] undefined removeAttribute(DOMString qualifiedName);
  21. [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
  22. [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
  23. boolean hasAttribute(DOMString qualifiedName);
  24. boolean hasAttributeNS(DOMString? namespace, DOMString localName);
  25.  
  26. Attr? getAttributeNode(DOMString qualifiedName);
  27. Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
  28. [CEReactions] Attr? setAttributeNode(Attr attr);
  29. [CEReactions] Attr? setAttributeNodeNS(Attr attr);
  30. [CEReactions] Attr removeAttributeNode(Attr attr);
  31.  
  32. ShadowRoot attachShadow(ShadowRootInit init);
  33. readonly attribute ShadowRoot? shadowRoot;
  34.  
  35. Element? closest(DOMString selectors);
  36. boolean matches(DOMString selectors);
  37. boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
  38.  
  39. HTMLCollection getElementsByTagName(DOMString qualifiedName);
  40. HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
  41. HTMLCollection getElementsByClassName(DOMString classNames);
  42.  
  43. [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
  44. undefined insertAdjacentText(DOMString where, DOMString data); // legacy
  45. };
GlobalEventHandlers
  1. interface mixin GlobalEventHandlers {
  2. attribute EventHandler onabort;
  3. attribute EventHandler onauxclick;
  4. attribute EventHandler onbeforeinput;
  5. attribute EventHandler onbeforematch;
  6. attribute EventHandler onbeforetoggle;
  7. attribute EventHandler onblur;
  8. attribute EventHandler oncancel;
  9. attribute EventHandler oncanplay;
  10. attribute EventHandler oncanplaythrough;
  11. attribute EventHandler onchange;
  12. attribute EventHandler onclick;
  13. attribute EventHandler onclose;
  14. attribute EventHandler oncontextlost;
  15. attribute EventHandler oncontextmenu;
  16. attribute EventHandler oncontextrestored;
  17. attribute EventHandler oncopy;
  18. attribute EventHandler oncuechange;
  19. attribute EventHandler oncut;
  20. attribute EventHandler ondblclick;
  21. attribute EventHandler ondrag;
  22. attribute EventHandler ondragend;
  23. attribute EventHandler ondragenter;
  24. attribute EventHandler ondragleave;
  25. attribute EventHandler ondragover;
  26. attribute EventHandler ondragstart;
  27. attribute EventHandler ondrop;
  28. attribute EventHandler ondurationchange;
  29. attribute EventHandler onemptied;
  30. attribute EventHandler onended;
  31. attribute OnErrorEventHandler onerror;
  32. attribute EventHandler onfocus;
  33. attribute EventHandler onformdata;
  34. attribute EventHandler oninput;
  35. attribute EventHandler oninvalid;
  36. attribute EventHandler onkeydown;
  37. attribute EventHandler onkeypress;
  38. attribute EventHandler onkeyup;
  39. attribute EventHandler onload;
  40. attribute EventHandler onloadeddata;
  41. attribute EventHandler onloadedmetadata;
  42. attribute EventHandler onloadstart;
  43. attribute EventHandler onmousedown;
  44. [LegacyLenientThis] attribute EventHandler onmouseenter;
  45. [LegacyLenientThis] attribute EventHandler onmouseleave;
  46. attribute EventHandler onmousemove;
  47. attribute EventHandler onmouseout;
  48. attribute EventHandler onmouseover;
  49. attribute EventHandler onmouseup;
  50. attribute EventHandler onpaste;
  51. attribute EventHandler onpause;
  52. attribute EventHandler onplay;
  53. attribute EventHandler onplaying;
  54. attribute EventHandler onprogress;
  55. attribute EventHandler onratechange;
  56. attribute EventHandler onreset;
  57. attribute EventHandler onresize;
  58. attribute EventHandler onscroll;
  59. attribute EventHandler onscrollend;
  60. attribute EventHandler onsecuritypolicyviolation;
  61. attribute EventHandler onseeked;
  62. attribute EventHandler onseeking;
  63. attribute EventHandler onselect;
  64. attribute EventHandler onslotchange;
  65. attribute EventHandler onstalled;
  66. attribute EventHandler onsubmit;
  67. attribute EventHandler onsuspend;
  68. attribute EventHandler ontimeupdate;
  69. attribute EventHandler ontoggle;
  70. attribute EventHandler onvolumechange;
  71. attribute EventHandler onwaiting;
  72. attribute EventHandler onwebkitanimationend;
  73. attribute EventHandler onwebkitanimationiteration;
  74. attribute EventHandler onwebkitanimationstart;
  75. attribute EventHandler onwebkittransitionend;
  76. attribute EventHandler onwheel;
  77. };
ElementContentEditable
  1. interface mixin ElementContentEditable {
  2. [CEReactions] attribute DOMString contentEditable;
  3. [CEReactions] attribute DOMString enterKeyHint;
  4. readonly attribute boolean isContentEditable;
  5. [CEReactions] attribute DOMString inputMode;
  6. };
HTMLOrSVGElement
  1. interface mixin HTMLOrSVGElement {
  2. [SameObject] readonly attribute DOMStringMap dataset;
  3. attribute DOMString nonce; // intentionally no [CEReactions]
  4.  
  5. [CEReactions] attribute boolean autofocus;
  6. [CEReactions] attribute long tabIndex;
  7. undefined focus(optional FocusOptions options = {});
  8. undefined blur();
  9. };
ARIA in HTML
暗黙的="main" ARIAロール="No" aria-* 属性="GlobalAny"

暗黙的な ARIAセマンティクスは、role=main です。

作成者は、暗黙的な ARIAセマンティクス, または HTML要素のネイティブセマンティクスを上書きしてはいけません。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。

レンダリング
ブロックボックス
フローコンテンツ
  1. main {
  2. display: block;
  3. unicode-bidi: isolate;
  4. }

CSS を大雑把に読むと、 ブロックレベルのブロックコンテナボックス(ブロックボックス)を生成します。 などになります。

説明
main要素は、文書の主要な内容を表します。

main要素は、ドキュメントの主要なコンテンツを表します。
文書には、hidden 属性が指定されていないmain要素が 1 つ以上あってはいけません。
各main要素は、階層的に正しいmain要素である必要があります。階層的に正しいmain要素とは、その祖先要素が html要素, body要素, div要素, アクセス可能な名前のないform要素, および自律的なカスタム要素に限定されている要素です。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>main要素の例 - (Example of main element) | 離珠のHTMLでしぃ!</title>
  6. </head>
  7. <body>
  8. <header>
  9. <h1>main要素の例</h1>
  10. <p>区分化に関わる要素の記述例です。</p>
  11. </header>
  12. <main>
  13. <section>
  14. <h2>テーマ1</h2>
  15. テーマ1の内容を記述します。
  16. </section>
  17. <section>
  18. <h2>テーマ2</h2>
  19. テーマ2の内容を記述します。
  20. </section>
  21. </main>
  22. <footer>
  23. <address>
  24. <p>連絡先情報</p>
  25. </address>
  26. <span>Copyright(C) 2024 KOUTAN</span>
  27. </footer>
  28. </body>
  29. </html>

このサンプルへのリンクです。
(./exmain.htm)

JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "main": {
  3. "check": "2024-09-01",
  4. "group": "Section",
  5. "element": "- - (%Flow)* -- The dominant contents of the document. (Normal elements.) [Flow|Palpable] --",
  6. "attlist": {"%Global;": ""},
  7. "comment": "文書の主な内容 (The dominant contents of the document.)",
  8. "point": "文書の主要な内容を表します。",
  9. "description": [
  10. "ドキュメントの主要なコンテンツを表します。",
  11. "文書には、hidden 属性が指定されていないmain要素が 1 つ以上あってはいけません。",
  12. "各main要素は、階層的に正しいmain要素である必要があります。階層的に正しいmain要素とは、その祖先要素が html要素, body要素, div要素, アクセス可能な名前のないform要素, および自律的なカスタム要素に限定されている要素です。",
  13. ],
  14. "kind": "Normal",
  15. "categories": [
  16. "Flow",
  17. "Palpable",
  18. ],
  19. "used": "parent (%Flow)*",
  20. "usedsupplement": "ただし、それが階層的に正しいmain要素である場合に限ります。",
  21. "contentmodel": "main (%Flow)*",
  22. "tag": [
  23. "-",
  24. "-",
  25. ],
  26. "attributes": "Global",
  27. "dominterface": "HTMLElement",
  28. "rendering": [
  29. "Flow",
  30. "Bidirectional",
  31. ],
  32. "reference": [
  33. {
  34. "title": "HTML Living Standard. 4.4.14 The main element.",
  35. "href": "https://html.spec.whatwg.org/multipage/grouping-content.html#the-main-element",
  36. "heading": "HTML Living Standard. 4.4.14 The main element",
  37. "sub": "Last Updated 27 August 2024",
  38. },
  39. {
  40. "title": "HTML Living Standard. 15 Rendering 15.3.3 Flow content.",
  41. "href": "https://html.spec.whatwg.org/multipage/rendering.html#flow-content-3",
  42. "heading": "HTML Living Standard. 15 Rendering 15.3.3 Flow content",
  43. "sub": "Last Updated 27 August 2024",
  44. },
  45. {
  46. "title": "HTML 5.2 W3C Recommendation. 4.4.14 The main element. W3C Recommendation, 14 December 2017.",
  47. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/grouping-content.html#the-main-element",
  48. "heading": "HTML 5.2 W3C 勧告. 4.4.14 The main element",
  49. "sub": "W3C勧告、2017年12月14日",
  50. },
  51. {
  52. "title": "HTML 5.2 W3C Recommendation. 10.3.3. Flow content.",
  53. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#non-replaced-elements-flow-content",
  54. "heading": "HTML 5.2 W3C 勧告. 10.3.3. Flow content",
  55. "sub": "W3C勧告、2017年12月14日",
  56. },
  57. {
  58. "title": "HTML 5.1 W3C Recommendation. 4.4.13 The main element. W3C Recommendation, 1 November 2016.",
  59. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/grouping-content.html#the-main-element",
  60. "heading": "HTML 5.1 W3C 勧告. 4.4.13 The main element",
  61. "sub": "W3C勧告、2016年11月1日",
  62. },
  63. {
  64. "title": "HTML 5.1 W3C Recommendation. 10.3.3. Flow content. W3C Recommendation, 1 November 2016.",
  65. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#non-replaced-elements-flow-content",
  66. "heading": "HTML 5.1 W3C 勧告. 10.3.3. Flow content",
  67. "sub": "W3C勧告、2016年11月1日",
  68. },
  69. {
  70. "title": "HTML 5 W3C Recommendation. 4.4.14 The main element. W3C Recommendation, 28 October 2014.",
  71. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/grouping-content.html#the-main-element",
  72. "heading": "HTML 5 W3C 勧告. 4.4.14 The main element",
  73. "sub": "W3C勧告、2014年10月28日",
  74. },
  75. {
  76. "title": "MDN Web Docs. HTML <main>: The Main element.",
  77. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/main",
  78. "heading": "<main>: - HTML: ハイパーテキストマークアップ言語 | MDN",
  79. },
  80. ],
  81. "version": {
  82. "first": "HTML5",
  83. "latest": "HTML Living Standard",
  84. },
  85. }
  86. }

注意: 簡易に描画する為に、各項目の後ろに , を付与しています。JSON の形式では、末尾の項目の後には , は付けません。

最終確認日

2024-09-01


2.使用できるコンテキスト

main要素は、
フローコンテンツを、
受け入れる要素に
使用できます。

<main>要素が使用できるコンテキスト(Context文脈)は、フローコンテンツを受け入れる要素コンテンツとしてです。ただし、それが階層的に正しい<main>要素である場合に限ります。

階層的に正しい<main>要素とは、その祖先要素が <html>要素, <body>要素, <div>要素, アクセス可能な名前のない<form>要素, および自律的なカスタム要素に限定されている要素です。

文書には、hidden属性が指定されていない <main>要素が複数含まれていてはなりません。 そこから考えられる事で、祖先に<main>要素があってはいけません。

フローコンテンツコンテンツの一部として配置できる要素で、<main>要素を除くのは、以下の各要素です。

階層的に正しい<main>要素という事で、<body>要素コンテンツの一部として配置するのが一般的と思います。

body
main
  1. <body>
  2. <main>フローコンテンツ</main>
  3. </body>

<body>要素のコンテンツの一部として、フローコンテンツである<main>要素を配置している例です。


3.コンテンツモデル

main要素は、
フローコンテンツを
配置できます。

<main>要素子や子孫としてどのようなコンテンツ(Content内容) が含まれなければならないかというと、0 以上のフローコンテンツです。ただし、子孫に<main>要素を持てません。

main
Flow
content
  1. <main>
  2. <p>フローコンテンツ</p>
  3. </main>

<main>要素のコンテンツの一部として、フローコンテンツである<p>要素を配置している例です。


4.コンテンツ属性

main要素 は、
グローバル属性のみ、
設定できます。

main要素に指定することができる属性は、グローバル属性のみ、設定できます。


5.DOM インターフェイス

main要素
直接表す
プロパティは
ありません。

main要素を JavaScript などで操作するには、documentgetElementById()メソッドを用いてid属性で指定して、main要素を取得する方法があります。この時に取得できる値の形式はHTMLElement インターフェイスです。

他には、documentquerySelectorAll()メソッドを用いて要素セレクタmainと指定して用いるとか、name属性があればdocumentgetElementsByName()メソッドを用いるとか、状況, 目的によりいろいろあります。

この例示の文字の色は、です。
main要素の文字の色
  1. <form onchange="document.getElementById('imaJs501').style.color = document.getElementById('iseJs502').value;">
  2. この例示の文字の色は、<select id="iseJs502">
  3. <option value="inherit">継承する</option>
  4. <option value="red"></option>
  5. <option value="blue"></option>
  6. </select>です。
  7. </form>
  8. <main id="imaJs501">
  9. main要素の文字の色
  10. </main>

main要素id属性を指定して、そのid属性で要素を取得する例です。例示では、cssのcolorを選択して設定する処理としています。例示で動的に表示する為に、フォームの内容が変更された時に処理するコードとしています。

この例示は、デモをこの位置に提示する為にmain要素としては不適切な記述をしています。


6.アクセシビリティ

main要素は、
文書のメインコンテンツを含む
ランドマークです。

<main>要素暗黙的なARIAセマンティクスは、role="main" となります。
`main` ロールは、次のようなランドマークを意味します:
文書のメインコンテンツを含むランドマークです。

これは、文書の中心的なトピックに直接関連する、またはそれを拡張するコンテンツを示します。mainロールは、「メインコンテンツへスキップ」リンクの控えめな代替手段であり、メインコンテンツ(または他のランドマーク)へのナビゲーションオプションは、ユーザーエージェントダイアログまたは支援技術を通じて提供します。

ユーザーエージェントは、mainロールを持つ要素をナビゲーションランドマークとして扱うべきです。

あらゆる文書またはアプリケーションにおいて、作成者はmainロールを持つ要素を1つだけ指定すべきです。

作成者が<main>要素に明示的に指定可能なARIA ロール(役割)は以下のとおりです:
「役割なし」: 作成者は暗黙的な ARIA セマンティクスまたは HTML 要素のネイティブ セマンティクスを上書きしてはならないことを表します。

ARIA の状態プロパティについては、すべての要素で使用できるグローバル`aria-*` 属性に加えて、上記のロールに応じて使用可能な`aria-*` 属性が許可されます。


7.レンダリング

  1. main {
  2. display: block;
  3. unicode-bidi: isolate;
  4. }

main要素ユーザーエージェントレベルスタイルシートデフォルトでは、displayプロパティの値は block であり、ブロックレベルブロックコンテナボックス(ブロックボックス) を生成します。

ブロックフォーマットコンテキストに参加して、ブロックフォーマットコンテキストを継承, 確立します。もし、インラインフォーマットコンテキストに参加するコンテンツのみを含む場合は、新しいインラインフォーマットコンテキストを確立します。次に、すべてのインラインコンテンツをラップするルートインラインボックスも生成します。

unicode-bidi は、置換されない要素のレンダリングでの Bidirectional text(双方向テキスト) に於いての期待される仕様の様です。


8.気を付ける点

階層的に正しい

階層的に正しいmain要素とは、その祖先要素がhtml要素, body要素, div要素, アクセス可能な名前のないform要素、および自律的なカスタム要素に限定されているものです。各main要素は、階層的に正しいメイン要素でなければなりません。

文書には、hidden属性が指定されていないmain要素を複数持ってはなりません。