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

Der Typ der von dem <meta>-Element bereitgestellten Metadaten kann einer der folgenden sein:

  • Wenn das name-Attribut gesetzt ist, bietet das <meta>-Element Dokumentenebenen-Metadaten, die für die gesamte Seite gelten.
  • Wenn das http-equiv-Attribut gesetzt ist, fungiert das <meta>-Element als Pragma-Direktive, 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 Zeichensatz-Deklaration, die die Zeichencodierung angibt, in der das Dokument kodiert ist.
  • Wenn das itemprop-Attribut gesetzt ist, bietet das <meta>-Element benutzerdefinierte Metadaten.

Attribute

Dieses Element umfasst die globalen Attribute.

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

charset

Dieses Attribut deklariert die Zeichencodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-Groß-/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 Bytes 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 Attributname, kurz für http-equivalent, liegt daran, dass alle zugelassenen Werte Namen bestimmter HTTP-Header sind:

content-security-policy

Ermöglicht es Seitenautoren, eine Inhaltspolitik für die aktuelle Seite zu definieren. Inhaltspolitiken spezifizieren hauptsächlich erlaubte Serverquellen und Skriptendpunkte, die dabei helfen, Cross-Site-Scripting-Angriffe zu verhindern. Weitere Informationen finden Sie unter 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, falls angegeben. Dies entspricht einem <meta>-Element mit dem charset-Attribut und unterliegt der gleichen Einschränkung hinsichtlich der Platzierung innerhalb des Dokuments. Hinweis: Kann nur in Dokumenten verwendet werden, die mit einem text/html bedient werden — nicht in Dokumenten, die mit einem XML-MIME-Typ bedient werden. Siehe auch Content-Type.

default-style

Legt den Namen des Standard-CSS-Stylesheets 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 spezifiziert:

  • Die Anzahl der Sekunden bis zum Neuladen der Seite - wenn der Wert des content-Attributes eine nicht negative ganze Zahl ist.
  • Die Anzahl der Sekunden bis zum Weiterleiten der Seite zu einer anderen - wenn der Wert des content-Attributes eine nicht negative ganze Zahl ist, gefolgt von ;url= und einer gültigen URL.

Der Timer startet, wenn die Seite vollständig geladen ist, d.h. nach dem Auslösen der load- und pageshow-Ereignisse.

Siehe auch Refresh.

Warnung:

Seiten, die einen refresh-Wert setzen, laufen Gefahr, dass das Zeitintervall zu kurz ist. Personen, die mit Unterstützungstechnologie wie einem Screenreader navigieren, könnten nicht in der Lage sein, den Inhalt der Seite zu lesen und zu verstehen, bevor sie automatisch weitergeleitet werden. Das abrupte, unangekündigte Aktualisieren des Seiteninhalts kann auch für Menschen mit Sehbehinderung verwirrend 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 auf alle eingestellt 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 und das content-Attribut den Wert liefert.

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 anzuweisen, eine Weiterleitung durchzuführen. Das Attribut content="3;url=https://www.mozilla.org" leitet die Seite nach 3 Sekunden auf https://www.mozilla.org weiter:

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

Technische Zusammenfassung

Inhaltskategorien Metadaten-Inhalt. Wenn das itemprop-Attribut vorhanden ist: Fluss-Inhalt, Phrasierungs-Inhalt.
Erlaubter Inhalt Keiner; es ist ein void element.
Tag-Auslassung Muss ein Start-Tag haben und darf kein End-Tag haben.
Erlaubte Eltern
  • <meta charset>, <meta http-equiv>: ein <head> Element. Wenn das http-equiv keine Kodierungsdeklaration ist, kann es sich auch innerhalb eines <noscript>-Elements befinden, das selbst innerhalb eines <head>-Elements liegt.
  • <meta name>: jedes Element, das Metadaten-Inhalt akzeptiert.
  • <meta itemprop>: jedes Element, das Metadaten-Inhalt oder Fluss-Inhalt akzeptiert.
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