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

Der Typ der durch das <meta> Element bereitgestellten Metadaten kann einer der folgenden sein:

  • Wenn das name Attribut gesetzt ist, liefert das <meta> Element dokumentweite 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 können.
  • 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, liefert das <meta> Element benutzerdefinierte Metadaten.

Attribute

Dieses Element beinhaltet die globalen Attribute.

Hinweis: Das Attribut name hat eine spezielle Bedeutung für das <meta> Element, und das itemprop Attribut darf nicht auf demselben <meta> Element gesetzt sein, das bereits ein vorhandenes name, http-equiv oder charset Attribut hat.

charset

Dieses Attribut deklariert die Zeichenkodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-Groß-/Kleinschreibung-unschärfliche Übereinstimmung mit dem String "utf-8" sein, da UTF-8 die einzige gültige Kodierung für HTML5-Dokumente ist. <meta> Elemente, die eine Zeichenkodierung 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 Name des Attributs, abgekürzt von http-equivalent, ist, weil alle erlaubten Werte Namen bestimmter HTTP-Header sind:

content-security-policy

Erlaubt es Seitenautoren, eine Inhaltspolitik für die aktuelle Seite zu definieren. Inhaltspolitiken geben meistens erlaubte Serverherkünfte und Skriptendpunkte an, 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 den Wert "text/html; charset=utf-8" haben, falls angegeben. Dies entspricht einem <meta> Element mit dem charset Attribut und unterliegt denselben Beschränkungen hinsichtlich der Platzierung im Dokument. Hinweis: Kann nur in Dokumenten verwendet werden, die mit einem text/html bereitgestellt werden — nicht in Dokumenten, die mit einem XML MIME-Type bereitgestellt 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 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 umleiten soll - wenn der Wert des content Attributs eine nicht-negative Ganzzahl gefolgt von ;url= und einer gültigen URL ist.

Der Timer startet, wenn die Seite vollständig geladen ist, also nach den [load](/de/docs/Web/API/Window/load_event) und [pageshow](/de/docs/Web/API/Window/pageshow_event) Ereignissen, die ausgelöst wurden.

Siehe auch Refresh.

Warnung:

Seiten, die mit einem refresh Wert gesetzt sind, laufen Gefahr, dass das Zeitintervall zu kurz ist. Personen, die mit der Hilfe von unterstützender Technologie wie einem Bildschirmleser navigieren, könnten nicht in der Lage sein, den Inhalt der Seite zu lesen und zu verstehen, bevor sie automatisch umgeleitet werden. Das abrupte, unangekündigte Aktualisieren des Seiteninhalts kann auch verwirrend für Menschen mit Sehschwächen sein.

media

Das media Attribut definiert, in welchen Medien die im content Attribut definierte Themafarbe angewendet werden soll. Sein Wert ist eine Media Query, die auf all voreingestellt ist, falls das Attribut fehlt. Dieses Attribut ist nur relevant, wenn das name Attribut des Elements auf theme-color gesetzt ist. Ansonsten hat es keine Wirkung und sollte nicht enthalten sein.

name

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

Einzelheiten zu den in der HTML-Spezifikation definierten Standards für Metadaten-Namen finden Sie unter Standards für 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: Fluss-Inhalt, Phrasierungsinhalt.
Zulässiger Inhalt Keiner; es ist ein void element.
Tag-Auslassung Muss ein Start-Tag haben und darf keinen End-Tag haben.
Zulässige Eltern
  • <meta charset>, <meta http-equiv>: ein <head> Element. Wenn das http-equiv keine Deklaration der Kodierung ist, kann es auch innerhalb eines <noscript> Elements, das sich selbst in einem <head> Element befindet, sein.
  • <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
Zulässige ARIA-Rollen Keine role erlaubt
DOM Schnittstelle [`HTMLMetaElement`](/de/docs/Web/API/HTMLMetaElement)

Spezifikationen

Specification
HTML
# the-meta-element

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch