<meta>: Das Metadatenelement

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-bezogene Elemente, 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 dokumentenbezogene Metadaten, die für die gesamte Seite gelten.
  • Wenn das http-equiv-Attribut gesetzt ist, ist das <meta>-Element eine Pragma-Anweisung, die Informationen bereitstellt, die einem ähnlich benannten HTTP-Header entsprechen können.
  • Wenn das charset-Attribut gesetzt ist, ist das <meta>-Element eine Zeichencodierungserklärung, 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 bereits vorhandene name-, http-equiv- oder charset-Attribute hat.

charset

Dieses Attribut deklariert die Zeichencodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-Groß-/Kleinschreibung-unabhängige Übereinstimmung mit der Zeichenkette "utf-8" sein, da UTF-8 die einzige gültige Codierung für HTML5-Dokumente ist. <meta>-Elemente, die eine Zeichencodierung 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 name-Attribut, je nachdem, welches verwendet wird.

http-equiv

Definiert eine Pragma-Anweisung. Der Name des Attributs, kurz für http-equivalent, ist, weil alle zulässigen 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 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 ist. Dies entspricht einem <meta>-Element mit dem angegebenen charset-Attribut und unterliegt derselben Platzierungsbeschränkung im Dokument. Hinweis: Kann nur in Dokumenten verwendet werden, die mit text/html serviert werden — nicht in Dokumenten, die mit einem XML MIME-Typ serviert 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, dieses Pragma zu ignorieren.

refresh

Diese Anweisung spezifiziert:

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

Der Timer startet, wenn die Seite vollständig geladen ist, also nachdem die load- und die pageshow-Ereignisse beide 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 Hilfe von unterstützender Technologie wie einem Screenreader navigieren, könnten nicht in der Lage sein, den Inhalt der Seite zu lesen und zu verstehen, bevor sie automatisch umgeleitet werden. Das plötzliche, unangekündigte Aktualisieren des Seiteninhalts kann auch desorientierend für Personen mit Sehbehinderungen sein.

media

Das media-Attribut definiert, auf welche Medien die im content-Attribut definierte Theme-Farbe angewendet werden soll. Sein Wert ist eine Media-Query, die auf all voreingestellt 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 Name-Wert-Paaren bereitzustellen, wobei das name-Attribut den Metadatennamen liefert und das content-Attribut den Wert.

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

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: Flussinhalt, Phraseninhalt.
Erlaubter Inhalt Keiner; es ist ein leeres 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 Deklaration der Kodierung ist, kann es auch innerhalb eines <noscript>-Elements, selbst innerhalb eines <head>-Elements sein.
  • <meta name>: jedes Element, das Metadaten-Inhalt akzeptiert.
  • <meta itemprop>: jedes Element, das Metadaten-Inhalt oder Flussinhalt akzeptiert.
Implizite ARIA-Rolle Keine entsprechende Rolle
Erlaubte ARIA-Rollen Kein role erlaubt
DOM-Schnittstelle [`HTMLMetaElement`](/de/docs/Web/API/HTMLMetaElement)

Spezifikationen

Specification
HTML
# the-meta-element

Browser-Kompatibilität

Siehe auch