HTMLAnchorElement
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
関連情報
- このインターフェイスを実装する HTML 要素:
<a>