HTMLAreaElement インターフェイスは、<area> 要素のレイアウトとプレゼンテーションを操作するための特別なプロパティとメソッドを（継承により利用できる通常のオブジェクトの HTMLElement インターフェイスのものを超えて）提供します。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLAreaElement" target="_top"><rect x="341" y="65" width="150" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="416" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLAreaElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
プロパティ
親の HTMLElement からプロパティを継承し、HTMLHyperlinkElementUtils からのプロパティを実装します。
Element.accessKey- 入力フォーカスをこのコントロールに切り替える単一文字を含む
DOMStringです。 HTMLAreaElement.alt- 要素の代替テキストを含む
altHTML 属性を反映するDOMStringです。 HTMLAreaElement.coords- ホットスポット領域を定義する座標を含む
coordsHTML 属性を反映するDOMStringです。 HTMLAreaElement.download- リンク先リソースをブラウザーに表示するのではなくダウンロードすることを意図していることを示す
DOMStringです。 値は、提案されたファイル名を表します。 名前が基になる OS の有効なファイル名でない場合、ブラウザーはそれを適応させます。 HTMLHyperlinkElementUtils.hash- あれば、参照 URL のフラグメント識別子（先頭のハッシュマーク '
#' を含む）を含むUSVStringです。 HTMLHyperlinkElementUtils.host- 参照 URL のホスト名とポート（デフォルトのポートでない場合）を含む
USVStringです。 HTMLHyperlinkElementUtils.hostname- 参照 URL のホスト名を表す
USVStringです。 HTMLHyperlinkElementUtils.href- リンク先リソースの有効な URL を含む
hrefHTML 属性を反映するUSVStringです。 HTMLAreaElement.hreflang- リンク先リソースの言語を示す
hreflangHTML 属性を反映するDOMStringです。 HTMLAreaElement.media- リンク先リソースの対象メディアを示す
mediaHTML属性 を反映するDOMStringです。（訳注：仕様にありません。 記載のある資料では、複数の要素のものをまとめて説明していますが、この要素は参考情報だそうで、仕様を整理する際に蒸発してしまったのかもしれません。） HTMLAreaElement.noHref- 領域が非アクティブ（
true）かアクティブ（false）かを示すBooleanのフラグです。 HTMLHyperlinkElementUtils.password- ドメイン名の前に指定されたパスワードを含む
USVStringです。 HTMLHyperlinkElementUtils.origin読取専用- URL のオリジン、つまりスキーム（プロトコル）、ドメイン（ホスト名）、ポートを含む
USVStringを返します。 HTMLHyperlinkElementUtils.pathname- あれば、参照 URL のパス名の部分を含む
USVStringです。 HTMLHyperlinkElementUtils.port- あれば、参照 URL のポートの部分を含む
USVStringです。 HTMLHyperlinkElementUtils.protocol- 参照 URL のプロトコルの部分（末尾のコロン '
:' を含む）を含むUSVStringです。 HTMLAreaElement.referrerPolicy- リンク先リソースを取得するときに使用するリファラーを示す
referrerpolicyHTML 属性を反映するDOMStringです。 HTMLAreaElement.rel- 現在のドキュメントからリンク先リソースへの関係を示す
relHTML 属性を反映するDOMStringです。 HTMLAreaElement.relList読取専用relHTML 属性を反映するDOMTokenListを返します。 これは、現在のドキュメントからリンク先リソースへの関係をトークンのリストとして示します。HTMLHyperlinkElementUtils.search- あれば、参照 URL の検索要素（先頭の疑問符 '
?' を含む）を含むUSVStringです。 HTMLAreaElement.shape- 既知の値に制限されたホットスポットの形状を示す
shapeHTML 属性を反映するDOMStringです。 HTMLElement.tabIndex- タブ順序での要素の位置を含む
longです。 HTMLAreaElement.target- リンク先リソースを開く閲覧コンテキストを示す
targetHTML 属性を反映するDOMStringです。 HTMLAreaElement.type- リンク先リソースの MIME タイプを示す
typeHTML 属性を反映するDOMStringです。 HTMLHyperlinkElementUtils.username- ドメイン名の前に指定されたユーザー名を含む
USVStringです。
メソッド
親である HTMLElement からメソッドを継承し、HTMLHyperlinkElementUtils からのメソッドを実装します。
HTMLHyperlinkElementUtils.toString()Workerで実行されたスクリプトの URL 全体を含むUSVStringを返します。 これは、HTMLHyperlinkElementUtils.hrefの同義語です。
仕様
| 仕様 | 状態 | コメント |
|---|---|---|
| HTML Living Standard HTMLAreaElement の定義 |
現行の標準 | 次のプロパティが追加されました: download。技術的には、URL 関連のプロパティの media、host、hostname、pathname、port、protocol、search、および hash は HTMLHyperlinkElementUtils ミックスインに移動され、HTMLAreaElement はこのミックスインを実装します。 |
| HTML5 HTMLAreaElement の定義 |
勧告 | 技術的には、プロパティ tabindex および accesskey が HTMLElement で定義されるようになりました。次のプロパティは廃止されました: nohref。次のプロパティが追加されました: rel、relList、media、hreflang、type、host、hostname、pathname、port、protocol、search、hash。 |
| Document Object Model (DOM) Level 2 HTML Specification HTMLAreaElement の定義 |
廃止された | Document Object Model (DOM) Level 1 Specification からの変更はありません。 |
| Document Object Model (DOM) Level 1 Specification HTMLAreaElement の定義 |
廃止された | 初期定義 |
ブラウザーの互換性
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.
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLAreaElement | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
accessKey | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
alt | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
coords | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
download | Chrome 完全対応 54 | Edge 完全対応 13 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 54 | Chrome Android 完全対応 54 | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 6.0 |
hreflang | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
media | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
noHref | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
referrerPolicy | Chrome 完全対応 51 | Edge 完全対応 79 | Firefox 完全対応 50 | IE 未対応 なし | Opera 完全対応 38 | Safari 完全対応 11.1 | WebView Android 完全対応 51 | Chrome Android 完全対応 51 | Firefox Android 完全対応 50 | Opera Android 完全対応 41 | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 7.2 |
rel | Chrome 完全対応 54 | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 54 | Chrome Android 完全対応 54 | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 6.0 |
relList | Chrome 完全対応 65 | Edge 完全対応 18 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 65 | Chrome Android 完全対応 65 | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 9.0 |
shape | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
tabIndex | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
target | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
type | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実験的。動作が変更される可能性があります。
- 実験的。動作が変更される可能性があります。
関連情報
- このインターフェイスを実装する HTML 要素:
<area>