Standard-Metadatennamen
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>
-Element kann verwendet werden, um Dokument-Metadaten in Form von Name-Wert-Paaren bereitzustellen, wobei das Attribut name
den Namen und das Attribut content
den Wert der Metadaten angibt.
Standard-Metadatennamen, die in der HTML-Spezifikation definiert sind
Die HTML-Spezifikation definiert die folgende Menge an Standard-Metadatennamen:
-
application-name
: Der Name der Anwendung, die auf der Webseite ausgeführt wird.Hinweis:
- Browser können dies verwenden, um die Anwendung zu identifizieren. Es unterscheidet sich vom
<title>
-Element, das normalerweise den Anwendungsnamen enthält, aber auch Informationen wie den Dokumentnamen oder einen Status enthalten kann. - Einfache Webseiten sollten keinen
application-name
definieren.
- Browser können dies verwenden, um die Anwendung zu identifizieren. Es unterscheidet sich vom
-
author
: Der Name des Autors des Dokuments. -
description
: Eine kurze und präzise Zusammenfassung des Inhalts der Seite. Suchmaschinen wie Google können dieses Feld verwenden, um das Erscheinungsbild der Webseite in den Suchergebnissen zu steuern. -
generator
: Die Kennung der Software, die die Seite erzeugt hat. -
keywords
: Wörter, die für den Inhalt der Seite relevant sind, durch Kommas getrennt. -
referrer
: Steuert den HTTP-Referer
-Header von Anfragen, die vom Dokument gesendet werden:Werte für das content
Attribut von<meta name="referrer">
no-referrer
Sendet keinen HTTP- Referer
-Header.origin
Sendet den origin des Dokuments. no-referrer-when-downgrade
Sendet die vollständige URL, wenn das Ziel mindestens so sicher wie die aktuelle Seite ist (HTTP(S)→HTTPS), sendet jedoch keinen Referrer, wenn es weniger sicher ist (HTTPS→HTTP). Dies ist das Standardverhalten. origin-when-cross-origin
Sendet die vollständige URL (ohne Parameter) für `same-origin`-Anfragen, sendet jedoch nur den Origin in anderen Fällen. same-origin
Sendet die vollständige URL (ohne Parameter) für `same-origin`-Anfragen. `cross-origin`-Anfragen enthalten keinen Referrer-Header. strict-origin
Sendet den Origin, wenn das Ziel mindestens so sicher wie die aktuelle Seite ist (HTTP(S)→HTTPS), sendet jedoch keinen Referrer, wenn es weniger sicher ist (HTTPS→HTTP). strict-origin-when-cross-origin
Sendet die vollständige URL (ohne Parameter) für `same-origin`-Anfragen. Sendet den Origin, wenn das Ziel mindestens so sicher wie die aktuelle Seite ist (HTTP(S)→HTTPS). Andernfalls wird kein Referrer gesendet. unsafe-URL
Sendet die vollständige URL (ohne Parameter) für `same-origin`- oder `cross-origin`-Anfragen. Hinweis:
- Das dynamische Einfügen von
<meta name="referrer">
(mitdocument.write()
oderappendChild()
) macht das Verhalten des Referrers unvorhersehbar. - Wenn mehrere widersprüchliche Richtlinien definiert sind, wird die
no-referrer
-Richtlinie angewendet.
- Das dynamische Einfügen von
-
theme-color
: Gibt eine vorgeschlagene Farbe an, die Benutzeragenten zur Anpassung der Anzeige der Seite oder der umgebenden Benutzeroberfläche verwenden sollten. Dascontent
-Attribut enthält eine gültige CSS-<color>
. Mit demmedia
-Attribut und einer gültigen Medienanfrageliste kann das Medium festgelegt werden, auf das die Metadaten zur Themenfarbe angewendet werden. -
color-scheme
: Gibt eine oder mehrere Farbschemata an, mit denen das Dokument kompatibel ist.Der Browser verwendet diese Informationen zusammen mit den Einstellungen des Benutzers auf dem Browser oder Gerät, um festzulegen, welche Farben für alles von Hintergründen und Vordergründen zu Formularsteuerelementen und Scrollbalken verwendet werden sollen. Der Hauptzweck von
<meta name="color-scheme">
ist, die Kompatibilität mit - und die Reihenfolge der Präferenz für - helle und dunkle Farbmodi anzuzeigen.Der Wert der
content
-Eigenschaft fürcolor-scheme
kann einer der folgenden sein:normal
-
Das Dokument ist sich der Farbschemata nicht bewusst und sollte mit der Standardfarbpalette gerendert werden.
light
,dark
,light dark
,dark light
-
Eines oder mehrere vom Dokument unterstützte Farbschemata. Die mehrfache Angabe desselben Farbschemas hat denselben Effekt wie die einmalige Angabe. Die Angabe mehrerer Farbschemata zeigt, dass das erste Schema vom Dokument bevorzugt wird, aber dass das zweite angegebene Schema akzeptabel ist, wenn der Benutzer es bevorzugt.
only light
-
Gibt an, dass das Dokument nur den hellen Modus unterstützt, mit einem hellen Hintergrund und dunklen Vordergrundfarben. Laut Spezifikation ist
only dark
nicht gültig, da das Erzwingen eines Dokuments zur Darstellung im dunklen Modus, wenn es damit nicht wirklich kompatibel ist, zu unlesbarem Inhalt führen kann; alle großen Browser standardisieren auf den hellen Modus, wenn er nicht anders konfiguriert ist.
Zum Beispiel, um anzuzeigen, dass ein Dokument den dunklen Modus bevorzugt, aber auch im hellen Modus funktioniert:
html<meta name="color-scheme" content="dark light" />
Dies funktioniert auf Dokumentebene auf dieselbe Weise wie die CSS-
color-scheme
-Eigenschaft es einzelnen Elementen ermöglicht, ihre bevorzugten und akzeptierten Farbschemata anzugeben. Ihre Stile können sich an das aktuelle Farbschema mit der CSS-Medienfunktionprefers-color-scheme
anpassen.
Standard-Metadatennamen, die in anderen Spezifikationen definiert sind
Die Spezifikation zur CSS-Geräteanpassung definiert folgenden Metadatennamen:
-
viewport
: Gibt Hinweise über die Größe des anfänglichen Ansichtsfensters.Werte für den Inhalt von <meta name="viewport">
Wert Mögliche Unterwerte Beschreibung width
Eine positive ganze Zahl oder der Text device-width
Definiert die Pixelbreite des Ansichtsfensters, in der die Webseite gerendert werden soll. height
Eine positive ganze Zahl oder der Text device-height
Definiert die Höhe des Ansichtsfensters. Wird von keinem Browser verwendet. initial-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert das Verhältnis zwischen der Gerätebreite ( device-width
im Hochformat oderdevice-height
im Querformat) und der Ansichtsfenstergröße.maximum-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert den maximalen Vergrößerungsgrad. Er muss größer oder gleich dem minimum-scale
sein, andernfalls ist das Verhalten undefiniert. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert sie standardmäßig.minimum-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert die minimale Zoomstufe. Sie muss kleiner oder gleich dem maximum-scale
sein, andernfalls ist das Verhalten undefiniert. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert sie standardmäßig.user-scalable
yes
oderno
Wenn auf no
gesetzt, kann der Benutzer die Webseite nicht vergrößern. Der Standardwert istyes
. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert sie standardmäßig.viewport-fit
auto
,contain
odercover
Der Wert
auto
beeinflusst das anfängliche Layout-Viewport nicht, und die gesamte Webseite ist sichtbar.Der Wert
contain
bedeutet, dass das Ansichtsfenster so skaliert wird, dass das größte Rechteck, das innerhalb des Displays eingeschrieben ist, passt.Der Wert
cover
bedeutet, dass das Ansichtsfenster so skaliert wird, dass das Display des Geräts gefüllt ist. Es wird dringend empfohlen, die Variablen zum sicheren Bereich zu verwenden, um sicherzustellen, dass wichtige Inhalte nicht außerhalb des Displays enden.Warnung:
Das Deaktivieren der Zoomfunktionen durch Setzen von
user-scalable
aufno
verhindert, dass Personen mit Sehbehinderungen die Inhalte lesen und verstehen können.
Weitere Metadatennamen
Namen, die im WHATWG MetaExtensions-Wiki definiert sind
Die WHATWG Wiki MetaExtensions-Seite enthält eine große Menge an nicht standardisierten Metadatennamen, die noch nicht formell akzeptiert wurden; einige der dort enthaltenen Namen werden jedoch bereits häufig in der Praxis verwendet, einschließlich der folgenden:
-
creator
: Der Name des Erstellers des Dokuments, zum Beispiel eine Organisation oder Institution. Wenn es mehrere gibt, sollten mehrere<meta>
-Elemente verwendet werden. -
googlebot
, ein Synonym fürrobots
, wird nur von Googlebot (dem Indexierungs-Crawler von Google) befolgt. -
publisher
: Der Name des Herausgebers des Dokuments. -
robots
: Das Verhalten, das kooperative Crawler oder "Roboter" mit der Seite verwenden sollten. Es ist eine durch Kommas getrennte Liste der folgenden Werte:Wert Beschreibung Verwendet von index
Erlaubt dem Roboter, die Seite zu indexieren (Standard). Alle noindex
Fordert den Roboter auf, die Seite nicht zu indexieren. Alle follow
Erlaubt dem Roboter, den Links auf der Seite zu folgen (Standard). Alle nofollow
Fordert den Roboter auf, den Links auf der Seite nicht zu folgen. Alle all
Äquivalent zu index, follow
Google none
Äquivalent zu noindex, nofollow
Google noarchive
Fordert die Suchmaschine auf, den Seiteninhalt nicht im Cache zu speichern. Google, Yahoo, Bing nosnippet
Verhindert die Anzeige einer Beschreibung der Seite in den Suchmaschinenergebnissen. Google, Bing noimageindex
Fordert an, dass diese Seite nicht als die Referenzseite eines indexierten Bildes erscheint. Google nocache
Synonym für noarchive
.Bing Hinweis:
- Nur kooperative Roboter befolgen diese Regeln. Erwarten Sie nicht, E-Mail-Sammler damit zu verhindern.
- Der Roboter muss dennoch auf die Seite zugreifen, um diese Regeln zu lesen. Um den Bandbreitenverbrauch zu verhindern, überlegen Sie, ob die Verwendung einer robots.txt-Datei angemessener ist.
- Das
<meta name="robots">
-Element und dierobots.txt
-Datei dienen unterschiedlichen Zwecken:robots.txt
steuert das Crawlen von Seiten und beeinflusst nicht die Indexierung oder andere durch dasrobots
-Meta gesteuerte Verhaltensweisen. Eine Seite, die nicht gecrawlt werden kann, kann dennoch indiziert werden, wenn sie von einem anderen Dokument referenziert wird. - Wenn Sie eine Seite entfernen möchten, funktioniert
noindex
, aber nur nachdem der Roboter die Seite erneut besucht hat. Stellen Sie sicher, dass dierobots.txt
-Datei keine erneuten Besuche verhindert. - Einige Werte schließen sich gegenseitig aus, wie
index
undnoindex
, oderfollow
undnofollow
. In diesen Fällen ist das Verhalten des Roboters undefiniert und kann zwischen ihnen variieren. - Einige Crawler-Roboter, wie Google, Yahoo und Bing, unterstützen dieselben Werte für den HTTP-Header
X-Robots-Tag
; dies ermöglicht es, dass auch Nicht-HTML-Dokumente wie Bilder diese Regeln verwenden.
Andere Namen
application-title
: Wird verwendet, um die Titelleiste einer App für Webanwendungen anzupassen, die als eigenständige Apps auf unterstützenden Desktop-Betriebssystemen installiert sind. Während der Textinhalt des<title>
-Elements normalerweise in Browser-Tabs angezeigt wird, wenn die App in einem Browser ausgeführt wird, kann der Metadatennameapplication-title
verwendet werden, um einen anderen Titel für die Anwendung festzulegen, wenn sie als eigenständige installierte App ausgeführt wird.
Spezifikationen
Specification |
---|
HTML # standard-metadata-names |
Referrer Policy # referrer-policy-delivery-meta |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
name | ||||||||||||
application-title | ||||||||||||
color-scheme | ||||||||||||
referrer | ||||||||||||
theme-color |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Non-standard. Check cross-browser support before using.
- See implementation notes.
- Has more compatibility info.