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

title要素

1.仕様

TITLE要素 は、
文書の題名を表します。

title

文書の題名 (document title)

種類
エスケープ可能な生テキスト要素

テキストおよび文字参照を持つことができる要素です。

カテゴリ

メタデータコンテンツ

使用できるコンテキスト
head要素に 1つ

head要素に 1つを そのコンテンツとして、使用できます。

他の title要素を含まない head要素のコンテンツとして、使用できます。

コンテンツモデル
「要素間の空白」でないテキスト

空のテキストノードとそれら(ASCII空白)の文字のシーケンスだけで構成されるテキストノードは、「要素間の空白」とみなされます。

タグの省略

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

コンテンツ属性

グローバル属性のみ

DOM インターフェイス
HTMLTitleElement
  1. [Exposed=Window]
  2. interface HTMLTitleElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute DOMString text;
  6. };
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
暗黙的="No" ARIAロール="No" aria-* 属性="No"

暗黙的な ARIAセマンティクスがありませんが、意味はあり、この意味は、ARIA によって提供されず、ARIA のユーザーに公開されていないロール、状態、プロパティで表現される可能性があります。

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

記述できる aria-* 属性はありません。

レンダリング
ボックスを生成しない
非表示の要素
  1. title {
  2. display: none;
  3. }

CSS を大雑把に読むと、 要素とその子孫はボックスやテキストシーケンスを生成しません。 などになります。

説明
title要素は、文書の題名を表します。

title要素は、文書のタイトルまたは名前を表します。著者は、ユーザーの履歴やブックマーク、検索結果など、文脈を無視して使用される場合でも、文書を識別できるタイトルを使用する必要があります。最初の見出しは文脈から切り離されても独立している必要はない為、文書のタイトルは最初の見出しとは異なる事がよくあります。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>title要素の例 - (Example of title element) | 離珠のHTMLでしぃ！</title>
  6. </head>
  7. <body>
  8. <h1>title要素の例</h1>
  9. <p>この例の title要素は、文書の題名を「title要素の例 - (Example of title element) | 離珠のHTMLでしぃ！」と表しています。</p>
  10. </body>
  11. </html>

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

参照元
参照元
JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "title": {
  3. "check": "2024-09-01",
  4. "group": "Metadata",
  5. "element": "- - (#PCDATA) -- document title. (Normal elements.) [Metadata] --",
  6. "attlist": {"%Global;": ""},
  7. "comment": "文書の題名 (document title)",
  8. "point": "文書の題名を表します。",
  9. "description": "文書のタイトルまたは名前を表します。著者は、ユーザーの履歴やブックマーク、検索結果など、文脈を無視して使用される場合でも、文書を識別できるタイトルを使用する必要があります。最初の見出しは文脈から切り離されても独立している必要はない為、文書のタイトルは最初の見出しとは異なる事がよくあります。",
  10. "kind": "Escapable",
  11. "categories": "Metadata",
  12. "used": "HEAD (TITLE)",
  13. "usedsupplement": "他の title要素を含まない head要素のコンテンツとして、使用できます。",
  14. "contentmodel": "%Whitespace",
  15. "tag": [
  16. "-",
  17. "-",
  18. ],
  19. "attributes": "Global",
  20. "dominterface": "HTMLTitleElement",
  21. "rendering": "Hidden",
  22. "reference": [
  23. {
  24. "title": "HTML Living Standard. 4.2.2 The title element.",
  25. "href": "https://html.spec.whatwg.org/multipage/semantics.html#the-title-element",
  26. "heading": "HTML Living Standard. 4.2.2 The title element",
  27. "sub": "Last Updated 27 August 2024",
  28. },
  29. {
  30. "title": "HTML Living Standard. 15 Rendering 15.3.1 Hidden elements.",
  31. "href": "https://html.spec.whatwg.org/multipage/rendering.html#hidden-elements",
  32. "heading": "HTML Living Standard. 15 Rendering 15.3.1 Hidden elements",
  33. "sub": "Last Updated 27 August 2024",
  34. },
  35. {
  36. "title": "HTML Living Standard. 3.2.5 Content models inter-element whitespace.",
  37. "href": "https://html.spec.whatwg.org/multipage/dom.html#inter-element-whitespace",
  38. "heading": "HTML Living Standard. 3.2.5 Content models inter-element whitespace",
  39. "sub": "Last Updated 19 July 2024",
  40. },
  41. {
  42. "title": "HTML 5.2 W3C Recommendation. 4.2.2 The title element. W3C Recommendation, 14 December 2017.",
  43. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/document-metadata.html#the-title-element",
  44. "heading": "HTML 5.2 W3C 勧告. 4.2.2 The title element",
  45. "sub": "W3C勧告、2017年12月14日",
  46. },
  47. {
  48. "title": "HTML 5.2 W3C Recommendation. 10.3.1. Hidden elements.",
  49. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#hidden-elements",
  50. "heading": "HTML 5.2 W3C 勧告. 10.3.1. Hidden elements",
  51. "sub": "W3C勧告、2017年12月14日",
  52. },
  53. {
  54. "title": "HTML 5.1 W3C Recommendation. 4.2.2 The title element. W3C Recommendation, 1 November 2016.",
  55. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/document-metadata.html#the-title-element",
  56. "heading": "HTML 5.1 W3C 勧告. 4.2.2 The title element",
  57. "sub": "W3C勧告、2016年11月1日",
  58. },
  59. {
  60. "title": "HTML 5.1 W3C Recommendation. 10.3.1. Hidden elements. W3C Recommendation, 1 November 2016.",
  61. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#hidden-elements",
  62. "heading": "HTML 5.1 W3C 勧告. 10.3.1. Hidden elements",
  63. "sub": "W3C勧告、2016年11月1日",
  64. },
  65. {
  66. "title": "HTML 5 W3C Recommendation. 4.2.2 The title element. W3C Recommendation, 28 October 2014.",
  67. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/document-metadata.html#the-title-element",
  68. "heading": "HTML 5 W3C 勧告. 4.2.2 The title element",
  69. "sub": "W3C勧告、2014年10月28日",
  70. },
  71. {
  72. "title": "HTML 5 W3C Recommendation. 10.3.1. Hidden elements. W3C Recommendation, 28 October 2014.",
  73. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#hidden-elements",
  74. "heading": "HTML 5 W3C 勧告. 10.3.1. Hidden elements",
  75. "sub": "W3C勧告、2014年10月28日",
  76. },
  77. {
  78. "title": "HTML 4.01 Specification W3C Recommendation. 7.4.2 The TITLE element. W3C Recommendation 24 December 1999.",
  79. "href": "https://www.w3.org/TR/html401/struct/global.html#h-7.4.2",
  80. "heading": "HTML 4.01 Specification W3C 勧告. 7.4.2 The TITLE element",
  81. "sub": "W3C勧告1999年12月24日",
  82. },
  83. {
  84. "title": "HTML 3.2 Reference Specification. W3C Recommendation 14-Jan-1997.",
  85. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/#title",
  86. "heading": "HTML 3.2 Reference Specification TITLE",
  87. "sub": "W3C勧告1997年1月14日",
  88. },
  89. {
  90. "title": " Hypertext Markup Language - 2.0. November 1995.",
  91. "href": "https://www.ietf.org/rfc/rfc1866.txt",
  92. "heading": "Hypertext Markup Language - 2.0",
  93. "sub": "November 1995",
  94. },
  95. {
  96. "title": "Hypertext Markup Language (HTML). June 1993.",
  97. "href": "https://www.w3.org/MarkUp/draft-ietf-iiir-html-01.txt",
  98. "heading": "Hypertext Markup Language (HTML)",
  99. "sub": "June 1993",
  100. },
  101. {
  102. "title": "MDN Web Docs. HTML <title>: The Document Title element.",
  103. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/title",
  104. "heading": "<title>: 文書題名要素 - HTML: ハイパーテキストマークアップ言語 | MDN",
  105. },
  106. ],
  107. "version": {
  108. "first": "HTML",
  109. "latest": "HTML Living Standard",
  110. },
  111. }
  112. }

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

最終確認日

2024-09-01

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

title要素は、
head要素に
１つだけ
配置できます。

title要素が使用できるコンテキスト(Context・文脈)は、他にtitle要素が配置されていないhead要素のコンテンツとしてです。

別の言い方で細かく言うと、head要素にtitle要素を１つだけ配置が必要です。ただし、文書がフレームで読み込まれる文書である場合、またはタイトル情報が上位レベルのプロトコルから利用できる場合は、title要素は、0 または１つとなります。(配置が任意となります。)

document
html
head
body
title
メタ
フロー
  1. <head>
  2. <meta charset="UTF-8">
  3. <title>離珠のHTMLでしぃ！</title>
  4. </head>

head要素のコンテンツの一部として、title要素を1つだけ配置できます。
文字エンコーディング宣言を含むmeta要素を1番目, title要素を2番目のhead要素の子要素として設置する事をお勧めします。

3.コンテンツモデル

title要素は、
「要素間の空白」でない
テキストを
配置できます。

title要素の子や子孫としてどのようなコンテンツ(Content・内容) が含まれなければならないかというと、「要素間の空白」 (空のテキストノードおよびそれらの文字のシーケンスのみで構成されるテキストノードです。) でないテキストです。

空のテキストノードおよびそれらの文字 (ホワイトスペース) については、別途に記述しています。

title要素は、テキストおよび文字参照を持つことができるエスケープ可能な生テキスト要素です。

  1. <title></title>

空なので不適切です。

  1. <title> </title>
  1. <title>
  2. </title>

ホワイトスペースのみで構成されるので不適切です。

4.コンテンツ属性

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

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

title要素は文書の題名を表し、それに関わるのはlang属性ぐらいかと思われます。lang属性は、html要素に設定すべきなので、title要素に属性を設定する必要はないと思います。

5.DOM インターフェイス

documentの
プロパティである
titleは、
title要素の
テキストの内容を
返します。

title要素を JavaScript などで操作するには、documentのプロパティであるtitleを用います。これは、要素であるtitle要素のテキストの内容を返します。titleは、文書の題名の内側のテキスト値を設定したり取得したりする為のセッター/ゲッターメソッドです。

title要素自体を表すプロパティはないので、title要素を JavaScript などで操作するには、documentの querySelector()メソッドで条件を絞って、要素を取得する方法があります。title要素は配置できるのは１つだけなので、要素セレクタで title と指定して、title要素のリストの最初の１つを取得できます。この時に取得できるのはHTMLTitleElement インターフェイスです。

他には、id属性があれば documentの getElementById()メソッドを用いるとか、状況, 目的によりいろいろあります。

HTMLTitleElement インターフェイスのtextプロパティもdocumentのtitleプロパティと同じくこのtitle要素の子テキストコンテンツを設定したり取得したりする為のセッター/ゲッターメソッドです。

このページの表題は、
"〇〇"です。

  1. <p>このページの表題は、
  2. "<code id="JHSAMPLE051">〇〇</code>"です。</p>
  3. <script>
  4. document.addEventListener("DOMContentLoaded", function() {
  5. document.getElementById("JHSAMPLE051").textContent = document.title;
  6. });
  7. </script>

title要素の内容を取得する例です。例示で表示する為に、HTML文書の読み込みと解析が終了した時に処理するコードとしています。

6.レンダリング

  1. title {
  2. display: none;
  3. }

title要素のユーザーエージェントレベルのスタイルシートデフォルトでは、displayプロパティの値は none であり、この要素とその子孫はボックスやテキストシーケンスを生成しません。

メタデータである文書の題名を記述する為の要素なので、ビジュアルメディアでボックスを生成する様な指定は行わないのが良いでしょう。

  1. head > * { display: none; }
  2. head, title { display: block; }
  3. title { margin-top: 11em; }
  4. base::after { content: "target=" attr(target); }

メタデータを記述するエスケープ可能な生テキスト要素を表示する例のつもりです。表示する予定であれば、メタデータとしてではなく表示用でもあるデータとして別の要素で記述しておくのが良いかと思います。例として記述してみても、なんか変かなと思います。まぁ技術的な可能性としての知識として見てください。 実際、ファイルの文字数を考えてみても、スタイルシートの指定が必要になり、内容次第ではかえって増えます。

title要素を表示するサンプル へのリンクはこちらです

7.気を付ける点

用途

ブラウザーのタイトルバーやページのタブに表示される文書の題名なので、見やすく, 判り易く, 魅せる内容をお勧めします。

8.付記