1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
---
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"><a></a></code> 要素に対応しています。 <code><a href="/ja/docs/Web/API/HTMLLinkElement">HTMLLinkElement</a></code> で表される <code><a href="/ja/docs/Web/HTML/Element/link"><link></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>
|
