HTML-Attribut rel
Das Attribut rel definiert die Beziehung zwischen einer verlinkten Ressource und dem aktuellen Dokument. Es ist für <link>, <a>, <area> und <form> gültig. Welche Werte unterstützt werden, hängt vom jeweiligen Element ab.
Die Art der Beziehung wird durch den Wert des Attributs rel angegeben. Ist das Attribut vorhanden, muss sein Wert aus einer ungeordneten Menge eindeutiger, durch Leerzeichen getrennter Schlüsselwörter bestehen. Anders als ein class-Name, der keine Semantik ausdrückt, muss das Attribut rel Schlüsselwörter enthalten, die sowohl für Maschinen als auch für Menschen semantisch sinnvoll sind. Die aktuellen Verzeichnisse möglicher Werte für das Attribut rel sind das IANA-Verzeichnis für Linkbeziehungen, der HTML Living Standard und die frei bearbeitbare Seite existing-rel-values im microformats-Wiki, wie im Living Standard vorgeschlagen. Wird ein rel-Wert verwendet, der in keiner dieser drei Quellen aufgeführt ist, geben manche HTML-Validatoren, etwa der W3C Markup Validation Service, eine Warnung aus.
Die folgende Tabelle enthält einige der wichtigsten vorhandenen Schlüsselwörter. Jedes Schlüsselwort sollte innerhalb eines durch Leerzeichen getrennten Werts nur einmal vorkommen.
rel-Wert |
Beschreibung | <link> |
<a> und <area> |
<form> |
|---|---|---|---|---|
alternate |
Alternative Darstellungen des aktuellen Dokuments. | Link | Link | Nicht zulässig |
author |
Autor des aktuellen Dokuments oder Artikels. | Link | Link | Nicht zulässig |
bookmark |
Permanenter Link zum nächstgelegenen übergeordneten Abschnitt. | Nicht zulässig | Link | Nicht zulässig |
canonical |
Bevorzugte URL für das aktuelle Dokument. | Link | Nicht zulässig | Nicht zulässig |
compression-dictionary |
Link zu einem Komprimierungswörterbuch, mit dem künftige Downloads von Ressourcen dieser Website komprimiert werden können. | Link | Nicht zulässig | Nicht zulässig |
dns-prefetch |
Weist den Browser an, die DNS-Auflösung für den Ursprung der Zielressource vorzeitig durchzuführen. | Externe Ressource | Nicht zulässig | Nicht zulässig |
external |
Das referenzierte Dokument gehört nicht zu derselben Website wie das aktuelle Dokument. | Nicht zulässig | Annotation | Annotation |
expect |
Ermöglicht zusammen mit blocking="render", das Rendering der Seite zu blockieren, bis die wesentlichen Teile des Dokuments geparst wurden, damit die Darstellung konsistent ist. |
Link | Nicht zulässig | Nicht zulässig |
help |
Link zu kontextbezogener Hilfe. | Link | Link | Link |
icon |
Ein Symbol, das das aktuelle Dokument repräsentiert. | Externe Ressource | Nicht zulässig | Nicht zulässig |
license |
Gibt an, dass der Hauptinhalt des aktuellen Dokuments unter der im referenzierten Dokument beschriebenen urheberrechtlichen Lizenz steht. | Link | Link | Link |
manifest |
Web-App-Manifest. | Link | Nicht zulässig | Nicht zulässig |
me |
Gibt an, dass das aktuelle Dokument die Person repräsentiert, der der verlinkte Inhalt gehört. | Link | Link | Nicht zulässig |
modulepreload |
Weist den Browser an, das Skript vorzeitig abzurufen und zur späteren Auswertung in der Modulzuordnung des Dokuments zu speichern. Optional können auch die Abhängigkeiten des Moduls abgerufen werden. | Externe Ressource | Nicht zulässig | Nicht zulässig |
next |
Gibt an, dass das aktuelle Dokument Teil einer Reihe ist und das referenzierte Dokument das nächste Dokument dieser Reihe ist. | Link | Link | Link |
nofollow |
Gibt an, dass der ursprüngliche Autor oder Herausgeber des aktuellen Dokuments das referenzierte Dokument nicht unterstützt. | Nicht zulässig | Annotation | Annotation |
noopener |
Erstellt einen Browsing-Kontext auf oberster Ebene, der kein zusätzlicher Browsing-Kontext ist, sofern der Hyperlink andernfalls einen dieser Kontexte erstellen würde (d.h. einen geeigneten Wert für das Attribut target hat). |
Nicht zulässig | Annotation | Annotation |
noreferrer |
Es wird kein Referer-Header gesendet. Hat außerdem dieselbe Wirkung wie noopener. |
Nicht zulässig | Annotation | Annotation |
opener |
Erstellt einen zusätzlichen Browsing-Kontext, wenn der Hyperlink andernfalls einen Browsing-Kontext auf oberster Ebene erstellen würde, der kein zusätzlicher Browsing-Kontext ist (d.h. wenn das Attribut target den Wert "_blank" hat). |
Nicht zulässig | Annotation | Annotation |
pingback |
Gibt die Adresse des Pingback-Servers an, der Pingbacks für das aktuelle Dokument verarbeitet. | Externe Ressource | Nicht zulässig | Nicht zulässig |
preconnect |
Gibt an, dass der User Agent vorzeitig eine Verbindung zum Ursprung der Zielressource herstellen sollte. | Externe Ressource | Nicht zulässig | Nicht zulässig |
prefetch |
Gibt an, dass der User Agent die Zielressource vorzeitig abrufen und zwischenspeichern sollte, da sie wahrscheinlich für eine anschließende Navigation benötigt wird. | Externe Ressource | Nicht zulässig | Nicht zulässig |
preload |
Gibt an, dass der User Agent die Zielressource für die aktuelle Navigation vorzeitig abrufen und zwischenspeichern muss, entsprechend dem durch das Attribut as angegebenen möglichen Zieltyp und dessen Priorität. |
Externe Ressource | Nicht zulässig | Nicht zulässig |
prerender |
Gibt an, dass der User Agent die Zielressource vorzeitig abrufen und so verarbeiten sollte, dass sie künftig schneller bereitgestellt werden kann. Diese Funktion wurde durch die Speculation Rules API abgelöst. | Externe Ressource | Nicht zulässig | Nicht zulässig |
prev |
Gibt an, dass das aktuelle Dokument Teil einer Reihe ist und das referenzierte Dokument das vorherige Dokument dieser Reihe ist. | Link | Link | Link |
privacy-policy |
Verlinkt Informationen über die für das aktuelle Dokument geltenden Praktiken zur Datenerhebung und -nutzung. | Link | Link | Nicht zulässig |
search |
Verlinkt eine Ressource, mit der das aktuelle Dokument und zugehörige Seiten durchsucht werden können. | Link | Link | Link |
stylesheet |
Importiert ein Stylesheet. | Externe Ressource | Nicht zulässig | Nicht zulässig |
tag |
Gibt ein Tag an, das durch die angegebene Adresse identifiziert wird und für das aktuelle Dokument gilt. | Nicht zulässig | Link | Nicht zulässig |
terms-of-service |
Link zur Vereinbarung beziehungsweise zu den Nutzungsbedingungen zwischen dem Anbieter des Dokuments und den Nutzern, die es verwenden möchten. | Link | Link | Nicht zulässig |
Das Attribut rel ist für die Elemente <link>, <a>, <area> und <form> relevant. Einige Werte gelten jedoch nur für einen Teil dieser Elemente. Wie bei allen HTML-Attributwerten, die Schlüsselwörter sind, wird bei diesen Werten nicht zwischen Groß- und Kleinschreibung unterschieden.
Das Attribut rel hat keinen Standardwert. Wird es weggelassen oder wird keiner seiner Werte unterstützt, besteht zwischen dem Dokument und der Zielressource keine bestimmte Beziehung – abgesehen von einem Hyperlink zwischen beiden. Bei <link> und <form> erstellt das Element in diesem Fall keinen Link, wenn das Attribut rel fehlt, keine Schlüsselwörter enthält oder keines seiner durch Leerzeichen getrennten Schlüsselwörter unterstützt wird. <a> und <area> erstellen weiterhin Links, allerdings ohne definierte Beziehung.
Wert
alternate-
Kennzeichnet eine alternative Darstellung des aktuellen Dokuments. Der Wert ist für
<link>,<a>und<area>gültig; seine Bedeutung hängt von den Werten der anderen Attribute ab.-
Zusammen mit dem Schlüsselwort
stylesheetauf 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" /> -
Zusammen mit einem Attribut
hreflang, dessen Wert von der Sprache des Dokuments abweicht, kennzeichnet es eine Übersetzung. -
Zusammen mit dem Wert
"application/rss+xml"oder"application/atom+xml"für das Attributtypewird ein Hyperlink zu einem Syndication-Feed erstellt.html<link rel="alternate" type="application/atom+xml" href="posts.xml" title="Blog" /> -
Andernfalls wird ein Hyperlink zu einer alternativen Darstellung des aktuellen Dokuments erstellt, deren Art durch die Attribute
hreflangundtypeangegeben wird.- Wenn
hreflangzusammen mitalternateangegeben wird und sein Wert von der Sprache des aktuellen Dokuments abweicht, ist das referenzierte Dokument eine Übersetzung. - Wenn
typezusammen mitalternateangegeben wird, liegt das referenzierte Dokument in einem alternativen Format vor, beispielsweise als PDF. - Die Attribute
hreflangundtypekönnen beide zusammen mitalternateangegeben 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" /> - Wenn
-
-
Gibt an, dass das referenzierte Dokument weitere Informationen über den Autor des aktuellen Dokuments oder Artikels enthält. Relevant für die Elemente
<link>,<a>und<area>.Bei
<a>und<area>gibt der Wert an, dass das verlinkte Dokument (odermailto:) Informationen über den Autor des nächstgelegenen übergeordneten<article>-Elements enthält, sofern ein solches vorhanden ist. Andernfalls beziehen sich die Informationen auf das gesamte Dokument.Bei
<link>bezieht sich der Wert auf den Autor des gesamten Dokuments.Hinweis: Aus historischen Gründen wird der veraltete Attributwert
rev="made"wierel="author"behandelt. bookmark-
Relevant als Wert des Attributs
relfür die Elemente<a>und<area>. Gibt einen permanenten Link zum nächstgelegenen übergeordneten<article>-Element an, sofern eines vorhanden ist. Gibt es kein übergeordnetes<article>-Element, verweist der permanente Link auf den Abschnitt, mit dem das verlinkende Element am engsten verbunden ist. canonical-
Gültig für
<link>. Definiert die bevorzugte URL für das aktuelle Dokument und hilft Suchmaschinen so, doppelte Inhalte zu reduzieren. compression-dictionary-
Gültig für
<link>. Definiert ein Komprimierungswörterbuch, mit dem künftige Downloads von Ressourcen dieser Website so komprimiert werden können, dass sie kleiner sind als bei einer Standardkomprimierung. dns-prefetch-
Relevant für das Element
<link>sowohl in<body>als auch in<head>. Weist den Browser an, die DNS-Auflösung für den Ursprung der Zielressource vorzeitig durchzuführen. Dies ist nützlich für Ressourcen, die Nutzer wahrscheinlich benötigen: Weil der Browser die DNS-Auflösung für den Ursprung der angegebenen Ressource bereits durchgeführt hat, verringert sich beim Zugriff auf die Ressource die Latenz und die Leistung verbessert sich. Siehe dns-prefetch in der Beschreibung der Resource Hints. external-
Relevant für
<form>,<a>und<area>. Gibt an, dass das referenzierte Dokument nicht zur aktuellen Website gehört. Mit Attributselektoren können externe Links so gestaltet werden, dass Nutzer erkennen, dass sie die aktuelle Website verlassen. expect-
Ermöglicht, das Rendering der Seite zu blockieren, bis die wesentlichen Teile des Dokuments geparst wurden, damit die Darstellung konsistent ist. Das Rendering wird allerdings nur blockiert, wenn zusätzlich das Attribut
blocking="render"angegeben ist.Hinweis: Weitere Informationen zur Verwendung finden Sie unter Seitenzustand stabilisieren, um dokumentübergreifende Übergänge konsistent zu gestalten.
help-
Relevant für
<form>,<link>,<a>und<area>. Das Schlüsselworthelpgibt an, dass der verlinkte Inhalt kontextbezogene Hilfe für das übergeordnete Element des Elements, das den Hyperlink definiert, sowie für dessen untergeordnete Elemente bereitstellt. Bei Verwendung in<link>bezieht sich die Hilfe auf das gesamte Dokument. Wird es bei<a>oder<area>angegeben und unterstützt, ist der Standardwert fürcursorhelpstattpointer. icon-
Gültig für
<link>. Die verlinkte Ressource ist das Symbol, mit dem das aktuelle Dokument in der Benutzeroberfläche dargestellt wird.Die häufigste Verwendung des Werts
iconist das Favicon:html<link rel="icon" href="favicon.ico" />Sind mehrere
<link rel="icon">-Elemente vorhanden, wählt der Browser anhand ihrer Attributemedia,typeundsizesdas am besten geeignete Symbol aus. Sind mehrere Symbole gleichermaßen geeignet, wird das letzte verwendet. Stellt sich später heraus, dass das am besten geeignete Symbol doch ungeeignet ist, etwa weil es ein nicht unterstütztes Format verwendet, prüft der Browser das nächstgeeignete Symbol und so weiter.Hinweis: Das Attribut
crossoriginwird fürrel="icon"in Chromium-basierten Browsern nicht unterstützt. Siehe den offenen Chromium-Fehlerbericht.Hinweis: Anders als andere mobile Browser verwendet Apples iOS weder diesen Linktyp noch das Attribut
sizes, um ein Webseitensymbol für einen Web Clip oder einen Platzhalter beim Start auszuwählen. Stattdessen verwendet es die nicht standardisierten Werteapple-touch-iconbeziehungsweiseapple-touch-startup-image.Hinweis: Der Linktyp
shortcutsteht häufig voricon. Er entspricht jedoch nicht dem Standard, wird ignoriert und darf von Webentwicklern nicht mehr verwendet werden. license-
Gültig für die Elemente
<a>,<area>,<form>und<link>. Der Wertlicensegibt an, dass der Hyperlink zu einem Dokument mit Lizenzinformationen führt: Der Hauptinhalt des aktuellen Dokuments steht unter der im referenzierten Dokument beschriebenen urheberrechtlichen Lizenz. Befindet sich der Link nicht innerhalb des Elements<head>, unterscheidet der Standard nicht, ob er für einen bestimmten Teil des Dokuments oder für das gesamte Dokument gilt. Das lässt sich nur anhand der Daten auf der Seite feststellen.html<link rel="license" href="#license" />Hinweis: Das Synonym
copyrightwird zwar erkannt, ist aber falsch und sollte vermieden werden. manifest-
Web-App-Manifest. Für das Abrufen über Ursprungsgrenzen hinweg muss das CORS-Protokoll verwendet werden.
modulepreload-
Nützlich zur Leistungsverbesserung und für
<link>an jeder Stelle im Dokument relevant. Mitrel="modulepreload"wird der Browser angewiesen, das Skript und seine Abhängigkeiten vorzeitig abzurufen und zur späteren Auswertung in der Modulzuordnung des Dokuments zu speichern.modulepreload-Links können sicherstellen, dass das Modul bereits über das Netzwerk abgerufen wurde und unausgewertet in der Modulzuordnung bereitsteht, bevor es benötigt wird. Siehe auchmodulepreload. next-
Relevant für
<form>,<link>,<a>und<area>. Der Wertnextgibt an, dass das aktuelle Dokument Teil einer Reihe ist und das referenzierte Dokument als Nächstes folgt. In einem<link>können Browser annehmen, dass dieses Dokument als Nächstes abgerufen wird, und den Link als Resource Hint behandeln. nofollow-
Relevant für
<form>,<a>und<area>. Das Schlüsselwortnofollowweist Suchmaschinen-Crawler an, die Linkbeziehung zu ignorieren. Die Beziehung kann darauf hinweisen, dass der Eigentümer des aktuellen Dokuments das referenzierte Dokument nicht unterstützt. Sie wird häufig von Suchmaschinenoptimierern verwendet, die ihre Linkfarmen als Nicht-Spam-Seiten ausgeben möchten. noopener-
Relevant für
<form>,<a>und<area>. Erstellt einen Browsing-Kontext auf oberster Ebene, der kein zusätzlicher Browsing-Kontext ist, sofern der Hyperlink andernfalls einen dieser Kontexte erstellen würde (d.h. einen geeigneten Wert für das Attributtargethat). Anders ausgedrückt verhält sich der Link so, als wärewindow.openernull undtarget="_parent"gesetzt.Dies ist das Gegenteil von
opener. noreferrer-
Relevant für
<form>,<a>und<area>. Dieser Wert verhindert die Übermittlung des Referrers (es wird keinReferer-Header gesendet) und erstellt einen Browsing-Kontext auf oberster Ebene, als wäre auchnoopenergesetzt. opener-
Erstellt einen zusätzlichen Browsing-Kontext, wenn der Hyperlink andernfalls einen Browsing-Kontext auf oberster Ebene erstellen würde, der kein zusätzlicher Browsing-Kontext ist (d.h. wenn das Attribut
targetden Wert"_blank"hat). Dies ist praktisch das Gegenteil von noopener. pingback-
Gibt die Adresse des Pingback-Servers an, der Pingbacks für das aktuelle Dokument verarbeitet. Siehe die Pingback-Spezifikation.
preconnect-
Gibt dem Browser einen Hinweis, vorab eine Verbindung zur verlinkten Website herzustellen, ohne private Informationen preiszugeben oder Inhalte herunterzuladen. Wird dem Link später gefolgt, können die verlinkten Inhalte dadurch schneller abgerufen werden.
prefetch-
Gibt an, dass der User Agent die Zielressource vorzeitig abrufen und zwischenspeichern sollte, da sie wahrscheinlich für eine anschließende Navigation benötigt wird. Weitere Informationen finden Sie unter prefetch.
preload-
Gibt an, dass der User Agent die Zielressource für die aktuelle Navigation vorzeitig abrufen und zwischenspeichern muss, entsprechend dem durch das Attribut
asangegebenen möglichen Zieltyp und dessen Priorität. Siehe die Seite zum Wertpreload. prerender-
Gibt an, dass der User Agent die Zielressource vorzeitig abrufen und so verarbeiten sollte, dass sie künftig schneller bereitgestellt werden kann, beispielsweise indem er ihre Unterressourcen abruft oder Teile des Renderings ausführt. Diese Funktion wurde durch die Speculation Rules API abgelöst.
prev-
Ähnlich wie das Schlüsselwort
nextistprevfür<form>,<link>,<a>und<area>relevant. Der Wert gibt an, dass das aktuelle Dokument Teil einer Reihe ist und der Link auf ein vorheriges Dokument dieser Reihe verweist.Hinweis: Das Synonym
previousist falsch und sollte nicht verwendet werden. privacy-policy-
Gültig für die Elemente
<a>,<area>und<link>. Der Wertprivacy-policygibt an, dass das referenzierte Dokument die Datenschutzerklärung ist, die die Praktiken zur Datenerhebung und -nutzung für das aktuelle Dokument beschreibt. search-
Relevant für die Elemente
<form>,<link>,<a>und<area>. Das Schlüsselwortsearchgibt an, dass der Hyperlink auf eine Ressource mit einer speziell für die Suche im aktuellen Dokument, auf der Website und in verwandten Ressourcen entwickelten Oberfläche verweist.Ist das Attribut
typeaufapplication/opensearchdescription+xmlgesetzt, handelt es sich bei der Ressource um ein OpenSearch-Plugin, das sich einfach zur Firefox-Oberfläche hinzufügen lässt. stylesheet-
Gültig für das Element
<link>. Importiert eine externe Ressource, die als Stylesheet verwendet wird. Bei einem Stylesheet vom Typtext/cssist das Attributtypenicht erforderlich, da dies der Standardwert ist. Bei einem anderen Typ sollte der Typ angegeben werden.Dieses Attribut kennzeichnet den Link zwar als Stylesheet, doch das Zusammenspiel mit anderen Attributen und Schlüsselwörtern im
rel-Wert bestimmt, ob das Stylesheet heruntergeladen und/oder verwendet wird.Zusammen mit dem Schlüsselwort
alternatedefiniert es ein alternatives Stylesheet. Geben Sie in diesem Fall ein nicht leeres Attributtitlean.Das externe Stylesheet wird weder verwendet noch heruntergeladen, wenn das Medium nicht zum Wert des Attributs
mediapasst.Für das Abrufen über Ursprungsgrenzen hinweg muss das CORS-Protokoll verwendet werden.
tag-
Gültig für die Elemente
<a>und<area>. Gibt ein Tag an, das durch die angegebene Adresse identifiziert wird und für das aktuelle Dokument gilt. Der Werttagbedeutet, dass der Link auf ein Dokument verweist, das ein für das aktuelle Dokument geltendes Tag beschreibt. Dieser Linktyp ist nicht für Tags innerhalb einer Tag-Cloud gedacht: Solche Tags gelten für eine Gruppe von Seiten, während sich der Werttagdes Attributsrelauf ein einzelnes Dokument bezieht. terms-of-service-
Gültig für die Elemente
<a>,<area>und<link>. Der Wertterms-of-servicegibt an, dass das referenzierte Dokument die Nutzungsbedingungen enthält, die die Vereinbarungen zwischen dem Anbieter des aktuellen Dokuments und den Nutzern beschreiben, die es verwenden möchten.
Nicht standardisierte Werte
apple-touch-icon-
Gibt das Symbol für eine Webanwendung auf einem iOS-Gerät an.
Spezifikationen
| Spezifikation |
|---|
| HTML> # linkTypes> |
| HTML> # attr-hyperlink-rel> |
| HTML> # attr-form-rel> |