<meta http-equiv> 属性
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
http-equiv は <meta> 要素の属性で、文書を返したレスポンスに特定の HTTP ヘッダーが含まれているかのように、ブラウザーに処理指示を与えることができます。
このメタデータは、ページ全体に適用される文書レベルのものです。
<meta> 要素に http-equiv 属性が指定されている場合、content 属性には対応する http-equiv の値を定義します。
例えば、次の <meta> タグは、5 分後にページを更新するようにブラウザーに指示します。
<meta http-equiv="Refresh" content="300" />
値
HTTP ヘッダーの一部のみが http-equiv 値として対応しています。
これらは、以下に含まれます。
-
content-language- : 支援技術やブラウザーのスタイル設定で使用される、文書のデフォルト言語を設定します。
HTTP の
Content-Languageヘッダーと同様です。 代わりにlang属性を使用してください。
- : 支援技術やブラウザーのスタイル設定で使用される、文書のデフォルト言語を設定します。
HTTP の
-
content-type- : 文書のメディア種別(MIME タイプ)および文字エンコードを宣言します。
content属性を指定する場合、その値は"text/html; charset=utf-8"でなければなりません。 これは、charset属性が指定された<meta>要素と同等であり、文書内の配置に関する同じ制限があります。text/htmlメディア種別で提供される文書でのみ使用できます。XML 型(application/xmlまたはapplication/xhtml+xml)で提供される文書では使用できません。 HTTP のContent-Typeヘッダーを参照してください。
- : 文書のメディア種別(MIME タイプ)および文字エンコードを宣言します。
-
content-security-policy- : ページ作成者が、現在のページに対するコンテンツセキュリティポリシー (CSP) を定義できるようにします。通常、クロスサイトスクリプティング攻撃を防ぐために、許可するオリジンやスクリプトのエンドポイントを指定します。
HTTP の
Content-Security-Policyヘッダーを参照してください。
- : ページ作成者が、現在のページに対するコンテンツセキュリティポリシー (CSP) を定義できるようにします。通常、クロスサイトスクリプティング攻撃を防ぐために、許可するオリジンやスクリプトのエンドポイントを指定します。
HTTP の
-
default-style- : デフォルトの CSS スタイルシートセットの名前を設定します。
-
refresh-
: HTTP の
Refreshヘッダーと同等です。 この命令は、次のことを指定します。 -
content属性が非負の整数である場合、ページが再読み込みされるまでの秒数です。 -
content属性が非負の整数で、その後に;url=および有効な URL が続く場合、ページが別の URL にリダイレクトされるまでの秒数。タイマーは、ページが完全に読み込まれたとき、つまり
loadおよびpageshowイベントが両方発生した後、開始されます。 詳細はアクセシビリティの注意事項を参照してください。
-
-
set-cookie- : 文書にクッキーを設定します。
ブラウザーはこのプラグマを無視するようになりました。代わりに、HTTP の
Set-Cookieレスポンスヘッダーまたはdocument.cookieを使用してください。
- : 文書にクッキーを設定します。
ブラウザーはこのプラグマを無視するようになりました。代わりに、HTTP の
-
x-ua-compatible- : 現在は廃止された Microsoft Internet Explorer の古いバージョンで使用されており、指定された動作により忠実に従うようにしています。
指定する場合、
content属性の値は"IE=edge"でなければなりません。 ユーザーエージェントは、このプラグマを無視するようになりました。 この名前は、HTTP のX-UA-Compatibleヘッダーに由来しています。
- : 現在は廃止された Microsoft Internet Explorer の古いバージョンで使用されており、指定された動作により忠実に従うようにしています。
指定する場合、
警告:
一部のブラウザーは、上記に掲載されていない追加のヘッダーを処理します。
認識されないヘッダーや不正な値は無視されるため、ブラウザーの実装によって動作に不整合が生じる可能性があります。
特に、<meta http-equiv= を使用して その他のセキュリティヘッダーを設定しないでください。誤った安心感につながるおそれがあります。
アクセシビリティの注意事項
http-equiv="Refresh" が設定されたページでは、更新間隔が短くなりすぎるおそれがあります。
スクリーンリーダーなどの支援技術を利用している人は、自動的にリダイレクトされる前にページの内容を読み、理解できない可能性があります。
また、予告なくページの内容が突然更新されると、弱視の人が混乱する可能性もあります。
例
>安全でないインラインコードをブロックし、HTTPS リソースのみを許可する
この HTML の <meta> 要素は、HTTPS 経由でのリソース(画像、フォント、スクリプトなど)の読み込みのみを許可するように、デフォルトの CSP を設定します。
CSP の unsafe-inline および unsafe-eval ディレクティブは設定していないため、インラインスクリプトはブロックされます。
<meta http-equiv="Content-Security-Policy" content="default-src https:" />
同じ制限は、HTTP Content-Security-Policy ヘッダーを使用して適用することができます。
Content-Security-Policy: default-src https:
ページのリダイレクトを設定
次の例では、http-equiv="refresh" を使用して、ブラウザーにリダイレクトを実行するように指示しています。
content="3;url=https://www.mozilla.org" 属性は、3 秒後にページを https://www.mozilla.org にリダイレクトします。
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />
仕様書
| 仕様書 |
|---|
| HTML> # attr-meta-http-equiv> |
ブラウザーの互換性
関連情報
<meta name="referrer">- メタデータ:
<meta>要素 <meta>を使用した攻撃の防止(英語) (httparchive.org, 2022)