---
title: HTMLAnchorElement
slug: Web/API/HTMLAnchorElement
tags:
  - API
  - HTML DOM
  - Interface
  - Reference
translation_of: Web/API/HTMLAnchorElement
---
<div>{{APIRef("HTML DOM")}}</div>

<p><span class="seoSummary"><strong><code>HTMLAnchorElement</code></strong> インターフェイスは、ハイパーリンク要素を表し、そのような要素のレイアウトとプレゼンテーションを操作するための特別なプロパティとメソッドを（継承元の通常の {{domxref("HTMLElement")}} オブジェクトインターフェイスのものを超えて）提供します。 このインターフェイスは <code><a href="/ja/docs/Web/HTML/Element/a">&lt;a&gt;</a></code> 要素に対応しています。 <code><a href="/ja/docs/Web/API/HTMLLinkElement">HTMLLinkElement</a></code> で表される <code><a href="/ja/docs/Web/HTML/Element/link">&lt;link&gt;</a></code> と混同しないでください。</span></p>

<p>{{InheritanceDiagram(600, 120)}}</p>

<h2 id="Properties" name="Properties">プロパティ</h2>

<p><em>親の {{domxref("HTMLElement")}} からプロパティを継承し、{{domxref("HTMLHyperlinkElementUtils")}} からのプロパティを実装します。</em></p>

