HTMLAnchorElement インターフェイスは、ハイパーリンク要素を表し、そのような要素のレイアウトとプレゼンテーションを操作するための特別なプロパティとメソッドを(継承元の通常の HTMLElement オブジェクトインターフェイスのものを超えて)提供します。 このインターフェイスは <a> 要素に対応しています。 HTMLLinkElement で表される <link> と混同しないでください。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLAnchorElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLAnchorElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
プロパティ
親の HTMLElement からプロパティを継承し、HTMLHyperlinkElementUtils からのプロパティを実装します。
Element.accessKey- 入力フォーカスをこのハイパーリンクに切り替える単一文字を表す
DOMStringです。 HTMLAnchorElement.download- リンク先リソースをブラウザーに表示するのではなくダウンロードすることを意図していることを示す
DOMStringです。 値は、提案されたファイル名を表します。 名前が基になる OS の有効なファイル名でない場合、ブラウザーはそれを適応させます。 HTMLHyperlinkElementUtils.hash- あれば、参照 URL の先頭のハッシュマーク ('
#') を含むフラグメント識別子を表すUSVStringです。 HTMLHyperlinkElementUtils.host- 参照 URL のホスト名とポート(デフォルトのポートでない場合)を表す
USVStringです。 HTMLHyperlinkElementUtils.hostname- 参照 URL のホスト名を表す
USVStringです。 HTMLHyperlinkElementUtils.hrefhrefHTML 属性を反映するUSVStringであり、リンク先リソースの有効な URL を含みます。HTMLAnchorElement.hreflang- リンク先リソースの言語を示す
hreflangHTML 属性を反映するDOMStringです。 HTMLAnchorElement.media- リンク先リソースの意図するメディアを示す
mediaHTML 属性を反映するDOMStringです。(訳注:仕様にありません。 記載のある資料では、複数の要素のものをまとめて説明していますが、この要素は参考情報だそうで、仕様を整理する際に蒸発してしまったのかもしれません。) HTMLHyperlinkElementUtils.password- ドメイン名の前に指定されたパスワードを含む
USVStringです。 HTMLHyperlinkElementUtils.origin読取専用- URL のオリジン、つまりスキーム(プロトコル)、ドメイン(ホスト名)、ポートを含む
USVStringを返します。 HTMLHyperlinkElementUtils.pathname- あれば、参照 URL のパス名の部分を表す
USVStringです。 HTMLHyperlinkElementUtils.port- あれば、参照 URL のポートの部分を表す
USVStringです。 HTMLHyperlinkElementUtils.protocol- 参照 URL の末尾のコロン ('
:') を含むプロトコルの部分を表すUSVStringです。 HTMLAnchorElement.referrerPolicy- どのリファラーを使用するかを示す
referrerpolicyHTML 属性を反映するDOMStringです。 HTMLAnchorElement.rel- 対象オブジェクトからリンク先オブジェクトへの関係を指定する
relHTML 属性を反映するDOMStringです。 HTMLAnchorElement.relList読取専用relHTML 属性を反映するトークンのリストとしてDOMTokenListを返します。HTMLHyperlinkElementUtils.search- あれば、参照 URL の先頭の疑問符 ('
?') を含む検索要素を表すUSVStringです。 HTMLElement.tabindex- 現在のドキュメントのタブ移動ナビゲーション順序での要素の位置を含む
longです。 HTMLAnchorElement.target- リンク先リソースを表示する場所を示す
targetHTML 属性を反映するDOMStringです。 HTMLAnchorElement.textNode.textContentプロパティの同義語であるDOMStringです。HTMLAnchorElement.type- リンク先リソースの MIME タイプを示す
typeHTML 属性を反映するDOMStringです。 HTMLHyperlinkElementUtils.username- ドメイン名の前に指定されたユーザー名を含む
USVStringです。
廃止されたプロパティ
HTMLAnchorElement.charset- リンク先リソースの文字エンコードを表す
DOMStringです。 HTMLAnchorElement.coords- コンマ区切りの座標リストを表す
DOMStringです。 HTMLAnchorElement.name- アンカー名を表す
DOMStringです。 HTMLAnchorElement.rev- リンク先オブジェクトから対象オブジェクトへの関係を指定する
revHTML 属性を表すDOMStringです。注: 現在、W3C HTML 5.2 仕様では、revが廃止されていないことを示していますが、WHATWG の標準では、revが廃止されています。 この不一致が解決されるまで、廃止されていると想定する必要があります。 HTMLAnchorElement.shape- アクティブ領域の形状を表す
DOMStringです。
メソッド
親である HTMLElement からメソッドを継承し、HTMLHyperlinkElementUtils からのメソッドを実装します。
HTMLElement.blur()- 現在の要素からキーボードフォーカスを取り除きます。
HTMLElement.focus()- 現在の要素にキーボードフォーカスを与えます。
HTMLHyperlinkElementUtils.toString()- URL 全体を含む
USVStringを返します。HTMLHyperlinkElementUtils.hrefの同義語ですが、値の変更に使用することはできません。
blur() および focus() メソッドは、HTML5 以降の HTMLElement から継承されますが、DOM Level 2 HTML 以前の仕様では HTMLAnchorElement で定義されていました。
仕様
| 仕様 | 状態 | コメント |
|---|---|---|
| HTML Living Standard HTMLAnchorElement の定義 |
現行の標準 | 次のプロパティが追加されました: download。技術的には、URL 関連のプロパティの media、host、hostname、pathname、port、protocol、search、および hash は HTMLHyperlinkElementUtils ミックスインに移動され、HTMLAnchorElement はこのミックスインを実装します。 |
| HTML5 HTMLAnchorElement の定義 |
勧告 | メソッドの blur() と focus()、およびプロパティの tabindex と accessKey は、HTMLElement で定義されるようになりました。次のプロパティは廃止されました: charset、coords、name、rev、shape。次のプロパティが追加されました: hash、host、hostname、media、pathname、port、protocol、relList、search、text。 |
| Document Object Model (DOM) Level 2 HTML Specification HTMLAnchorElement の定義 |
廃止された | Document Object Model (DOM) Level 1 Specification からの変更はありません。 |
| Document Object Model (DOM) Level 1 Specification HTMLAnchorElement の定義 |
廃止された | 初期定義 |
ブラウザーの互換性
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLAnchorElement | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
accessKey | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
charset | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
coords | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
download | Chrome 完全対応 14 | Edge 完全対応 13 | Firefox 完全対応 20 | IE ? | Opera 完全対応 15 | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 18 | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS ? | Samsung Internet Android 完全対応 あり |
hreflang | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
media | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
name | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
referrerPolicy | Chrome 完全対応 51 | Edge 未対応 なし | Firefox 完全対応 50 | IE 未対応 なし | Opera 完全対応 38 | Safari 完全対応 11.1 | WebView Android 完全対応 51 | Chrome Android 完全対応 51 | Firefox Android 完全対応 50 | Opera Android 完全対応 41 | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 7.2 |
rel | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
relList | Chrome 完全対応 65 | Edge 完全対応 18 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 65 | Chrome Android 完全対応 65 | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
rev | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
shape | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
tabindex | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
target | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
text | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
type | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明
- 非標準。ブラウザー間の互換性が低い可能性があります。
- 非標準。ブラウザー間の互換性が低い可能性があります。
- 非推奨。新しいウェブサイトでは使用しないでください。
- 非推奨。新しいウェブサイトでは使用しないでください。
関連情報
- このインターフェイスを実装する HTML 要素:
<a>