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

a要素


1.仕様

A要素は、
href属性がある場合、
その内容でラベル付けされた
ハイパーリンク
(ハイパーテキストアンカー)を
表します。

a

アンカー (anchor)

種類

通常要素

カテゴリ
  • フローコンテンツ
  • フレージングコンテンツ
  • インタラクティブコンテンツ(条件付き)
  • パルパブルコンテンツ

href属性がある場合は、インタラクティブコンテンツ。

コンテンツモデル

===== てすと (121801)) --- _lsPrCheck= Error --- asAgContentmodel= (%Transparent) -(%Interactive) --- asAgElement= a --- =====

(%Transparent) -(%Interactive)

===== てすと (121801)) --- _lsPrCheck= Error --- asAgContentmodel= (%Transparent) -(%Interactive) --- asAgElement= a --- =====

(%Transparent) -(%Interactive)が配置できます。

透明ですが、インタラクティブコンテンツの子孫、要素の子孫、または tabindex属性が指定された子孫は存在してはなりません。

タグの省略

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

コンテンツ属性
グローバル属性 他
href属性
ハイパーリンクのアドレス
target属性
ハイパーリンクナビゲーションに対応
download属性
リソースに移動するのではなくダウンロードするかどうか、またダウンロードする場合はそのファイル名
ping属性
pingするURL
rel属性
ハイパーリンクを含む文書内の場所とリンク先のリソースの関係
hreflang属性
リンクされたリソースの言語
type属性
参照されるリソースの種類のヒント
referrerpolicy属性
要素によって開始されたフェッチのリファラーポリシー
DOM インターフェイス
HTMLAnchorElement
  1. [Exposed=Window]
  2. interface HTMLAnchorElement : HTMLElement {
  3. [HTMLConstructor] constructor();
  4.  
  5. [CEReactions] attribute DOMString target;
  6. [CEReactions] attribute DOMString download;
  7. [CEReactions] attribute USVString ping;
  8. [CEReactions] attribute DOMString rel;
  9. [SameObject, PutForwards=value] readonly attribute DOMTokenList relList;
  10. [CEReactions] attribute DOMString hreflang;
  11. [CEReactions] attribute DOMString type;
  12.  
  13. [CEReactions] attribute DOMString text;
  14.  
  15. [CEReactions] attribute DOMString referrerPolicy;
  16.  
  17. // also has obsolete members
  18. };
  19.  
  20. HTMLAnchorElement includes HTMLHyperlinkElementUtils;
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
暗黙的="link,generic" ARIAロール="あり" aria-* 属性="GlobalAny"

暗黙的な ARIAセマンティクスは、role=link, generic です。
href属性がある場合は role=link。href属性がない場合は role=generic。

作成者が要素に指定してもよい ARIAロール値は、 button, checkbox, menuitem, menuitemcheckbox, menuitemradio, option, radio, switch, tab, treeitem です。
href属性がある場合は Roles: button, checkbox, menuitem, menuitemcheckbox, menuitemradio, option, radio, switch, tab or treeitem. href属性がない場合は 任意の役割。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。
href 属性を持つ a 要素で aria-disabled='true' を使用することは推奨されません。

レンダリング
インラインボックス
フレージングコンテンツ
  1. :link { color: #0000EE; }
  2. :visited { color: #551A8B; }
  3. :link:active, :visited:active { color: #FF0000; }
  4. :link, :visited {
  5. text-decoration: underline;
  6. cursor: pointer;
  7. }

CSS を大雑把に読むと、 ボックスについて、特に指定はされていません。既定値から、インラインレベルのボックス(インラインボックス)を生成すると思われます。 などになります。

説明
a要素は、アンカー(anchor) を表します。

a要素は、アンカー(anchor) を表します。
a要素にhref属性がある場合、その内容でラベル付けされたハイパーリンク(ハイパーテキストアンカー)を表します。
a要素にhref属性がない場合、要素は、要素のコンテンツのみで構成される、関連性があった場合にリンクが配置された可能性のある場所のプレースホルダーを表します。

  1. <!DOCTYPE html>
  2. <html lang="ja">
  3. <head>
  4. <meta charset="utf-8">
  5. <title>a要素の例 - (Example of a element) | 離珠のHTMLでしぃ!</title>
  6. </head>
  7. <body>
  8. <h1>a要素の例</h1>
  9. <a href="./index.htm">トップページへ</a>
  10. </body>
  11. </html>

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

JSONデータ
JSON形式での、データのイメージです。
  1. {
  2. "a": {
  3. "check": "2024-12-18",
  4. "group": "Interactive",
  5. "element": "- - (%Transparent) -(%Interactive) -- anchor. (Normal elements.) [Flow|Phrasing|Interactive|Palpable] --",
  6. "attlist": {
  7. "%Global;": "",
  8. "href": "%URI; #IMPLIED -- URI for linked resource --",
  9. "target": "CDATA #IMPLIED -- Navigable for hyperlink navigation --",
  10. "download": "CDATA #IMPLIED -- Whether to download the resource instead of navigating to it, and its filename if so --",
  11. "ping": "%URI; #IMPLIED -- URLs to ping --",
  12. "rel": "%LinkTypes; #IMPLIED -- forward link types --",
  13. "hreflang": "%LanguageCode; #IMPLIED -- language code --",
  14. "type": "%ContentType; #IMPLIED -- advisory content type --",
  15. "referrerpolicy": "CDATA #IMPLIED -- Referrer policy for fetches initiated by the element --",
  16. },
  17. "comment": "アンカー (anchor)",
  18. "point": "アンカー(anchor) を表します。",
  19. "description": [
  20. "アンカー(anchor) を表します。",
  21. "a要素にhref属性がある場合、その内容でラベル付けされたハイパーリンク(ハイパーテキストアンカー)を表します。",
  22. "a要素にhref属性がない場合、要素は、要素のコンテンツのみで構成される、関連性があった場合にリンクが配置された可能性のある場所のプレースホルダーを表します。",
  23. ],
  24. "kind": "Normal",
  25. "categories": [
  26. "Flow",
  27. "Phrasing",
  28. "Interactivelimited",
  29. "Palpable",
  30. ],
  31. "categoriessupplement": "href属性がある場合は、インタラクティブコンテンツ。",
  32. "used": "parent %Phrasing",
  33. "contentmodel": "(%Transparent) -(%Interactive)",
  34. "contentmodelsupplement": "透明ですが、インタラクティブコンテンツの子孫、要素の子孫、または tabindex属性が指定された子孫は存在してはなりません。",
  35. "tag": [
  36. "-",
  37. "-",
  38. ],
  39. "attributes": {
  40. "href": "ハイパーリンクのアドレス",
  41. "target": "ハイパーリンクナビゲーションに対応",
  42. "download": "リソースに移動するのではなくダウンロードするかどうか、またダウンロードする場合はそのファイル名",
  43. "ping": "pingするURL",
  44. "rel": "ハイパーリンクを含む文書内の場所とリンク先のリソースの関係",
  45. "hreflang": "リンクされたリソースの言語",
  46. "type": "参照されるリソースの種類のヒント",
  47. "referrerpolicy": "要素によって開始されたフェッチのリファラーポリシー",
  48. },
  49. "dominterface": "HTMLAnchorElement",
  50. "rendering": "Phrasing",
  51. "reference": [
  52. {
  53. "title": "HTML Living Standard. 4.5.1 The a element.",
  54. "href": "https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element",
  55. "heading": "HTML Living Standard. 4.5.1 The a element",
  56. "sub": "Last Updated 17 December 2024",
  57. },
  58. {
  59. "title": "HTML Living Standard. 15 Rendering 15.3.4 Phrasing content.",
  60. "href": "https://html.spec.whatwg.org/multipage/rendering.html#phrasing-content-3",
  61. "heading": "HTML Living Standard. 15 Rendering 15.3.4 Phrasing content",
  62. "sub": "Last Updated 17 December 2024",
  63. },
  64. {
  65. "title": "HTML 5.2 W3C Recommendation. 4.5.1 The a element. W3C Recommendation, 14 December 2017.",
  66. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/textlevel-semantics.html#the-a-element",
  67. "heading": "HTML 5.2 W3C 勧告. 4.5.1 The a element",
  68. "sub": "W3C勧告、2017年12月14日",
  69. },
  70. {
  71. "title": "HTML 5.2 W3C Recommendation. 10.3.4. Phrasing content. W3C Recommendation, 14 December 2017.",
  72. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/rendering.html#non-replaced-elements-phrasing-content",
  73. "heading": "HTML 5.2 W3C 勧告. 10.3.4. Phrasing content",
  74. "sub": "W3C勧告、2017年12月14日",
  75. },
  76. {
  77. "title": "HTML 5.1 W3C Recommendation. 4.5.1 The a element. W3C Recommendation, 1 November 2016.",
  78. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/textlevel-semantics.html#the-a-element",
  79. "heading": "HTML 5.1 W3C 勧告. 4.5.1 The a element",
  80. "sub": "W3C勧告、2016年11月1日",
  81. },
  82. {
  83. "title": "HTML 5.1 W3C Recommendation. 10.3.4. Phrasing content. W3C Recommendation, 1 November 2016.",
  84. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/rendering.html#non-replaced-elements-phrasing-content",
  85. "heading": "HTML 5.1 W3C 勧告. 10.3.4. Phrasing content",
  86. "sub": "W3C勧告、2016年11月1日",
  87. },
  88. {
  89. "title": "HTML 5 W3C Recommendation. 4.5.1 The a element. W3C Recommendation, 28 October 2014.",
  90. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/text-level-semantics.html#the-a-element",
  91. "heading": "HTML 5 W3C 勧告. 4.5.1 The a element",
  92. "sub": "W3C勧告、2014年10月28日",
  93. },
  94. {
  95. "title": "HTML 5 W3C Recommendation. 10.3.4. Phrasing content. W3C Recommendation, 28 October 2014.",
  96. "href": "https://www.w3.org/TR/2014/REC-html5-20141028/rendering.html#phrasing-content-0",
  97. "heading": "HTML 5 W3C 勧告. 10.3.4. Phrasing content",
  98. "sub": "W3C勧告、2014年10月28日",
  99. },
  100. {
  101. "title": "HTML 4.01 Specification W3C Recommendation. 12.2 The A element. W3C Recommendation 24 December 1999.",
  102. "href": "https://www.w3.org/TR/html401/struct/links.html#h-12.2",
  103. "heading": "HTML 4.01 Specification W3C 勧告. 12.2 The A element",
  104. "sub": "W3C勧告1999年12月24日",
  105. },
  106. {
  107. "title": "HTML 3.2 Reference Specification. The A (anchor) element. W3C Recommendation 14-Jan-1997.",
  108. "href": "https://www.w3.org/TR/2018/SPSD-html32-20180315/#anchor",
  109. "heading": "HTML 3.2 Reference Specification. The A (anchor) element",
  110. "sub": "W3C勧告1997年1月14日",
  111. },
  112. {
  113. "title": "Hypertext Markup Language - 2.0. November 1995.",
  114. "href": "https://www.ietf.org/rfc/rfc1866.txt",
  115. "heading": "Hypertext Markup Language - 2.0",
  116. "sub": "November 1995",
  117. },
  118. {
  119. "title": "Hypertext Markup Language (HTML). June 1993.",
  120. "href": "https://www.w3.org/MarkUp/draft-ietf-iiir-html-01.txt",
  121. "heading": "Hypertext Markup Language (HTML)",
  122. "sub": "June 1993",
  123. },
  124. {
  125. "title": "MDN Web Docs. HTML <a>: The Anchor element.",
  126. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/a",
  127. "heading": "MDN Web Docs. HTML <a>: アンカー要素",
  128. },
  129. ],
  130. "version": {
  131. "first": "HTML",
  132. "latest": "HTML Living Standard",
  133. },
  134. }
  135. }

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

最終確認日

2024-12-18


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


3.コンテンツモデル


4.コンテンツ属性


5.DOM インターフェイス


6.レンダリング


7.気を付ける点

情報の公開

リンクを含めて記述する情報は公開される情報であるという事に留意して下さい。

アクセシビリティ

a 要素のコンテンツ(内容,テキスト)と href 属性の値を一致する様にしましょう。

リンク切れ

リンクした先が実在する必要もあります。リンク先が移転したりファイル名が変わったりするとリンク切れで先に行けません。出来るだけ変わらないアドレスを選ぶか、こまめに確認しましょう。

CSSリセット

  1. a {
  2. background-color: transparent;
  3. }

normalize.css というリセットCSS の一部で、IE 10でアクティブなリンクの灰色の背景を削除します。
a要素の例示は、上記の CSSの効果を効かない指定をしている例です。
詳細は理解していないのですが、いろいろとバグ等の対応も含んでいる様なので、リセットCSSを利用する事をお勧めします。

CSSを使い、以下の様に例示してみました。
例示でのリンク先はトップページです。

  1. <a href="./index.htm">TOP PAGE</a>

アンカー要素だけの簡素なリンクです。

  1. <form>
  2. <button formaction="./index.htm">TOP PAGE</button>
  3. </form>

アンカー要素の代わりにボタン要素を用いたリンクです。

  1. <a href="./index.htm" class="canSample1d3">TOP PAGE</a>
  1. .canSample1d3{ text-decoration:none; border:0.2em outset #00ffff; background-color:#66ffff;}

下線を消して境界を要素が出っ張る様な線を指定し、境界と背景の色を指定しています。

  1. <a href="./index.htm" class="canSample1d4">TOP PAGE</a>
  1. .canSample1d4{ text-decoration:none;}
  2. .canSample1d4:hover,
  3. .canSample1d4:focus{text-decoration:underline;}

下線を消して、要素の上をホバー(通過)させたときに下線を表す指定をしています。

  1. <a href="./index.htm" class="canSample1d5">TOP PAGE</a>
  1. .canSample1d5{ text-decoration:underline; border:1px outset transparent;}
  2. .canSample1d5:hover,
  3. .canSample1d5:focus{text-decoration:underline; border:1px outset #999999; border-radius:5px;}

境界線を透過で用意して、要素の上をホバー(通過)させたときに境界線を表す指定をしています。

  1. <a href="./index.htm" class="canSample1d6">TOP PAGE</a>
  1. .canSample1d6{ text-decoration:none;}
  2. .canSample1d6:hover,
  3. .canSample1d6:focus{position:relative; top:3px; left:3px;}

要素の上をホバー(通過)させたときに要素の位置をずらしています。


8.付記