HTMLAnchorElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

EventTarget Node Element HTMLElement HTMLAnchorElement

インスタンスプロパティ

親である HTMLElement から継承したプロパティがあります。

HTMLAnchorElement.attributionSrc 安全なコンテキスト用 Experimental

<a> 要素の attributionsrc 属性をプログラムで取得および設定し、その属性の値を反映します。attributionsrc は、ブラウザーに Attribution-Reporting-Eligible ヘッダーを送信するように指定します。 サーバー側では、これを使用してレスポンスで Attribution-Reporting-Register-Source ヘッダーを送信し、ナビゲーションベースの帰属元を登録します。

HTMLAnchorElement.download

文字列で、リンク先リソースをブラウザーに表示するのではなくダウンロードすることを意図していることを示します。値は、提案するファイル名を表します。そのファイル名が基になる 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.ping

空白区切りの URL のリスト。リンクが続いた場合、ブラウザーは本体 PING を伴う POST リクエストを URL に送信します。

HTMLAnchorElement.port

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

HTMLAnchorElement.protocol

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

HTMLAnchorElement.referrerPolicy

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

HTMLAnchorElement.rel

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

HTMLAnchorElement.relList 読取専用

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

HTMLAnchorElement.search

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

HTMLAnchorElement.target

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

HTMLAnchorElement.text

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

HTMLAnchorElement.type

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

HTMLAnchorElement.username

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

廃止されたプロパティ

HTMLAnchorElement.charset 非推奨

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

HTMLAnchorElement.coords 非推奨

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

HTMLAnchorElement.name 非推奨

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

HTMLAnchorElement.rev 非推奨

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

HTMLAnchorElement.shape 非推奨

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

インスタンスメソッド

親である HTMLElement から継承したメソッドがあります。

HTMLAnchorElement.toString()

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

仕様書

Specification
HTML Standard
# htmlanchorelement

ブラウザーの互換性

BCD tables only load in the browser

関連情報

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