<dl>
 <dt>{{domxref("Element.accessKey")}}</dt>
 <dd>入力フォーカスをこのハイパーリンクに切り替える単一文字を表す {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.download")}} {{experimental_inline}}</dt>
 <dd>リンク先リソースをブラウザーに表示するのではなくダウンロードすることを意図していることを示す {{domxref("DOMString")}} です。 値は、提案されたファイル名を表します。 名前が基になる OS の有効なファイル名でない場合、ブラウザーはそれを適応させます。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.hash")}}</dt>
 <dd>あれば、参照 URL の先頭のハッシュマーク ('<code>#</code>') を含むフラグメント識別子を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.host")}}</dt>
 <dd>参照 URL のホスト名とポート（デフォルトのポートでない場合）を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.hostname")}}</dt>
 <dd>参照 URL のホスト名を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.href")}}</dt>
 <dd>{{htmlattrxref("href", "a")}} HTML 属性を反映する {{domxref("USVString")}} であり、リンク先リソースの有効な URL を含みます。</dd>
 <dt>{{domxref("HTMLAnchorElement.hreflang")}}</dt>
 <dd>リンク先リソースの言語を示す {{htmlattrxref("hreflang", "a")}} HTML 属性を反映する {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.media")}}</dt>
 <dd>リンク先リソースの意図するメディアを示す {{htmlattrxref("media", "a")}} HTML 属性を反映する {{domxref("DOMString")}} です。（訳注：仕様にありません。 記載のある資料では、複数の要素のものをまとめて説明していますが、この要素は参考情報だそうで、仕様を整理する際に蒸発してしまったのかもしれません。）</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.password")}}</dt>
 <dd>ドメイン名の前に指定されたパスワードを含む {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.origin")}} {{readonlyInline}}</dt>
 <dd>URL のオリジン、つまりスキーム（プロトコル）、ドメイン（ホスト名）、ポートを含む {{domxref("USVString")}} を返します。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.pathname")}}</dt>
 <dd>あれば、参照 URL のパス名の部分を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.port")}}</dt>
 <dd>あれば、参照 URL のポートの部分を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.protocol")}}</dt>
 <dd>参照 URL の末尾のコロン ('<code>:</code>') を含むプロトコルの部分を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.referrerPolicy")}} {{experimental_inline}}</dt>
 <dd>どのリファラーを使用するかを示す {{htmlattrxref("referrerpolicy", "a")}} HTML 属性を反映する {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.rel")}}</dt>
 <dd>対象オブジェクトからリンク先オブジェクトへの関係を指定する {{htmlattrxref("rel", "a")}} HTML 属性を反映する {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.relList")}} {{readonlyInline}}</dt>
 <dd>{{htmlattrxref("rel", "a")}} HTML 属性を反映するトークンのリストとして {{domxref("DOMTokenList")}} を返します。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.search")}}</dt>
 <dd>あれば、参照 URL の先頭の疑問符 ('<code>?</code>') を含む検索要素を表す {{domxref("USVString")}} です。</dd>
 <dt>{{domxref("HTMLElement.tabindex")}}</dt>
 <dd>現在のドキュメントのタブ移動ナビゲーション順序での要素の位置を含む <code>long</code> です。</dd>
 <dt>{{domxref("HTMLAnchorElement.target")}}</dt>
 <dd>リンク先リソースを表示する場所を示す {{htmlattrxref("target", "a")}} HTML 属性を反映する {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.text")}}</dt>
 <dd>{{domxref("Node.textContent")}} プロパティの同義語である {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.type")}}</dt>
 <dd>リンク先リソースの MIME タイプを示す {{htmlattrxref("type", "a")}} HTML 属性を反映する {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.username")}}</dt>
 <dd>ドメイン名の前に指定されたユーザー名を含む {{domxref("USVString")}} です。</dd>
</dl>

<h3 id="Obsolete_properties" name="Obsolete_properties">廃止されたプロパティ</h3>

<dl>
 <dt>{{domxref("HTMLAnchorElement.charset")}} {{obsolete_inline}}</dt>
 <dd>リンク先リソースの文字エンコードを表す {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.coords")}} {{obsolete_inline}}</dt>
 <dd>コンマ区切りの座標リストを表す {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.name")}} {{obsolete_inline}}</dt>
 <dd>アンカー名を表す {{domxref("DOMString")}} です。</dd>
 <dt>{{domxref("HTMLAnchorElement.rev")}} {{obsolete_inline}}</dt>
 <dd>リンク先オブジェクトから対象オブジェクトへの関係を指定する {{htmlattrxref("rev", "a")}}  HTML 属性を表す {{domxref("DOMString")}} です。
 <div class="note"><strong>注</strong>: 現在、W3C HTML 5.2 仕様では、<code>rev</code> が廃止されていないことを示していますが、WHATWG の標準では、<code>rev</code> が廃止されています。 この不一致が解決されるまで、廃止されていると想定する必要があります。</div>
 </dd>
 <dt>{{domxref("HTMLAnchorElement.shape")}} {{obsolete_inline}}</dt>
 <dd>アクティブ領域の形状を表す {{domxref("DOMString")}} です。</dd>
</dl>

<h2 id="Methods" name="Methods">メソッド</h2>

<p><em>親である {{domxref("HTMLElement")}} からメソッドを継承し、{{domxref("HTMLHyperlinkElementUtils")}} からのメソッドを実装します。</em></p>

<dl>
 <dt>{{domxref("HTMLElement.blur()")}}</dt>
 <dd>現在の要素からキーボードフォーカスを取り除きます。</dd>
 <dt>{{domxref("HTMLElement.focus()")}}</dt>
 <dd>現在の要素にキーボードフォーカスを与えます。</dd>
 <dt>{{domxref("HTMLHyperlinkElementUtils.toString()")}}</dt>
 <dd>URL 全体を含む {{domxref("USVString")}} を返します。 {{domxref("HTMLHyperlinkElementUtils.href")}} の同義語ですが、値の変更に使用することはできません。</dd>
</dl>

<p><code>blur()</code> および <code>focus()</code> メソッドは、HTML5 以降の {{domxref("HTMLElement")}} から継承されますが、DOM Level 2 HTML 以前の仕様では <code>HTMLAnchorElement</code> で定義されていました。</p>

<h2 id="Specifications" name="Specifications">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状態</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "#htmlanchorelement", "HTMLAnchorElement")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>次のプロパティが追加されました: <code>download</code>。<br>
    技術的には、URL 関連のプロパティの <code>media</code>、<code>host</code>、<code>hostname</code>、<code>pathname</code>、<code>port</code>、<code>protocol</code>、<code>search</code>、および <code>hash</code> は {{domxref("HTMLHyperlinkElementUtils")}} ミックスインに移動され、<code>HTMLAnchorElement</code> はこのミックスインを実装します。</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "text-level-semantics.html#the-a-element", "HTMLAnchorElement")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>メソッドの <code>blur()</code> と <code>focus()</code>、およびプロパティの <code>tabindex</code> と <code>accessKey</code> は、{{domxref("HTMLElement")}} で定義されるようになりました。<br>
    次のプロパティは廃止されました: <code>charset</code>、<code>coords</code>、<code>name</code>、<code>rev</code>、<code>shape</code>。<br>
    次のプロパティが追加されました: <code>hash</code>、<code>host</code>、<code>hostname</code>、<code>media</code>、<code>pathname</code>、<code>port</code>、<code>protocol</code>、<code>relList</code>、<code>search</code>、<code>text</code>。</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM2 HTML', 'html.html#ID-48250443', 'HTMLAnchorElement')}}</td>
   <td>{{Spec2('DOM2 HTML')}}</td>
   <td>{{SpecName("DOM1")}} からの変更はありません。</td>
  </tr>
  <tr>
   <td>{{SpecName('DOM1', 'level-one-html.html#ID-48250443', 'HTMLAnchorElement')}}</td>
   <td>{{Spec2('DOM1')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div>


<p>{{Compat("api.HTMLAnchorElement")}}</p>
</div>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>このインターフェイスを実装する HTML 要素: {{HTMLElement("a")}}</li>
</ul>