Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

rel HTML-Attribut

Das Attribut rel definiert die Beziehung zwischen einer verlinkten Ressource und dem aktuellen Dokument. Das Attribut ist gültig auf <link>, <a>, <area>, und <form>. Die unterstützten Werte hängen vom Element ab, auf dem das Attribut gefunden wird.

Der Beziehungstyp wird durch den Wert des rel-Attributs angegeben, das, falls vorhanden, einen Wert haben muss, der eine ungeordnete Menge von einzigartigen, durch Leerzeichen getrennten Schlüsselwörtern ist. Anders als ein class-Name, der keine Semantik ausdrückt, muss das rel-Attribut Token enthalten, die semantisch sowohl für Maschinen als auch Menschen gültig sind. Die aktuellen Register für die möglichen Werte des rel-Attributs sind das IANA-Link-Beziehungsregister, der HTML Living Standard und die frei bearbeitbare existing-rel-values-Seite im Microformats-Wiki, wie im Living Standard vorgeschlagen. Wenn ein rel-Attribut verwendet wird, das nicht in einer der drei oben genannten Quellen vorhanden ist, werden einige HTML-Validatoren (wie der W3C Markup Validation Service) eine Warnung generieren.

Die folgende Tabelle listet einige der wichtigsten existierenden Schlüsselwörter auf. Jedes Schlüsselwort innerhalb eines durch Leerzeichen getrennten Wertes sollte innerhalb dieses Wertes einzigartig sein.

rel-Wert Beschreibung <link> <a> und <area> <form>
alternate Alternative Darstellungen des aktuellen Dokuments. Link Link Nicht erlaubt
author Autor des aktuellen Dokuments oder Artikels. Link Link Nicht erlaubt
bookmark Permalink für den nächstgelegenen Vorgängerabschnitt. Nicht erlaubt Link Nicht erlaubt
canonical Bevorzugte URL für das aktuelle Dokument. Link Nicht erlaubt Nicht erlaubt
compression-dictionary Link zu einem Kompressionswörterbuch, das verwendet werden kann, um zukünftige Downloads von Ressourcen auf dieser Seite zu komprimieren. Link Nicht erlaubt Nicht erlaubt
dns-prefetch Teilt dem Browser mit, die DNS-Auflösung für den Ursprung der Zielressource vorauseilend durchzuführen. Externe Ressource Nicht erlaubt Nicht erlaubt
external Das referenzierte Dokument gehört nicht zur gleichen Seite wie das aktuelle Dokument. Nicht erlaubt Anmerkung Anmerkung
expect Wenn mit blocking="render" verwendet, erlaubt es der Seite, render-blocked zu sein, bis die wesentlichen Teile des Dokuments geparst sind, sodass es konsistent gerendert wird. Link Nicht erlaubt Nicht erlaubt
help Link zu kontextabhängiger Hilfe. Link Link Link
icon Ein Symbol, das das aktuelle Dokument repräsentiert. Externe Ressource Nicht erlaubt Nicht erlaubt
license Weist darauf hin, dass der Hauptinhalt des aktuellen Dokuments durch die Urheberrechtslizenz abgedeckt ist, die im referenzierten Dokument beschrieben wird. Link Link Link
manifest Web-App-Manifest. Link Nicht erlaubt Nicht erlaubt
me Weist darauf hin, dass das aktuelle Dokument die Person repräsentiert, der der verlinkte Inhalt gehört. Link Link Nicht erlaubt
modulepreload Teilt dem Browser mit, das Skript vorauseilend zu holen und es im Modul-Map-Cache des Dokuments für eine spätere Bewertung zu speichern. Optional können die Abhängigkeiten des Moduls ebenfalls abgerufen werden. Externe Ressource Nicht erlaubt Nicht erlaubt
next Weist darauf hin, dass das aktuelle Dokument Teil einer Serie ist und dass das nächste Dokument in der Serie das referenzierte Dokument ist. Link Link Link
nofollow Weist darauf hin, dass der ursprüngliche Autor oder Anbieter des aktuellen Dokuments das referenzierte Dokument nicht unterstützt. Nicht erlaubt Anmerkung Anmerkung
noopener Erstellt einen obersten Browsing-Kontext, der kein Hilfskontext ist, wenn der Hyperlink einen der beiden erstellen würde, um zu beginnen (d.h. ein entsprechender target-Attributswert hat). Nicht erlaubt Anmerkung Anmerkung
noreferrer Kein Referer-Header wird enthalten sein. Zusätzlich hat es die gleiche Wirkung wie noopener. Nicht erlaubt Anmerkung Anmerkung
opener Erstellt einen Hilfsbrowsing-Kontext, wenn der Hyperlink andernfalls einen obersten Browsing-Kontext erstellen würde, der kein Hilfskontext ist (d.h. hat "_blank" als target-Attributwert). Nicht erlaubt Anmerkung Anmerkung
pingback Gibt die Adresse des Pingback-Servers an, der Pingbacks zu dem aktuellen Dokument bearbeitet. Externe Ressource Nicht erlaubt Nicht erlaubt
preconnect Gibt an, dass der Benutzeragent vorauseilend eine Verbindung zum Ursprung der Zielressource herstellen soll. Externe Ressource Nicht erlaubt Nicht erlaubt
prefetch Gibt an, dass der Benutzeragent die Zielressource vorauseilend abrufen und im Cache speichern soll, da es wahrscheinlich für eine Folgenavigation benötigt wird. Externe Ressource Nicht erlaubt Nicht erlaubt
preload Gibt an, dass der Benutzeragent vorauseilend die Zielressource für die aktuelle Navigation gemäß dem potenziellen Ziel, das durch das as-Attribut (und die damit verbundene Priorität) gegeben ist, abrufen und im Cache speichern muss. Externe Ressource Nicht erlaubt Nicht erlaubt
prerender Gibt an, dass der Benutzeragent die Zielressource vorauseilend abrufen und sie in einer Weise verarbeiten soll, die in der Zukunft eine schnellere Antwort liefert. Diese Funktion wird durch die Speculation Rules API abgelöst. Externe Ressource Nicht erlaubt Nicht erlaubt
prev Weist darauf hin, dass das aktuelle Dokument Teil einer Serie ist und dass das vorherige Dokument in der Serie das referenzierte Dokument ist. Link Link Link
privacy-policy Gibt einen Link zu Informationen über die Datenschutz- und Nutzungspraktiken, die für das aktuelle Dokument gelten. Link Link Nicht erlaubt
search Gibt einen Link zu einer Ressource an, die verwendet werden kann, um durch das aktuelle Dokument und seine verwandten Seiten zu suchen. Link Link Link
stylesheet Importiert ein Stylesheet. Externe Ressource Nicht erlaubt Nicht erlaubt
tag Gibt ein Tag (identifiziert durch die angegebene Adresse) an, das auf das aktuelle Dokument zutrifft. Nicht erlaubt Link Nicht erlaubt
terms-of-service Link zur Vereinbarung oder zu den Nutzungsbedingungen zwischen dem Anbieter des Dokuments und Nutzern, die das Dokument verwenden möchten. Link Link Nicht erlaubt

Das rel-Attribut ist relevant für die <link>, <a>, <area> und <form> Elemente, jedoch sind einige Werte nur für eine Teilmenge dieser Elemente relevant. Wie bei allen HTML-Keyword-Attributwerten sind diese Werte nicht unterscheidend nach Groß- und Kleinschreibung.

Das rel-Attribut hat keinen Standardwert. Wenn das Attribut weggelassen wird oder wenn keiner der Werte im Attribut unterstützt wird, besteht keine spezielle Beziehung zwischen dem Dokument und der Zielressource, außer dass ein Hyperlink zwischen beiden besteht. In diesem Fall erstellt das Element auf <link> und <form> keine Links, wenn das rel-Attribut fehlt, keine Schlüsselwörter enthält oder wenn nicht eines oder mehrere der oben durch Leerzeichen getrennten Schlüsselwörter vorhanden sind. <a> und <area> werden immer noch Links erstellen, jedoch ohne eine definierte Beziehung.

Wert

alternate

Gibt eine alternative Darstellung des aktuellen Dokuments an. Gültig für <link>, <a> und <area>, hängt die Bedeutung von den Werten der anderen Attribute ab.

  • Mit dem stylesheet-Schlüsselwort auf einem <link> wird ein alternatives Stylesheet erstellt.

    html
    <!-- a persistent style sheet -->
    <link rel="stylesheet" href="default.css" />
    <!-- alternate style sheets -->
    <link
      rel="alternate stylesheet"
      href="highcontrast.css"
      title="High contrast" />
    
  • Mit einem hreflang-Attribut, das sich von der Sprache des Dokuments unterscheidet, wird eine Übersetzung angegeben.

  • Mit dem type-Attributswert "application/rss+xml" oder "application/atom+xml" wird ein Hyperlink zu einem Syndikations-Feed erstellt.

    html
    <link
      rel="alternate"
      type="application/atom+xml"
      href="posts.xml"
      title="Blog" />
    
  • Andernfalls wird ein Hyperlink erstellt, der auf eine alternative Darstellung des aktuellen Dokuments verweist, dessen Natur durch die hreflang und type-Attribute gegeben ist.

    • Wenn hreflang zusammen mit alternate angegeben wird und der Wert von hreflang sich von der Sprache des aktuellen Dokuments unterscheidet, zeigt dies an, dass das referenzierte Dokument eine Übersetzung ist.
    • Wenn type zusammen mit alternate angegeben wird, zeigt es an, dass das referenzierte Dokument ein alternatives Format darstellt (wie etwa ein PDF).
    • Die hreflang- und type-Attribute können beide zusammen mit alternate angegeben werden.
    html
    <link
      rel="alternate"
      href="/fr/html/print"
      hreflang="fr"
      type="text/html"
      media="print"
      title="French HTML (for printing)" />
    <link
      rel="alternate"
      href="/fr/pdf"
      hreflang="fr"
      type="application/pdf"
      title="French PDF" />
    
author

Indiziert, dass das referenzierte Dokument weitere Informationen über den Autor des aktuellen Dokuments oder Artikels liefert. Relevant für <link>, <a> und <area> Elemente.

Mit <a> und <area> gibt es an, dass das verlinkte Dokument (oder mailto:) Informationen über den Autor des nächsten <article>-Vorfahren liefert, falls vorhanden, andernfalls für das gesamte Dokument.

Mit <link> repräsentiert es den Autor des gesamten Dokuments.

Hinweis: Aus historischen Gründen wird der veraltete Attributwert rev="made" als rel="author" behandelt.

bookmark

Relevant als rel-Attributwert für die <a> und <area> Elemente. Gibt einen Permalink für das nächstgelegene Vorfahren-<article>-Element, falls vorhanden, an. Wenn es kein Vorfahren-<article>-Element gibt, wird ein Permalink für den Abschnitt angegeben, dem das verlinkende Element am nächsten zugeordnet ist.

canonical

Gültig für <link>, es definiert die bevorzugte URL für das aktuelle Dokument, was Suchmaschinen dabei hilft, doppelte Inhalte zu reduzieren.

compression-dictionary

Gültig für <link>, es definiert ein Kompressionswörterbuch, das verwendet werden kann, um zukünftige Downloads für Ressourcen auf dieser Seite zu komprimieren, sodass die Download-Größen dieser Ressourcen kleiner als die Standardkompression sind.

dns-prefetch

Relevant für das <link>-Element sowohl im <body> als auch im <head>, teilt es dem Browser mit, die DNS-Auflösung für den Ursprung der Zielressource vorauseilend durchzuführen. Nützlich für Ressourcen, die der Benutzer wahrscheinlich benötigt, hilft es, die Latenz zu reduzieren und dadurch die Leistung zu verbessern, wenn der Benutzer auf die Ressourcen zugreift, da der Browser die DNS-Auflösung für den Ursprung der angegebenen Ressource vorauseilend durchgeführt hat. Siehe dns-prefetch beschrieben in Resource Hints.

external

Relevant für <form>, <a> und <area>, es deutet darauf hin, dass das referenzierte Dokument nicht Teil der aktuellen Seite ist. Dies kann mit Attributselektoren verwendet werden, um externe Links auf eine Weise zu stylen, die dem Benutzer signalisiert, dass er die aktuelle Seite verlässt.

expect

Erlaubt es der Seite, render-blocked zu sein, bis die wesentlichen Teile des Dokuments geparst sind, sodass es konsistent gerendert wird. Beachten Sie, dass Render-Blocking nur in Verbindung mit dem blocking="render"-Attribut auftritt.

Hinweis: Siehe Stabilizing page state to make cross-document transitions consistent für weitere Informationen zu seiner Verwendung.

help

Relevant für <form>, <link>, <a> und <area>, das help-Schlüsselwort gibt an, dass die verlinkten Inhalte kontextabhängige Hilfe bieten, Informationen für das übergeordnete Element des Elements, das den Hyperlink definiert, und seine Unterelemente bereithalten. Wenn es in <link> verwendet wird, bezieht sich die Hilfe auf das gesamte Dokument. Wenn es mit <a> und <area> verwendet wird und unterstützt wird, ist die Standard-cursor help anstelle von pointer.

icon

Gültig mit <link>, die verlinkte Ressource repräsentiert das Icon, eine Ressource zur Darstellung der Seite in der Benutzeroberfläche, für das aktuelle Dokument.

Die häufigste Verwendung für den icon-Wert ist das Favicon:

html
<link rel="icon" href="favicon.ico" />

Wenn es mehrere <link rel="icon"> gibt, verwendet der Browser deren media, type und sizes-Attribute, um das am besten geeignete Icon auszuwählen. Wenn mehrere Icons gleichermaßen geeignet sind, wird das letzte verwendet. Wenn das am besten geeignete Icon später als ungeeignet erkannt wird, zum Beispiel weil es ein nicht unterstütztes Format verwendet, fährt der Browser mit dem nächstbesten fort und so weiter.

Hinweis: Das crossorigin-Attribut wird für rel="icon" in Chromium-basierten Browsern nicht unterstützt. Siehe die offene Chromium-Issue.

Hinweis: Apples iOS verwendet diesen Linktyp nicht, noch das sizes-Attribut, wie andere mobile Browser dies tun, um ein Webseiten-Icon für Web Clip oder einen Startbildschirm-Platzhalter auszuwählen. Stattdessen verwendet es den nicht-standardisierten apple-touch-icon und apple-touch-startup-image jeweils.

Hinweis: Der shortcut-Link-Typ wird häufig vor icon gesehen, aber dieser Link-Typ ist nicht konform, wird ignoriert und Webautoren dürfen ihn nicht mehr verwenden.

license

Gültig auf den <a>, <area>, <form>, <link>-Elementen, gibt der license-Wert an, dass der Hyperlink zu einem Dokument führt, das die Lizenzinformationen beschreibt; dass der Hauptinhalt des aktuellen Dokuments durch die Urheberrechtslizenz abgedeckt ist, die im referenzierten Dokument beschrieben wird. Wenn nicht innerhalb des <head>-Elements, unterscheidet der Standard nicht zwischen einem Hyperlink, der für einen bestimmten Teil des Dokuments oder das Dokument als Ganzes gilt. Nur die Daten auf der Seite können dies anzeigen.

html
<link rel="license" href="#license" />

Hinweis: Obwohl erkannt, ist das Synonym copyright falsch und muss vermieden werden.

manifest

Web-App-Manifest. Erfordert die Verwendung des CORS-Protokolls für das Abrufen von externen Quellen.

modulepreload

Nützlich für verbesserte Leistung und relevant für das <link> überall im Dokument, das Setzen von rel="modulepreload" Teilt dem Browser mit, das Skript (und Abhängigkeiten) vorauseilend zu holen und es im Modul-Map-Cache des Dokuments für eine spätere Bewertung zu speichern. modulepreload-Links können sicherstellen, dass die Netzwerkabrufung mit dem Modul bereit (aber nicht bewertet) im Modul-Map-Cache erfolgt, bevor es notwendig ist. Siehe auch modulepreload.

next

Relevant für <form>, <link>, <a> und <area>, gibt der next-Wert an, dass das aktuelle Dokument Teil einer Serie ist und das nächste Dokument in der Serie das referenzierte Dokument ist. Wenn es in einem <link> enthalten ist, können Browser annehmen, dass dieses Dokument als nächstes abgerufen wird und es als Resource-Hint behandeln.

nofollow

Relevant für <form>, <a> und <area>, das nofollow-Schlüsselwort teilt Suchmaschinenspider mit, die Beziehungslinks zu ignorieren. Die nofollow-Beziehung kann anzeigen, dass der Eigentümer des aktuellen Dokuments das referenzierte Dokument nicht unterstützt. Es wird oft von Suchmaschinenoptimierern einbezogen, indem sie ihre Linkfarmen nicht als Spamseiten bezeichnen.

noopener

Relevant für <form>, <a> und <area>, erstellt einen obersten Browsing-Kontext, der kein Hilfsbrowsing-Kontext ist, wenn der Hyperlink einen der beiden erstellen würde, um zu beginnen (d.h. hat einen entsprechenden target-Attributswert). Mit anderen Worten, es lässt den Link so funktionieren, als ob window.opener null wäre und target="_parent" gesetzt wäre.

Dies ist das Gegenteil von opener.

noreferrer

Relevant für <form>, <a> und <area>, das Einschließen dieses Wertes macht den Referrer unbekannt (kein Referer-Header wird enthalten), und erstellt einen obersten Browsing-Kontext, als ob auch noopener gesetzt wäre.

opener

Erstellt einen Hilfsbrowsing-Kontext, wenn der Hyperlink andernfalls einen obersten Browsing-Kontext erstellen würde, der kein Hilfsbrowsing-Kontext ist (d.h. hat "_blank" als target-Attributwert). Im Grunde das Gegenteil von noopener.

pingback

Gibt die Adresse des Pingback-Servers an, der Pingbacks zu dem aktuellen Dokument bearbeitet. Siehe die Pingback-Spezifikation.

preconnect

Bietet dem Browser einen Hinweis darauf, dass er im Voraus eine Verbindung zur verlinkten Website herstellen soll, ohne private Informationen weiterzugeben oder Inhalte herunterzuladen, sodass bei der Verfolgung des Links die verlinkten Inhalte schneller abgerufen werden können.

prefetch

Gibt an, dass der Benutzeragent die Zielressource vorauseilend abrufen und im Cache speichern soll, da sie wahrscheinlich für eine Folgenavigation erforderlich ist. Siehe prefetch für weitere Informationen.

preload

Gibt an, dass der Benutzeragent vorauseilend die Zielressource für die aktuelle Navigation gemäß dem potenziellen Ziel, das durch das as-Attribut (und die damit verbundene Priorität) gegeben ist, abrufen und im Cache speichern muss. Siehe die Seite für den preload-Wert.

prerender

Gibt an, dass der Benutzeragent die Zielressource vorauseilend abrufen und sie in einer Weise verarbeiten soll, die in der Zukunft eine schnellere Antwort liefert, zum Beispiel durch Abrufen seiner Unterressourcen oder durch Ausführen einiger Rendering. Diese Funktion wird durch die Speculation Rules API abgelöst.

prev

Ähnlich wie das next-Schlüsselwort, relevant für <form>, <link>, <a> und <area>, gibt der prev-Wert an, dass das aktuelle Dokument Teil einer Serie ist und dass der Link ein vorheriges Dokument in der Serie referenziert.

Hinweis: Das Synonym previous ist falsch und sollte nicht verwendet werden.

privacy-policy

Gültig für die <a>, <area> und <link> Elemente, gibt der privacy-policy-Wert an, dass das referenzierte Dokument die Datenschutzerklärung ist, die die Datenbestimmungs- und Nutzungspraktiken des aktuellen Dokuments beschreibt.

Relevant für <form>, <link>, <a> und <area> Elemente, gibt die search-Schlüsselwörter an, dass der Hyperlink ein Dokument referenziert, dessen Schnittstelle speziell für die Suche im aktuellen Dokument, auf der Seite und in verwandten Ressourcen konzipiert ist und einen Link zu einer Ressource bereitstellt, die für die Suche verwendet werden kann.

Wenn das type-Attribut auf application/opensearchdescription+xml gesetzt ist, ist die Ressource ein OpenSearch-Plugin, das leicht zur Oberfläche von Firefox hinzugefügt werden kann.

stylesheet

Gültig für das <link>-Element, es importiert eine externe Ressource, die als Stylesheet verwendet werden soll. Das type-Attribut ist nicht erforderlich, wenn es sich um ein text/css-Stylesheet handelt, da dies der Standardwert ist. Wenn es sich nicht um ein Stylesheet vom Typ text/css handelt, ist es am besten, den Typ anzugeben.

Während dieses Attribut den Link als Stylesheet definiert, wirkt sich die Interaktion mit anderen Attributen und anderen Schlüsselbegriffen innerhalb des rel-Werts darauf aus, ob das Stylesheet heruntergeladen und/oder verwendet wird.

Wenn es mit dem alternate-Schlüsselwort verwendet wird, definiert es ein alternatives Stylesheet. In diesem Fall fügen Sie ein nicht-leeres title hinzu.

Das externe Stylesheet wird nicht verwendet oder sogar nicht heruntergeladen, wenn die Medien nicht dem Wert des media-Attributs entsprechen.

Erfordert die Verwendung des CORS-Protokolls für das Abrufen von externen Quellen.

tag

Gültig für die <a> und <area> Elemente, es gibt ein Tag (identifiziert durch die angegebene Adresse) an, das auf das aktuelle Dokument zutrifft. Der Tag-Wert gibt an, dass der Link auf ein Dokument verweist, das ein auf das Dokument, in dem es sich befindet, zutreffendes Tag beschreibt. Dieser Linktyp ist nicht für Tags innerhalb einer Tag-Cloud gedacht, da diese Tags auf eine Gruppe von Seiten anwendbar sind, während der tag-Wert des rel-Attributs für ein einzelnes Dokument gilt.

terms-of-service

Gültig für <a>, <area> und <link> Elemente, der terms-of-service-Wert gibt an, dass das referenzierte Dokument die Nutzungsbedingungen beschreibt, die die Vereinbarungen zwischen dem Anbieter des aktuellen Dokuments und den Nutzern beschreiben, die das bereitgestellte Dokument verwenden möchten.

Nicht-standardisierte Werte

apple-touch-icon

Bestimmt das Icon für eine Webanwendung auf einem iOS-Gerät.

Spezifikationen

Spezifikation
HTML
# linkTypes
HTML
# attr-hyperlink-rel
HTML
# attr-form-rel

Browser-Kompatibilität

html.elements.link.rel

html.elements.a.rel

html.elements.area.rel

html.elements.form.rel

Siehe auch