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.href
href
HTML 属性を反映するUSVString
であり、リンク先リソースの有効な URL を含みます。HTMLAnchorElement.hreflang
- リンク先リソースの言語を示す
hreflang
HTML 属性を反映するDOMString
です。 HTMLAnchorElement.media
- リンク先リソースの意図するメディアを示す
media
HTML 属性を反映するDOMString
です。(訳注:仕様にありません。 記載のある資料では、複数の要素のものをまとめて説明していますが、この要素は参考情報だそうで、仕様を整理する際に蒸発してしまったのかもしれません。) HTMLHyperlinkElementUtils.password
- ドメイン名の前に指定されたパスワードを含む
USVString
です。 HTMLHyperlinkElementUtils.origin
読取専用- URL のオリジン、つまりスキーム(プロトコル)、ドメイン(ホスト名)、ポートを含む
USVString
を返します。 HTMLHyperlinkElementUtils.pathname
- あれば、参照 URL のパス名の部分を表す
USVString
です。 HTMLHyperlinkElementUtils.port
- あれば、参照 URL のポートの部分を表す
USVString
です。 HTMLHyperlinkElementUtils.protocol
- 参照 URL の末尾のコロン ('
:
') を含むプロトコルの部分を表すUSVString
です。 HTMLAnchorElement.referrerPolicy
- どのリファラーを使用するかを示す
referrerpolicy
HTML 属性を反映するDOMString
です。 HTMLAnchorElement.rel
- 対象オブジェクトからリンク先オブジェクトへの関係を指定する
rel
HTML 属性を反映するDOMString
です。 HTMLAnchorElement.relList
読取専用rel
HTML 属性を反映するトークンのリストとしてDOMTokenList
を返します。HTMLHyperlinkElementUtils.search
- あれば、参照 URL の先頭の疑問符 ('
?
') を含む検索要素を表すUSVString
です。 HTMLElement.tabindex
- 現在のドキュメントのタブ移動ナビゲーション順序での要素の位置を含む
long
です。 HTMLAnchorElement.target
- リンク先リソースを表示する場所を示す
target
HTML 属性を反映するDOMString
です。 HTMLAnchorElement.text
Node.textContent
プロパティの同義語であるDOMString
です。HTMLAnchorElement.type
- リンク先リソースの MIME タイプを示す
type
HTML 属性を反映するDOMString
です。 HTMLHyperlinkElementUtils.username
- ドメイン名の前に指定されたユーザー名を含む
USVString
です。
廃止されたプロパティ
HTMLAnchorElement.charset
- リンク先リソースの文字エンコードを表す
DOMString
です。 HTMLAnchorElement.coords
- コンマ区切りの座標リストを表す
DOMString
です。 HTMLAnchorElement.name
- アンカー名を表す
DOMString
です。 HTMLAnchorElement.rev
- リンク先オブジェクトから対象オブジェクトへの関係を指定する
rev
HTML 属性を表す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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
関連情報
- このインターフェイスを実装する HTML 要素:
<a>