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.

* Some parts of this feature may have varying levels of support.

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
# htmlanchorelement

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLAnchorElement
attributionSourceId
Experimental
attributionSrc
Experimental
charset
Deprecated
coords
Deprecated
download
hash
host
hostname
href
hrefTranslate
ExperimentalNon-standard
hreflang
name
Deprecated
origin
password
pathname
ping
port
protocol
referrerPolicy
no-referrer-when-downgrade
origin-when-cross-origin
unsafe-url
rel
relList
rev
Deprecated
search
shape
Deprecated
target
text
toString
type
username

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
Uses a non-standard name.
Has more compatibility info.

関連情報

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