このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
<base>: 文書の基底 URL 要素
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
<base> はHTML の要素で、文書内におけるすべての相対 URL の基点となる URL を指定します。<base> 要素は、文書内に 1 つだけ置くことができます。
文書に使われている基底 URL は、スクリプトからNode.baseURI を使用して問い合わせることができます。文書に<base> 要素がなかった場合、baseURI は既定でlocation.href になります。
In this article
属性
この要素にはグローバル属性があります。
警告:<base> 要素は、href 属性またはtarget 属性、あるいはその両方を指定する必要があります。これらの属性のうち少なくとも 1 つが指定されている場合、<base> 要素は、<link> のhref 属性など、URL を属性値とする他の要素よりも前に記述する必要があります。
href文書全体を通して相対 URL に使用される基底 URL です。絶対 URL と相対 URL が使用できます。
data:および#"#target">targetキーワードまたは制作者が定義した名前で、既定の閲覧コンテキストを表し、
<a>、<area>、<form>のいずれかの要素が明示的にtarget属性を持たない場合に、移動の結果を表示する先として使用されます。以下のキーワードは特別な意味を持ちます。_self(既定値): 現在の閲覧コンテキストに結果を表示します。_blank: 新しい無名の閲覧コンテキストに結果を表示します。_parent: 現在のコンテキストの親の閲覧コンテキストに結果を表示します。親がない場合、このオプションは_selfと同じ振る舞いをします。_top: 最上位の閲覧コンテキスト(現在のコンテキストの祖先で、それ以上の親をもたない閲覧コンテキスト)に結果を表示します。親がない場合、このオプションは_selfと同じ振る舞いをします。
使用上の注意
>複数の <base> 要素
複数の<base> 要素が使用された場合、最初のhref と最初のtarget の値が使用され、他はすべて無視されます。
ページ内アンカー
文書内のフラグメントを指すリンク — 例えば<a href="#some-id"> — は<base> を使用して解決され、基底 URL にフラグメントを付けて HTTP リクエストを発行します。
例えば、<base href="https://example.com/"> が指定され、<a href="#anchor">To anchor</a> というリンクがあったとします。リンク先はhttps://example.com/#anchor となります。
target に ASCII の改行、タブ、 < を含むことはできない
target 属性に ASCII の改行、タブ、 < 文字が含まれている場合、値は_blank にリセットされます。これは、懸垂マークアップインジェクション攻撃を防ぐためです。懸垂マークアップインジェクション攻撃とは、閉じられていないターゲット属性がページに挿入され、その後に続くテキストが、ブラウザーが属性を閉じる文字に到達するまでキャプチャされる、スクリプトを使用しない攻撃です。
Open Graph
Open Graph のメタタグは<base> を認識しないので、次のように常に完全 URL を使用してください。
<meta property="og:image" content="https://example.com/thumbnail.jpg" />例
<base href="https://www.example.com/" /><base /><base href="https://example.com/" />技術的概要
| コンテンツカテゴリー | メタデータコンテンツ |
|---|---|
| 許可されている内容 | なし。この要素は空要素です。 |
| タグの省略 | 開始タグは必須で、終了タグを置くことはできません。 |
| 許可されている親要素 | <head> 要素で、他に<base> 要素を含んでいないもの。 |
| 暗黙の ARIA ロール | 対応するロールなし |
| 許可されている ARIA ロール | 許可されているrole なし |
| DOM インターフェイス | HTMLBaseElement |
仕様書
| Specification |
|---|
| HTML> # the-base-element> |