Standard-Metadaten-Namen
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 name
-Attribut den Metadaten-Namen angibt und das content
-Attribut den Wert angibt.
Standard-Metadaten-Namen, die in der HTML-Spezifikation definiert sind
Die HTML-Spezifikation definiert die folgende Menge von Standard-Metadaten-Namen:
-
application-name
: der Name der Anwendung, die auf der Webseite läuft.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. - Einzelne 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 genaue Zusammenfassung des Inhalts der Seite. Suchmaschinen wie Google können dieses Feld verwenden, um das Erscheinungsbild der Webseite in den Suchergebnissen zu steuern. -
generator
: der Bezeichner der Software, die die Seite generiert hat. -
keywords
: Wörter, die für den Inhalt der Seite relevant sind, durch Kommas getrennt. -
referrer
: steuert den HTTPReferer
-Header von Anfragen, die vom Dokument gesendet werden:Werte für das content
Attribut von<meta name="referrer">
no-referrer
Keinen HTTP Referer
-Header senden.origin
Die origin des Dokuments senden. no-referrer-when-downgrade
Die vollständige URL senden, wenn das Ziel mindestens ebenso sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS), aber keinen Referrer senden, wenn es weniger sicher ist (HTTPS→HTTP). Dies ist das Standardverhalten. origin-when-cross-origin
Die vollständige URL (ohne Parameter) für gleich-originäre Anfragen senden, aber nur die Origin in anderen Fällen. same-origin
Die vollständige URL (ohne Parameter) für gleich-originäre Anfragen senden. Cross-Origin-Anfragen enthalten keinen Referrer-Header. strict-origin
Die Origin senden, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS), aber keinen Referrer senden, wenn es weniger sicher ist (HTTPS→HTTP). strict-origin-when-cross-origin
Die vollständige URL (ohne Parameter) für gleich-originäre Anfragen senden. Die Origin senden, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS). Andernfalls, keinen Referrer senden. unsafe-URL
Die vollständige URL (ohne Parameter) für gleich-originäre oder Cross-Origin-Anfragen senden. Hinweis:
- Das dynamische Einfügen von
<meta name="referrer">
(mitdocument.write()
oderappendChild()
) macht das Referrer-Verhalten 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 umliegenden Benutzeroberfläche verwenden sollten. Dascontent
-Attribut enthält ein gültiges CSS<color>
. Dasmedia
-Attribut mit einer gültigen Medienabfrageliste kann eingeschlossen werden, um das Medium festzulegen, auf das die Theme-Farbe-Metadaten angewendet werden. -
color-scheme
: gibt eine oder mehrere Farbpaletten an, mit denen das Dokument kompatibel ist.Der Browser wird diese Information zusammen mit den Benutzer- oder Geräteeinstellungen verwenden, um zu bestimmen, welche Farben von Hintergrund und Vordergrund bis hin zu Formularsteuerungen und Scrollleisten verwendet werden sollen. Der Hauptzweck von
<meta name="color-scheme">
besteht darin, die Kompatibilität mit—und die Reihenfolge der Präferenz für—helle und dunkle Farbmodi anzugeben.Der Wert der
content
-Eigenschaft fürcolor-scheme
kann einer der folgenden sein:normal
-
Das Dokument ist sich Farbpaletten nicht bewusst und sollte mit der Standardfarbpalette dargestellt werden.
light
,dark
,light dark
,dark light
-
Eine oder mehrere vom Dokument unterstützte Farbpaletten. Die Angabe derselben Farbpalette mehrmals hat den gleichen Effekt wie nur einmalige Angabe. Die Angabe mehrerer Farbpaletten gibt an, dass die erste Palette vom Dokument bevorzugt wird, die zweite jedoch akzeptabel ist, wenn der Benutzer es wünscht.
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 Dokumentes zur Anzeige im dunklen Modus, wenn es nicht wirklich damit kompatibel ist, zu unlesbarem Inhalt führen kann; alle großen Browser verwenden standardmäßig den hellen Modus, wenn nicht anders konfiguriert.
Um beispielsweise anzuzeigen, dass ein Dokument den dunklen Modus bevorzugt, aber auch im hellen Modus funktional dargestellt wird:
html<meta name="color-scheme" content="dark light" />
Dies funktioniert auf Dokumentebene auf die gleiche Weise, wie die CSS
color-scheme
-Eigenschaft es einzelnen Elementen ermöglicht, ihre bevorzugten und akzeptierten Farbpaletten anzugeben. Ihre Stile können sich an das aktuelle Farbpaletten-Schema mit demprefers-color-scheme
CSS Medien-Feature anpassen.
Standard-Metadaten-Namen, die in anderen Spezifikationen definiert sind
Die CSS Device Adaptation Spezifikation definiert den folgenden Metadaten-Namen:
-
viewport
: gibt Hinweise auf die Größe der anfänglichen Größe des viewport.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 Viewports, die Sie wünschen, dass die Webseite angezeigt wird. height
Eine positive ganze Zahl, oder der Text device-height
Definiert die Höhe des Viewports. 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 Viewport-Größe.maximum-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert das Maximum, um das gezoomt werden kann. Es muss größer oder gleich dem minimum-scale
sein, sonst ist das Verhalten undefiniert. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert dies standardmäßig.minimum-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert den minimalen Zoomlevel. Es muss kleiner oder gleich dem maximum-scale
sein, sonst ist das Verhalten undefiniert. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert dies standardmäßig.user-scalable
yes
oderno
Wenn auf no
gesetzt, kann der Benutzer die Webseite nicht vergrößern. Der Standard istyes
. Browsereinstellungen können diese Regel ignorieren, und iOS10+ ignoriert dies standardmäßig.viewport-fit
auto
,contain
odercover
Der Wert
auto
beeinflusst nicht das anfängliche Layout des Viewports, und die ganze Webseite ist sichtbar.Der Wert
contain
bedeutet, dass der Viewport skaliert wird, um das größte innerhalb des Anzeigegerätes eingezeichnete Rechteck anzuzeigen.Der Wert
cover
bedeutet, dass der Viewport skaliert wird, um das Anzeigegerät auszufüllen. Es wird empfohlen, die [safe area inset](https://www.w3.org/TR/css-env-1/#env-function)-Variablen zu verwenden, um sicherzustellen, dass wichtige Inhalte nicht außerhalb des Bildschirms enden.Warnung:
Das Deaktivieren von Zoom-Funktionen durch Setzen von
user-scalable
auf einen Wert vonno
verhindert, dass Personen mit Sehbehinderungen den Seiteninhalt lesen und verstehen können.
Andere Metadaten-Namen
Im WHATWG MetaExtensions-Wiki definierte Namen
Die WHATWG Wiki MetaExtensions-Seite enthält eine große Menge nicht-standardisierter Metadaten-Namen, die noch nicht formell akzeptiert wurden; einige der enthaltenen Namen werden jedoch bereits in der Praxis häufig verwendet, einschließlich der folgenden:
-
creator
: der Name des Erstellers des Dokuments, wie 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 Verlegers des Dokuments. -
robots
: das Verhalten, das kooperative Crawler oder "Roboter" mit der Seite verwenden sollen. 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 Suchmaschinenergebnissen. Google, Bing noimageindex
Fordert an, dass diese Seite nicht als verweisende Seite eines indexierten Bildes erscheint. Google nocache
Synonym für noarchive
.Bing Hinweis:
- Nur kooperative Roboter befolgen diese Regeln. Erwarten Sie nicht, damit E-Mail-Sammler zu verhindern.
- Der Roboter muss noch auf die Seite zugreifen, um diese Regeln zu lesen. Um 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 das Indexieren oder anderes Verhalten, das durch Meta-Robots gesteuert wird. Eine Seite, die nicht gecrawlt werden kann, kann dennoch indexiert werden, wenn sie von einem anderen Dokument referenziert wird. - Wenn Sie eine Seite entfernen möchten, wird
noindex
funktionieren, jedoch nur, nachdem der Roboter die Seite erneut besucht hat. Stellen Sie sicher, dass dierobots.txt
Datei keine erneuten Besuche verhindert. - Einige Werte sind gegenseitig ausschließend, wie
index
undnoindex
oderfollow
undnofollow
. In diesen Fällen ist das Verhalten des Roboters undefiniert und kann variieren. - Einige Crawler-Roboter, wie Google, Yahoo und Bing, unterstützen die gleichen Werte für den HTTP-Header
X-Robots-Tag
; dies ermöglicht es auch Nicht-HTML-Dokumenten wie Bildern, diese Regeln zu nutzen.
Andere Namen
application-title
: Wird verwendet, um die Titelleiste einer App für Webanwendungen anzupassen, die als eigenständige Anwendungen auf unterstützenden Desktop-Betriebssystemen installiert sind. Während der Textinhalt des<title>
-Elements normalerweise in Browser-Tabs angezeigt wird, wenn die App im Browser läuft, kann der Metadaten-Nameapplication-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 |