HTMLAnchorElement

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 関連のプロパティの mediahosthostnamepathnameportprotocolsearch、および hashHTMLHyperlinkElementUtils ミックスインに移動され、HTMLAnchorElement はこのミックスインを実装します。
HTML5
HTMLAnchorElement の定義
勧告 メソッドの blur()focus()、およびプロパティの tabindexaccessKey は、HTMLElement で定義されるようになりました。
次のプロパティは廃止されました: charsetcoordsnamerevshape
次のプロパティが追加されました: hashhosthostnamemediapathnameportprotocolrelListsearchtext
Document Object Model (DOM) Level 2 HTML Specification
HTMLAnchorElement の定義
廃止された Document Object Model (DOM) Level 1 Specification からの変更はありません。
Document Object Model (DOM) Level 1 Specification
HTMLAnchorElement の定義
廃止された 初期定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
HTMLAnchorElementChrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
accessKeyChrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
charset
非推奨非標準
Chrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
coords
非推奨非標準
Chrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
downloadChrome 完全対応 14Edge 完全対応 13Firefox 完全対応 20IE ? Opera 完全対応 15Safari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 18Firefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS ? Samsung Internet Android 完全対応 あり
hreflangChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
mediaChrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
name
非推奨非標準
Chrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
referrerPolicyChrome 完全対応 51Edge 未対応 なしFirefox 完全対応 50IE 未対応 なしOpera 完全対応 38Safari 完全対応 11.1WebView Android 完全対応 51Chrome Android 完全対応 51Firefox Android 完全対応 50Opera Android 完全対応 41Safari iOS 未対応 なしSamsung Internet Android 完全対応 7.2
relChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
relListChrome 完全対応 65Edge 完全対応 18Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 65Chrome Android 完全対応 65Firefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
rev
非推奨非標準
Chrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
shape
非推奨非標準
Chrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
tabindexChrome 完全対応 ありEdge 完全対応 ありFirefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
targetChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
textChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
typeChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非推奨。新しいウェブサイトでは使用しないでください。
非推奨。新しいウェブサイトでは使用しないでください。

関連情報

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