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

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

  • Wenn das name-Attribut gesetzt ist, liefert das <meta>-Element dokumentenweite 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 Zeichensatz-Deklaration, die anzeigt, in welcher Zeichenkodierung das Dokument kodiert ist.
  • Wenn das itemprop-Attribut gesetzt ist, liefert das <meta>-Element benutzerdefinierte Metadaten.

Attribute

Dieses Element umfasst 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 werden, das bereits bestehende name-, http-equiv- oder charset-Attribute hat.

charset

Dieses Attribut gibt die Zeichenkodierung des Dokuments an. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-fallunabhängige Ü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 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-Direktive. Der Name des Attributs, kurz für http-equivalent, ist, weil alle zulässigen Werte Namen bestimmter HTTP-Header sind:

content-security-policy

Erlaubt 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-Type 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 angegebenen charset-Attribut und unterliegt denselben Platzierungsbeschränkungen innerhalb des Dokuments. Hinweis: Kann nur in Dokumenten verwendet werden, die mit text/html bereitgestellt werden — nicht in Dokumenten, die mit einem XML-MIME-Typ bereitgestellt werden.

Siehe auch Content-Type.

default-style

Setzt den Namen des Standard-CSS-Style-Sheets.

x-ua-compatible

Wenn angegeben, muss das content-Attribut den Wert "IE=edge" haben. Benutzer-Agenten sind verpflichtet, dieses Pragma zu 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 ganze Zahl ist.
  • Die Anzahl der Sekunden, bis die Seite zu einer anderen umleiten soll - wenn der Wert des content-Attributs eine nicht-negative ganze Zahl gefolgt von ;url= und einer gültigen URL ist.

Der Timer startet, wenn die Seite vollständig geladen ist, was nach den Ereignissen load und pageshow erfolgt ist.

Siehe auch Refresh.

Warnung:

Seiten, die mit einem refresh-Wert gesetzt sind, laufen Gefahr, dass das Zeitintervall zu kurz ist. Personen, die mit Hilfstechnologien wie Bildschirmlesegeräten navigieren, können möglicherweise den Inhalt der Seite nicht lesen und verstehen, bevor automatisch umgeleitet wird. Das abrupte, unangekündigte Aktualisieren des Seiteninhalts kann auch verwirrend für Menschen mit eingeschränktem Sehvermögen 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 auf all standardmäßig 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 eingeschlossen werden.

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

Siehe Standard-Metadatennamen für Details über die in der HTML-Spezifikation definierten Standard-Metadatennamen.

Beispiele

html
<meta charset="utf-8" />

<!-- Redirect page after 3 seconds -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Technische Übersicht

Inhaltskategorien Metadaten-Inhalte. Wenn das itemprop-Attribut vorhanden ist: Flussinhalte, Phrasierungsinhalte.
Erlaubter Inhalt Keiner; es ist ein void element.
Tag-Auslassung Es muss ein Start-Tag haben und darf keinen End-Tag haben.
Zulässige Elternteile
  • <meta charset>, <meta http-equiv>: ein <head>-Element. Wenn das http-equiv keine Kodierungserklärung ist, kann es auch innerhalb eines <noscript>-Elements sein, das sich im Inneren eines <head>-Elements befindet.
  • <meta name>: jedes Element, das Metadaten-Inhalte akzeptiert.
  • <meta itemprop>: jedes Element, das Metadaten-Inhalte oder Flussinhalte 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 Standard
# the-meta-element

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch