<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-Elementen wie <base>, <link>, <script>, <style> oder <title> dargestellt werden können.

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

  • Wenn das name-Attribut gesetzt ist, liefert das <meta>-Element Dokumenten-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 Zeichencodierung angibt, in der das Dokument kodiert ist.
  • Wenn das itemprop-Attribut gesetzt ist, liefert 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 sein, das ein vorhandenes name-, http-equiv- oder charset-Attribut hat.

charset

Dieses Attribut deklariert die Zeichencodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-Groß- und Kleinschreibung-unabhängige Übereinstimmung mit dem String "utf-8" sein, da UTF-8 die einzige gültige Codierung für HTML5-Dokumente ist. <meta>-Elemente, die eine Zeichencodierung deklarieren, müssen sich vollständig innerhalb der ersten 1024 Byte des Dokuments befinden.

content

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

http-equiv

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

content-security-policy

Erlaubt es Seitenautoren, 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 Zeichencodierung des Dokuments. Das content-Attribut muss den Wert "text/html; charset=utf-8" haben, wenn es angegeben wird. Dies entspricht einem <meta>-Element mit dem angegebenen charset-Attribut und unterliegt derselben Einschränkung hinsichtlich der Platzierung im Dokument. Hinweis: Kann nur in Dokumenten verwendet werden, die mit einem text/html - nicht in Dokumenten, die mit einem XML-MIME-Typ bereitgestellt werden.

Siehe auch Content-Type.

default-style

Legt den Namen des voreingestellten CSS-Stilsheets fest.

x-ua-compatible

Wenn angegeben, muss das content-Attribut den Wert "IE=edge" haben. Benutzeragenten sind verpflichtet, diese Pragma-Direktive zu ignorieren.

refresh

Diese Anweisung gibt an:

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

Der Timer beginnt, wenn die Seite vollständig geladen ist, was nach dem Auslösen der load- und pageshow-Ereignisse der Fall ist.

Siehe auch Refresh.

Warnung:

Seiten mit einem refresh-Wert laufen Gefahr, dass das Zeitintervall zu kurz ist. Personen, die mit Unterstützungstechnologien wie einem Screenreader navigieren, können möglicherweise nicht den gesamten Inhalt der Seite lesen und verstehen, bevor sie automatisch weitergeleitet werden. Das abrupte, unangekündigte Aktualisieren des Seiteninhalts kann auch für Personen mit Sehbehinderungen desorientierend wirken.

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 Metadatennamen und das content-Attribut den Wert angibt.

Siehe Standard-Metadaten-Namen für Details über die Menge der in der HTML-Spezifikation definierten Standard-Metadaten-Namen.

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ßinhalt, Phraseninhalt.
Zulässiger Inhalt Keiner; es ist ein void element.
Tag-Auslassung Muss ein Starttag haben und darf keinen Endtag haben.
Zulässige Eltern
  • <meta charset>, <meta http-equiv>: ein <head>-Element. Wenn das http-equiv keine Kodierungsdeklaration ist, kann es auch innerhalb eines <noscript>-Elements befinden, das sich selbst in einem <head>-Element befindet.
  • <meta name>: jedes Element, das Metadaten-Inhalte akzeptiert.
  • <meta itemprop>: jedes Element, das Metadaten-Inhalte oder Fließinhalte akzeptiert.
Implizierte ARIA-Rolle Keine entsprechende Rolle
Zulässige 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