<meta> http-equiv-Attribut

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das http-equiv-Attribut des <meta>-Elements ermöglicht es Ihnen, dem Browser Verarbeitungsanweisungen zu geben, als ob die Antwort, die das Dokument zurückgab, bestimmte HTTP-Header einschloss. Die Metadaten sind Dokument-Ebenen-Metadaten, die für die gesamte Seite gelten.

Wenn ein <meta>-Element ein http-equiv-Attribut hat, definiert ein content-Attribut den entsprechenden http-equiv-Wert. Zum Beispiel weist das folgende <meta>-Tag den Browser an, die Seite nach 5 Minuten zu aktualisieren:

html
<meta http-equiv="Refresh" content="300" />

Wert

Nur eine Teilmenge der HTTP-Header wird als http-equiv-Werte unterstützt. Diese umfassen:

content-language

Legt eine Standard-Sprache für das Dokument fest, die von unterstützenden Technologien oder beim Styling durch den Browser verwendet wird. Ähnlich dem Content-Language HTTP-Header. Verwenden Sie stattdessen das lang-Attribut.

content-type

Deklariert den Medientyp (MIME-Typ) und die Zeichenkodierung des Dokuments. Das content-Attribut muss "text/html; charset=utf-8" sein, wenn es spezifiziert ist. Dies entspricht einem <meta>-Element mit dem charset-Attribut und unterliegt denselben Einschränkungen hinsichtlich der Platzierung im Dokument. Kann nur in Dokumenten verwendet werden, die mit einem text/html-Medientyp bereitgestellt werden – nicht in Dokumenten, die mit einem XML- (application/xml oder application/xhtml+xml) Typ bereitgestellt werden. Siehe den Content-Type HTTP-Header.

content-security-policy

Ermöglicht es Seitenautoren, eine Content-Security-Policy (CSP) für die aktuelle Seite zu definieren, typischerweise um erlaubte Ursprünge und Skriptendpunkte festzulegen, um Cross-Site-Scripting-Angriffe zu verhindern. Siehe den Content-Security-Policy HTTP-Header.

default-style

Legt den Namen des Standard-CSS-Stylesheets fest.

refresh

Entspricht dem Refresh HTTP-Header. Diese Anweisung gibt an:

  • Die Anzahl der Sekunden, bis die Seite neu geladen werden soll, wenn das content-Attribut eine nicht-negative ganze Zahl ist.
  • Die Anzahl der Sekunden, bis die Seite zu einer anderen URL weiterleiten soll, wenn das content-Attribut eine nicht-negative ganze Zahl gefolgt von ;url= und einer gültigen URL ist.

Der Timer beginnt, wenn die Seite vollständig geladen ist, also nachdem sowohl die load- als auch die pageshow-Ereignisse abgefeuert wurden. Siehe Barrierefreiheitsbedenken für weitere Informationen.

Setzt ein Cookie für das Dokument. Browser ignorieren jetzt dieses Pragma; verwenden Sie den Set-Cookie HTTP-Antwort-Header oder document.cookie stattdessen.

x-ua-compatible

Wurde von älteren Versionen des inzwischen eingestellten Microsoft Internet Explorer verwendet, damit es das spezifizierte Verhalten besser befolgte. Wenn angegeben, muss das content-Attribut den Wert "IE=edge" haben. Benutzeragenten ignorieren jetzt dieses Pragma. Der Name leitet sich vom X-UA-Compatible HTTP-Header ab.

Warnung: Einige Browser verarbeiten zusätzlich Header, die oben nicht aufgeführt sind. Da nicht erkannte Header oder ungültige Werte ignoriert werden, kann dies zu inkonsistentem Verhalten bei Browserimplementierungen führen. Insbesondere: Setzen Sie keine anderen Sicherheits-Header mit <meta http-equiv= fest, da dies zu einem falschen Sicherheitsgefühl führen kann!

Barrierefreiheitsbedenken

Seiten, die mit einem http-equiv="Refresh"-Wert eingestellt sind, laufen Gefahr, dass das Aktualisierungsintervall zu kurz ist. Menschen, die mit Hilfe von unterstützender Technologie wie einem Bildschirmlesegerät navigieren, können möglicherweise den Inhalt der Seite nicht durchlesen und verstehen, bevor sie automatisch umgeleitet werden. Abrupte, unangekündigte Seitenupdates können auch desorientierend für Menschen mit Sehbehinderungen sein.

Beispiele

Unsicheren Inline-Code deaktivieren und nur HTTPS-Ressourcen erlauben

Dieses HTML-<meta>-Element setzt die Standard-CSP so, dass nur das Laden von Ressourcen (Bilder, Schriften, Skripte usw.) über HTTPS erlaubt ist. Da die Direktiven unsafe-inline und unsafe-eval nicht gesetzt sind, werden Inline-Skripte blockiert:

html
<meta http-equiv="Content-Security-Policy" content="default-src https:" />

Die gleichen Einschränkungen können mit dem HTTP-Content-Security-Policy-Header angewandt werden:

http
Content-Security-Policy: default-src https:

Eine Seitenumleitung einrichten

Das folgende Beispiel verwendet http-equiv="refresh", um den Browser anzuweisen, eine Umleitung durchzuführen. Das content="3;url=https://www.mozilla.org"-Attribut wird die Seite nach 3 Sekunden auf https://www.mozilla.org umleiten:

html
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Spezifikationen

Specification
HTML
# attr-meta-http-equiv

Browser-Kompatibilität

Siehe auch