Standard-Metadatennamen

Die HTML-Spezifikation definiert die folgende Liste von 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 Anwendungsnamen (application-name) definieren.

• 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, 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	Senden Sie keinen HTTP Referer-Header.
  origin	Senden Sie den origin des Dokuments.
  no-referrer-when-downgrade	Senden Sie die vollständige URL, wenn das Ziel mindestens genauso sicher wie die aktuelle Seite ist (HTTP(S)→HTTPS), senden Sie jedoch keinen Referrer, wenn es weniger sicher ist (HTTPS→HTTP). Dies ist das Standardverhalten.
  origin-when-cross-origin	Senden Sie die vollständige URL (ohne Parameter) für Same-Origin-Anfragen, senden Sie jedoch nur den Origin für andere Fälle.
  same-origin	Senden Sie die vollständige URL (ohne Parameter) für Same-Origin-Anfragen. Cross-Origin-Anfragen enthalten keinen Referrer-Header.
  strict-origin	Senden Sie den Origin, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS), senden Sie jedoch keinen Referrer, wenn es weniger sicher ist (HTTPS→HTTP).
  strict-origin-when-cross-origin	Senden Sie die vollständige URL (ohne Parameter) für Same-Origin-Anfragen. Senden Sie den Origin, wenn das Ziel mindestens so sicher ist wie die aktuelle Seite (HTTP(S)→HTTPS). Andernfalls senden Sie keinen Referrer.
  unsafe-URL	Senden Sie die vollständige URL (ohne Parameter) für Same-Origin- oder Cross-Origin-Anfragen.

  Hinweis:

  • Das dynamische Einfügen von <meta name="referrer"> (mit document.write() oder appendChild()) macht das Verhalten des Referrers unvorhersehbar.
  • Wenn mehrere widersprüchliche Richtlinien definiert sind, wird die no-referrer-Richtlinie angewendet.

• theme-color: gibt eine empfohlene Farbe an, die Benutzeragenten verwenden sollten, um die Anzeige der Seite oder der umgebenden Benutzeroberfläche anzupassen. Das content-Attribut enthält eine gültige CSS-Farbe <color>. Das media-Attribut mit einer gültigen Media-Query-Liste kann enthalten sein, um das Medium festzulegen, auf das die Theme-Farben-Metadaten angewendet werden.

• color-scheme: gibt ein oder mehrere Farbschemata an, mit denen das Dokument kompatibel ist.

  Der Browser wird diese Informationen zusammen mit den Einstellungen des Benutzers im Browser oder Gerät verwenden, um zu bestimmen, welche Farben für alles verwendet werden, von Hintergrund und Vordergrund bis hin zu Formularelementen und Scrollleisten. Der Hauptverwendungszweck für <meta name="color-scheme"> besteht darin, die Kompatibilität mit - und die Präferenzreihenfolge für - helle und dunkle Farbmodi anzugeben.

  Der Wert der content-Eigenschaft für color-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

  Ein oder mehrere Farbschemata werden vom Dokument unterstützt. Das mehrmalige Angeben desselben Farbschemas hat denselben Effekt wie das einmalige Angeben. Das Angeben mehrerer Farbschemata zeigt an, dass das Dokument das erste Schema bevorzugt, das zweite angegebene Schema jedoch akzeptiert, wenn der Benutzer es bevorzugt.

  only light

  Gibt an, dass das Dokument nur den Lichtmodus unterstützt, mit einem hellen Hintergrund und dunklen Vordergrundfarben. Laut Spezifikation ist only dark nicht gültig, da das Erzwingen eines Dokuments in den Dunkelmodus, wenn es nicht wirklich damit kompatibel ist, zu unlesbarem Inhalt führen kann; alle gängigen Browser wechseln standardmäßig in den Lichtmodus, wenn sie nicht anders konfiguriert sind.

  Zum Beispiel, um anzuzeigen, dass ein Dokument den Dunkelmodus bevorzugt, aber auch im Lichtmodus funktional dargestellt wird:

  html

  <meta name="color-scheme" content="dark light" />
  

  Dies funktioniert auf Dokumentenebene auf die gleiche Weise, wie es die CSS color-scheme-Eigenschaft einzelnen Elementen ermöglicht, ihre bevorzugten und akzeptierten Farbschemata anzugeben. Ihre Stile können sich an das aktuelle Farbschema anpassen, indem Sie die prefers-color-scheme CSS-Media-Feature verwenden.

Die Spezifikation zur CSS-Geräteanpassung definiert den folgenden Metadatennamen:

• viewport: gibt Hinweise auf die Größe des anfänglichen Viewports 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, bei der Sie möchten, dass die Webseite gerendert 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 und 10.0	Definiert das Verhältnis zwischen der Gerätebreite (device-width im Hochformat oder device-height im Querformat) und der Viewport-Größe.
  maximum-scale	Eine positive Zahl zwischen 0.0 und 10.0	Definiert die maximale Vergrößerung. Sie muss größer oder gleich der minimum-scale sein, andernfalls ist das Verhalten nicht definiert. Browsereinstellungen können diese Regel ignorieren, und iOS10+ ignoriert sie standardmäßig.
  minimum-scale	Eine positive Zahl zwischen 0.0 und 10.0	Definiert die minimale Zoomstufe. Sie muss kleiner oder gleich der maximum-scale sein, andernfalls ist das Verhalten nicht definiert. Browsereinstellungen können diese Regel ignorieren, und iOS10+ ignoriert sie standardmäßig.
  user-scalable	yes oder no	Wenn auf no gesetzt, kann der Benutzer die Webseite nicht vergrößern. Der Standardwert ist yes. Browsereinstellungen können diese Regel ignorieren, und iOS10+ ignoriert sie standardmäßig.
  viewport-fit	auto, contain oder cover	Der Wert auto beeinflusst das anfängliche Layout des Viewports nicht und die gesamte Webseite ist sichtbar. Der Wert contain bedeutet, dass der Viewport skaliert wird, um das größte innerhalb des Displays eingeschriebene Rechteck zu passen. Der Wert cover bedeutet, dass der Viewport skaliert wird, um das Gerätedisplay vollständig zu füllen. Es wird dringend empfohlen, die Sicherheitsbereichs-Einfügevariablen zu verwenden, um sicherzustellen, dass wichtiger Inhalt nicht außerhalb des Displays endet.

  Warnung:

  Die Deaktivierung der Zoomfunktionalität, indem user-scalable auf no gesetzt wird, hindert Menschen mit Sehbehinderungen daran, den Seiteninhalt zu lesen und zu verstehen.

  • MDN Verständnis von WCAG, Erklärungen zur Richtlinie 1.4
  • Verständnis des Erfolgskriteriums 1.4.4 | W3C Verständnis von WCAG 2.0

Die WHATWG Wiki MetaExtensions Seite enthält eine große Anzahl nicht standardisierter Metadatennamen, die noch nicht formell angenommen 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, wie eine Organisation oder Institution. Wenn es mehrere gibt, sollten mehrere <meta>-Elemente verwendet werden.

• googlebot, ein Synonym für robots, wird nur von Googlebot (dem Indizierungs-Crawler für 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 indizieren (Standard).	Alle
  noindex	Fordert den Roboter auf, die Seite nicht zu indizieren.	Alle
  follow	Erlaubt dem Roboter, die Links auf der Seite zu folgen (Standard).	Alle
  nofollow	Fordert den Roboter 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 zu cachen.	Google, Yahoo, Bing
  nosnippet	Verhindert die Anzeige einer Beschreibung der Seite in den Suchergebnissen.	Google, Bing
  noimageindex	Fordert, dass diese Seite nicht als verweisende Seite eines indexierten Bildes erscheint.	Google
  nocache	Synonym von noarchive.	Bing

  Hinweis:

  • Nur kooperative Roboter befolgen diese Regeln. Erwarten Sie nicht, damit E-Mail-Erntewerkzeuge zu verhindern.
  • Der Roboter muss dennoch auf die Seite zugreifen, um diese Regeln zu lesen. Um den Bandbreitenverbrauch zu verhindern, prüfen Sie, ob die Verwendung einer robots.txt-Datei angemessener ist.
  • Das <meta name="robots">-Element und die robots.txt-Datei dienen unterschiedlichen Zwecken: robots.txt steuert das Crawlen von Seiten und beeinflusst nicht das Indizieren oder andere vom robots-Meta gesteuerte Verhaltensweisen. Eine Seite, die nicht gecrawlt werden kann, kann dennoch indiziert werden, wenn auf sie von einem anderen Dokument verwiesen wird.
  • Wenn Sie eine Seite entfernen möchten, funktioniert noindex, jedoch erst, nachdem der Roboter die Seite erneut besucht hat. Stellen Sie sicher, dass die robots.txt-Datei keine erneuten Besuche verhindert.
  • Einige Werte schließen sich gegenseitig aus, wie index und noindex oder follow und nofollow. 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 die gleichen Werte für den HTTP-Header X-Robots-Tag; dies ermöglicht es, dass auch Nicht-HTML-Dokumente wie Bilder diese Regeln verwenden.

• Viewport <meta> tag
• Metadaten: das <meta>-Element