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.
  • 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"> (mit document.write() oder appendChild()) macht das Referer-Verhalten unvorhersehbar.
    • Wenn mehrere widersprüchliche Richtlinien definiert sind, wird die no-referrer-Richtlinie angewendet.
  • theme-color: gibt eine vorgeschlagene Farbe an, die Benutzeragenten verwenden sollten, um die Anzeige der Seite oder der umgebenden Benutzeroberfläche anzupassen. Das content-Attribut enthält ein gültiges CSS-<color>. Das media-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ür color-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 dem prefers-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 und 10.0 Definiert das Verhältnis zwischen der Gerätebreite (device-width im Hochformat oder device-height im Querformat) und der Viewportgröße.
    maximum-scale Eine positive Zahl zwischen 0.0 und 10.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 und 10.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 oder no Wenn auf no gesetzt, kann der Benutzer nicht in die Webseite hineinzoomen. Der Standard ist yes. Browsereinstellungen können diese Regel ignorieren, und iOS10+ ignoriert sie standardmäßig.
    viewport-fit auto, contain oder cover

    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 von no 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ür robots, 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 die robots.txt-Datei haben unterschiedliche Zwecke: robots.txt steuert das Crawlen von Seiten und beeinflusst weder das Indexieren noch andere Verhaltensweisen, die durch robots 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 die robots.txt-Datei Wiederbesuche nicht verhindert.
    • Einige Werte schließen sich gegenseitig aus, wie index und noindex oder follow und nofollow. 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

Siehe auch