HTMLAnchorElement インターフェイスは、ハイパーリンク要素を表し、そのような要素のレイアウトとプレゼンテーションを操作するための特別なプロパティとメソッドを（継承元の通常の HTMLElement オブジェクトインターフェイスのものを超えて）提供します。 このインターフェイスは <a> 要素に対応しています。 HTMLLinkElement で表される <link> と混同しないでください。
プロパティ
親の 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 の定義 |
廃止された | 初期定義 |
ブラウザーの互換性
BCD tables only load in the browser
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.
関連情報
- このインターフェイスを実装する HTML 要素:
<a>