<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.

* Some parts of this feature may have varying levels of support.

Das <meta> HTML Element repräsentiert Metadaten, die nicht durch andere meta-verwandte Elemente dargestellt werden können, wie <base>, <link>, <script>, <style> oder <title>.

Der Typ der Metadaten, die durch das <meta> Element bereitgestellt werden, kann einer der folgenden sein:

  • Wenn das name Attribut gesetzt ist, bietet das <meta> Element dokumentenbezogene Metadaten, die für die ganze Seite gelten.
  • Wenn das http-equiv Attribut gesetzt ist, fungiert das <meta> Element als Pragmadirektive, um Direktiven zu simulieren, die sonst durch einen HTTP-Header gegeben werden könnten.
  • Wenn das charset Attribut gesetzt ist, ist das <meta> Element eine Zeichencode-Deklaration, 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 beinhaltet die globalen Attribute.

Hinweis: Das name Attribut hat eine spezifische Bedeutung für das <meta> Element. Das itemprop Attribut darf nicht auf einem <meta> Element gesetzt sein, das ein 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-fallunempfindliche Übereinstimmung für die 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 http-equiv oder das name Attribut, je nachdem, welches verwendet wird.

http-equiv

Definiert eine Pragmadirektive. Der Name des Attributs, kurz für http-equivalent, ist so, weil alle erlaubten Werte die Namen bestimmter HTTP-Header sind:

content-security-policy

Ermöglicht es den Seitenautoren, eine Inhaltspolitik für die aktuelle Seite zu definieren. Inhaltspolitiken spezifizieren hauptsächlich erlaubte Serverursprünge und Skriptendpunkte, die helfen, Angriffe durch Cross-Site-Scripting zu verhindern. Siehe Content-Security-Policy für weitere Informationen.

content-type

Deklariert den MIME-Typ und die Zeichenkodierung des Dokuments. Das content-Attribut muss den Wert "text/html; charset=utf-8" haben, wenn es angegeben wird. Dies ist gleichbedeutend mit einem <meta> Element mit dem spezifizierten charset Attribut und unterliegt derselben Platzierungsrestriktion innerhalb des Dokuments. Hinweis: Kann nur in Dokumenten verwendet werden, die mit einem text/html-MIME-Typ bedient werden — nicht in Dokumenten, die mit einem XML-MIME-Typ bedient werden. Siehe auch Content-Type.

default-style

Setzt den Namen des Standard-CSS-Stilblatts.

x-ua-compatible

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

refresh

Diese Anweisung gibt an:

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

Der Timer beginnt, wenn die Seite vollständig geladen ist, das heißt, nachdem sowohl das load als auch das pageshow Ereignis ausgelöst wurde.

Siehe auch Refresh.

Warnung:

Seiten, die mit einem refresh-Wert eingestellt sind, laufen Gefahr, dass das Zeitintervall zu kurz ist. Menschen, die mit Hilfe von unterstützender Technologie wie einem Bildschirmleser navigieren, könnten nicht in der Lage sein, den Inhalt der Seite vollständig zu lesen und zu verstehen, bevor sie automatisch umgeleitet werden. Die abrupte, unangekündigte Aktualisierung des Seiteninhalts kann auch desorientierend für Menschen mit Sehbehinderungen sein.

media

Das media Attribut definiert, auf welche Medien die im content Attribut definierte Themenfarbe angewendet werden soll. Sein Wert ist eine Media Query, die standardmäßig all 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 name und content Attribute können zusammen verwendet werden, um Dokument-Metadaten in Form von Namen-Wert-Paaren bereitzustellen, wobei das name Attribut den Metadaten-Namen und das content Attribut den Wert angibt.

Beispiele

Setzen einer Meta-Beschreibung

Das folgende <meta> Tag bietet eine description als Metadaten für die Webseite:

html
<meta
  name="description"
  content="The HTML reference describes all elements and attributes of HTML, including global attributes that apply to all elements." />

Setzen einer Seitenumleitung

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

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

Technische Zusammenfassung

Inhaltskategorien Metadateninhalte. Wenn das itemprop Attribut vorhanden ist: Flussinhalte, Wortlautinhalte.
Erlaubter Inhalt Keiner; es ist ein leeres Element.
Tag-Auslassung Muss ein Anfangstag haben und darf keinen Endtag haben.
Erlaubte Eltern
Implizite ARIA-Rolle Keine entsprechende Rolle
Erlaubte ARIA-Rollen Keine role erlaubt
DOM-Schnittstelle [`HTMLMetaElement`](/de/docs/Web/API/HTMLMetaElement)

Spezifikationen

Specification
HTML
# the-meta-element

Browser-Kompatibilität

Siehe auch