HTMLAnchorElement

HTMLAnchorElement インターフェイスはハイパーリンク要素を表し、そのような要素のレイアウトと表示を操作するための特別なプロパティとメソッド(継承元である通常の HTMLElement オブジェクトインターフェイスにないもの)を提供します。 このインターフェイスは <a> 要素に対応しています。 <link>HTMLLinkElement で表されるものであり、混同しないでください。

EventTarget Node Element HTMLElement HTMLAnchorElement

プロパティ

親である HTMLElement からプロパティを継承しています。

HTMLElement.accessKey

文字列で、入力フォーカスをこのハイパーリンクに切り替える単一文字を表します。

HTMLAnchorElement.download Experimental

文字列で、リンク先リソースをブラウザーに表示するのではなくダウンロードすることを意図していることを示します。値は、提案するファイル名を表します。そのファイル名が基になる OS の有効なファイル名でなかった場合は、ブラウザーが修正します。

HTMLAnchorElement.hash

文字列で、参照する URL の先頭のハッシュマーク ('#') を含むフラグメント識別子を表します。

HTMLAnchorElement.host

文字列で、参照する URL のホスト名とポート番号(既定のポート番号でない場合)を表します。

HTMLAnchorElement.hostname

文字列で、参照する URL のホスト名を表します。

HTMLAnchorElement.href

文字列で、 HTML の href 属性を反映し、リンク先リソースの有効な URL を含みます。

HTMLAnchorElement.hreflang

文字列で、リンク先リソースの言語を示す HTML の hreflang 属性を反映します。

HTMLAnchorElement.origin 読取専用

URL のオリジン、つまりスキーム(プロトコル)、ドメイン(ホスト名)、ポートを含む文字列を返します。

HTMLAnchorElement.password

ドメイン名の前に指定されたパスワードを含む文字列を返します。

HTMLAnchorElement.pathname

最初の '/' に続き、クエリー文字列やフラグメントを含まない URL のパスを含む文字列です。

HTMLAnchorElement.port

文字列で、参照する URL のポート番号部分がある場合は、それを表します。

HTMLAnchorElement.protocol

文字列で、参照する URL の末尾のコロン (':') を含むプロトコルの部分を表します。

HTMLAnchorElement.referrerPolicy Experimental

文字列で、どのリファラーを使用するかを示す HTML の referrerpolicy 属性を反映します。

HTMLAnchorElement.rel

文字列で、対象オブジェクトからリンク先オブジェクトへの関係を指定する HTML の rel 属性を反映します。

HTMLAnchorElement.relList 読取専用

DOMTokenList で、 HTML の rel 属性を反映するトークンのリストを返します。

HTMLAnchorElement.search

参照する URL の検索要素(先頭の疑問符 ('?') を含む)をがあれば、それを表す文字列です。

HTMLElement.tabIndex

現在の文書のタブ移動ナビゲーション順序での要素の位置を含む long です。

HTMLAnchorElement.target

文字列で、リンク先リソースを表示する場所を示す HTML の target 属性を反映します。

HTMLAnchorElement.text

文字列で、 Node.textContent プロパティの別名です。

HTMLAnchorElement.type

文字列で、リンク先リソースの MIME タイプを示す HTML の type 属性を反映します。

HTMLAnchorElement.username

ドメイン名の前に指定されたユーザー名を含む文字列です。

廃止されたプロパティ

HTMLAnchorElement.charset Deprecated

文字列で、リンク先リソースの文字エンコードを表します。

HTMLAnchorElement.coords Deprecated

文字列で、カンマ区切りの座標リストを表します。

HTMLAnchorElement.name Deprecated

文字列で、アンカー名を表します。

HTMLAnchorElement.rev Deprecated

文字列で、リンク先オブジェクトから対象オブジェクトへの関係を指定する HTML の rev HTML 属性を表します。

メモ: 現在、W3C HTML 5.2 仕様では、rev が廃止されていないことを示していますが、WHATWG の標準では、rev が廃止されています。この不一致が解決されるまで、廃止されていると想定する必要があります。

HTMLAnchorElement.shape Deprecated

文字列で、アクティブ領域の形状を表します。

メソッド

親である HTMLElement からメソッドを継承しています。

HTMLElement.blur

現在の要素からキーボードフォーカスを取り除きます。

HTMLElement.focus

現在の要素にキーボードフォーカスを与えます。

HTMLAnchorElement.toString()

URL 全体を含む文字列を返します。 HTMLAnchorElement.href と同じですが、値の変更に使用することはできません。

blur() および focus() メソッドは、HTML5 以降の HTMLElement から継承されますが、DOM Level 2 HTML 以前の仕様では HTMLAnchorElement で定義されていました。

仕様書

Specification
HTML Standard
# htmlanchorelement

ブラウザーの互換性

BCD tables only load in the browser

関連情報

  • このインターフェイスを実装する HTML 要素: <a>