<meta>: Das Metadaten-Element

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 <meta> HTML-Element repräsentiert Metadaten, die nicht von anderen HTML-Meta-bezogenen Elementen wie <base>, <link>, <script>, <style> oder <title> dargestellt werden können.

Die Art der durch das <meta>-Element bereitgestellten Metadaten kann folgende sein:

  • Wenn das name-Attribut gesetzt ist, bietet das <meta>-Element dokumentenbezogene Metadaten, die für die gesamte Seite gelten.
  • Wenn das http-equiv-Attribut gesetzt ist, ist das <meta>-Element eine Pragma-Direktive, die Informationen bereitstellt, die einem gleichnamigen HTTP-Header entsprechen.
  • Wenn das charset-Attribut gesetzt ist, ist das <meta>-Element eine Zeichensatzdeklaration, die die Zeichenkodierung angibt, in der das Dokument kodiert ist.
  • Wenn das itemprop-Attribut gesetzt ist, bietet das <meta>-Element benutzerdefinierte Metadaten.

Attribute

Dieses Element enthält die globalen Attribute.

Hinweis: Das Attribut name hat eine spezifische Bedeutung für das <meta>-Element, und das itemprop-Attribut darf nicht auf demselben <meta>-Element gesetzt werden, das bereits irgendein name-, http-equiv- oder charset-Attribut enthält.

charset

Dieses Attribut deklariert die Zeichenkodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-fallunabhängige Übereinstimmung mit der Zeichenkette "utf-8" sein, da UTF-8 die einzige gültige Kodierung für HTML5-Dokumente ist. <meta>-Elemente, die eine Zeichenkodierung deklarieren, müssen vollständig innerhalb der ersten 1024 Bytes des Dokuments platziert werden.

content

Dieses Attribut enthält den Wert für das Attribut http-equiv oder name, abhängig davon, welches verwendet wird.

http-equiv

Definiert eine Pragma-Direktive. Der Name des Attributs, kurz für http-equivalent, da alle erlaubten Werte Namen bestimmter HTTP-Header sind:

content-security-policy

Ermöglicht es Autoren, eine Content-Policy für die aktuelle Seite zu definieren. Content-Policies spezifizieren hauptsächlich erlaubte Server-Ursprünge und Skript-Endpunkte, die helfen, Cross-Site-Scripting-Angriffe zu verhindern.

Siehe auch Content-Security-Policy.

content-type

Deklariert den MIME-Typ und die Zeichenkodierung des Dokuments. Das content-Attribut muss, falls angegeben, den Wert "text/html; charset=utf-8" haben. Dies entspricht einem <meta>-Element mit dem angegebenen charset-Attribut und unterliegt derselben Einschränkung bezüglich der Platzierung im Dokument. Hinweis: Kann nur in Dokumenten verwendet werden, die mit text/html ausgeliefert werden – nicht in Dokumenten mit einem XML-MIME-Typ.

Siehe auch Content-Type.

default-style

Setzt den Namen des Standard-CSS-Stilblatts-Sets.

x-ua-compatible

Wenn angegeben, muss das content-Attribut den Wert "IE=edge" haben. Benutzeragenten müssen diese Pragma ignorieren.

refresh

Diese Anweisung spezifiziert:

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

Der Timer startet, wenn die Seite vollständig geladen ist, also nachdem die Ereignisse load und pageshow beide ausgelöst wurden.

Siehe auch Refresh.

Warnung:

Seiten, die mit einem refresh-Wert festgelegt sind, laufen Gefahr, dass das Zeitintervall zu kurz ist. Personen, die mit Hilfe von Unterstützungstechnologie wie einem Screenreader navigieren, könnten nicht in der Lage sein, den Inhalt der Seite vollständig zu lesen und zu verstehen, bevor sie automatisch weitergeleitet werden. Das abrupte, unangekündigte Aktualisieren des Seiteninhalts kann auch für Personen mit Sehbehinderungen desorientierend sein.

media

Das media-Attribut definiert, für welche Medien die im content-Attribut definierte Themafarbe angewendet werden soll. Sein Wert ist eine Media Query, die auf all standardmäßig festgelegt ist, wenn das Attribut fehlt. Dieses Attribut ist nur relevant, wenn das name-Attribut des Elements auf theme-color gesetzt ist. Andernfalls hat es keine Wirkung und sollte nicht enthalten sein.

name

Die Attribute name und content können zusammen verwendet werden, um Dokumentmetadaten in Form von Name-Wert-Paaren bereitzustellen, wobei das name-Attribut den Metadaten-Namen angibt und das content-Attribut den Wert angibt.

Siehe Standard-Metadatennamen für Details über die Menge der im HTML-Standard definierten Standard-Metadatennamen.

Beispiele

html
<meta charset="utf-8" />

<!-- Redirect page after 3 seconds -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Technische Zusammenfassung

Inhaltskategorien Metadaten-Inhalt. Wenn das itemprop-Attribut vorhanden ist: Fließender Inhalt, Phrasierung.
Erlaubter Inhalt Keiner; es ist ein void element.
Tag-Auslassung Muss ein Start-Tag haben und darf kein End-Tag haben.
Erlaubte Eltern
Implizierte ARIA-Rolle Keine entsprechende Rolle
Erlaubte ARIA-Rollen Keine role erlaubt
DOM-Schnittstelle [`HTMLMetaElement`](/de/docs/Web/API/HTMLMetaElement)

Spezifikationen

Specification
HTML Standard
# the-meta-element

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch