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
で表されるものであり、混同しないでください。
インスタンスプロパティ
親である 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>