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.
Das <meta>
-Element kann verwendet werden, um Dokumentmetadaten in Form von Name-Wert-Paaren bereitzustellen, wobei das name
-Attribut den Metadatennamen angibt und das content
-Attribut den Wert angibt.
Standard-Metadatennamen, die in der HTML-Spezifikation definiert sind
Die HTML-Spezifikation definiert die folgende Menge von Standard-Metadatennamen:
-
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. - Einfache Webseiten sollten keinen Anwendungsnamen 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
: der Bezeichner der Software, die die Seite erstellt hat. -
keywords
: Wörter, die für den Inhalt der Seite relevant sind, getrennt durch Kommas. -
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
Keinen HTTP- Referer
-Header senden.origin
Den origin des Dokuments senden. no-referrer-when-downgrade
Die vollständige URL senden, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS), aber keinen Referer 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 Anfragen senden, aber nur den origin in anderen Fällen. same-origin
Die vollständige URL (ohne Parameter) für gleich-origin Anfragen senden. Cross-origin Anfragen enthalten keinen Referer-Header. strict-origin
Den origin senden, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS), aber keinen Referer senden, wenn es weniger sicher ist (HTTPS→HTTP). strict-origin-when-cross-origin
Die vollständige URL (ohne Parameter) für gleich-origin Anfragen senden. Den origin senden, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS). Andernfalls keinen Referer senden. unsafe-URL
Die vollständige URL (ohne Parameter) für gleich-origin oder Cross-origin Anfragen senden. Hinweis:
- Dynamisches Einfügen von
<meta name="referrer">
(mitdocument.write()
oderappendChild()
) macht das Referer-Verhalten unvorhersehbar. - Wenn mehrere widersprüchliche Richtlinien definiert sind, wird die
no-referrer
-Richtlinie angewendet.
- Dynamisches Einfügen von
-
theme-color
: gibt eine vorgeschlagene Farbe an, die Benutzeragenten verwenden sollten, um die Anzeige der Seite oder der umgebenden Benutzeroberfläche anzupassen. Dascontent
-Attribut enthält ein gültiges CSS-<color>
. Dasmedia
-Attribut mit einer gültigen Media-Query-Liste kann enthalten sein, um das Medium festzulegen, auf das die Theme-Farbmetadaten angewendet werden. -
color-scheme
: gibt ein oder mehrere Farbschemata an, mit denen das Dokument kompatibel ist.Der Browser wird diese Informationen zusammen mit den Browser- oder Geräteeinstellungen des Benutzers verwenden, um festzulegen, welche Farben für alles vom Hintergrund und Vordergrund bis hin zu Formularsteuerelementen und Scrollleisten zu verwenden sind. Der primäre Verwendungszweck für
<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 Farbschemata nicht bewusst und sollte mit der Standardfarbpalette gerendert werden.
light
,dark
,light dark
,dark light
-
Ein oder mehrere vom Dokument unterstützte Farbschemata. Das gleiche Farbschema mehrmals anzugeben, hat die gleiche Wirkung wie es nur einmal anzugeben. Mehrere Farbschemata anzugeben bedeutet, dass das erste Schema vom Dokument bevorzugt, das zweite angegeben Schema jedoch 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. Gemäß der Spezifikation ist
only dark
nicht gültig, da das Erzwingen des Renderns eines Dokuments im dunklen Modus, wenn es nicht wirklich kompatibel ist, zu unlesbarem Inhalt führen kann; alle großen Browser standardisieren auf den hellen Modus, wenn nicht anders konfiguriert.
Zum Beispiel, um anzugeben, dass ein Dokument den dunklen Modus bevorzugt, aber auch im hellen Modus funktional rendert:
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 Farbschemata anzugeben. Ihre Stile können sich an das aktuelle Farbschema mit demprefers-color-scheme
-CSS-Media-Feature anpassen.
Standard-Metadatennamen, die in anderen Spezifikationen definiert sind
Die CSS Device Adaptation-Spezifikation definiert den folgenden Metadatennamen:
-
viewport
: gibt Hinweise zur Größe der anfänglichen Größe des viewports.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, in dem die Website gerendert werden soll. 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 Viewportgröße.maximum-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert, auf welches Maximum herangezoomt werden kann. Es muss größer oder gleich dem minimum-scale
sein oder das Verhalten ist undefiniert. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert sie standardmäßig.minimum-scale
Eine positive Zahl zwischen 0.0
und10.0
Definiert das minimale Zoomniveau. Es muss kleiner oder gleich dem maximum-scale
sein oder das Verhalten ist undefiniert. Browsereinstellungen können diese Regel ignorieren und iOS10+ ignoriert sie standardmäßig.user-scalable
yes
oderno
Wenn auf no
gesetzt, kann der Benutzer nicht in die Webseite hineinzoomen. Der Standard istyes
. Browsereinstellungen können diese Regel ignorieren, und iOS10+ ignoriert sie standardmäßig.viewport-fit
auto
,contain
odercover
Der
auto
-Wert hat keine Auswirkungen auf das anfängliche Layout Viewport und die gesamte Webseite ist sichtbar.Der
contain
-Wert bedeutet, dass der Viewport so skaliert wird, dass das größte Rechteck, das in die Anzeige eingeschrieben ist, passt.Der
cover
-Wert bedeutet, dass der Viewport so skaliert wird, dass die Gerätedisplay gefüllt wird. Es wird dringend empfohlen, die safe area inset-Variablen zu verwenden, um sicherzustellen, dass wichtiger Inhalt nicht außerhalb des Displays landet.Warnung:
Das Deaktivieren der Zoom-Fähigkeiten durch Festlegen von
user-scalable
auf einen Wert vonno
verhindert, dass Menschen mit Sehbehinderungen den Seiteninhalt lesen und verstehen können.
Andere Metadatennamen
Die WHATWG Wiki MetaExtensions-Seite enthält eine große Anzahl nicht standardisierter Metadatennamen, die noch nicht formell akzeptiert wurden; einige der dort enthaltenen Namen werden jedoch bereits häufig verwendet — einschließlich der folgenden:
-
creator
: der Name des Erstellers des Dokuments, wie zum Beispiel eine Organisation oder Institution. Wenn es mehr als einen gibt, sollten mehrere<meta>
-Elemente verwendet werden. -
googlebot
, ein Synonym fürrobots
, wird nur von Googlebot befolgt (dem Indexierungscrawler für Google). -
publisher
: der Name des Herausgebers des Dokuments. -
robots
: das Verhalten, das kooperative Crawler oder "Robots" mit der Seite verwenden sollten. Es ist eine durch Kommas getrennte Liste der unten aufgeführten Werte:Wert Beschreibung Verwendet von index
Erlaubt dem Robot, die Seite zu indexieren (Standard). Alle noindex
Fordert den Robot auf, die Seite nicht zu indexieren. Alle follow
Erlaubt dem Robot, den Links auf der Seite zu folgen (Standard). Alle nofollow
Fordert den Robot auf, den Links auf der Seite nicht zu folgen. Alle all
Entspricht index, follow
.Google none
Entspricht 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 Suchergebnissen. Google, Bing noimageindex
Fordert auf, diese Seite nicht als verweisende Seite eines indizierten Bilds anzuzeigen. Google nocache
Synonym für noarchive
.Bing Hinweis:
- Nur kooperative Robots befolgen diese Regeln. Erwarten Sie nicht, dass Sie damit E-Mail-Erntemaschinen verhindern.
- Der Robot muss immer 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
robots
-<meta>
-Tag und dierobots.txt
-Datei haben unterschiedliche Zwecke:robots.txt
steuert das Crawlen von Seiten und beeinflusst weder das Indexieren noch andere Verhaltensweisen, die durchrobots
meta gesteuert werden. Eine Seite, die nicht gecrawlt werden kann, kann trotzdem indiziert werden, wenn sie von einem anderen Dokument referenziert wird. - Wenn Sie eine Seite entfernen möchten, funktioniert
noindex
, aber nur nachdem der Robot die Seite erneut besucht. Vergewissern Sie sich, dass dierobots.txt
-Datei Wiederbesuche nicht verhindert. - Einige Werte schließen sich gegenseitig aus, wie
index
undnoindex
oderfollow
undnofollow
. In diesen Fällen ist das Verhalten des Robots undefiniert und kann zwischen ihnen variieren. - Einige Crawler-Robots, wie Google, Yahoo und Bing, unterstützen die gleichen Werte für den HTTP-Header
X-Robots-Tag
; dies ermöglicht es anderen Dokumenttypen als HTML, wie Bildern, diese Regeln zu verwenden.
Spezifikationen
Specification |
---|
HTML Standard # standard-metadata-names |
Referrer Policy # referrer-policy-delivery-meta |
Browser-Kompatibilität
BCD tables only load in the browser