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
hreflangundtype-Attribute gegeben ist.- Wenn
hreflangzusammen mitalternateangegeben wird und der Wert vonhreflangsich von der Sprache des aktuellen Dokuments unterscheidet, zeigt dies an, dass das referenzierte Dokument eine Übersetzung ist. - Wenn
typezusammen mitalternateangegeben wird, zeigt es an, dass das referenzierte Dokument ein alternatives Format darstellt (wie etwa ein PDF). - Die
hreflang- undtype-Attribute kö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
-
-
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 (odermailto:) 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"alsrel="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>, dashelp-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-cursorhelpanstelle vonpointer. 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 derenmedia,typeundsizes-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ürrel="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-standardisiertenapple-touch-iconundapple-touch-startup-imagejeweils.Hinweis: Der
shortcut-Link-Typ wird häufig voricongesehen, 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 derlicense-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
copyrightfalsch 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 vonrel="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 auchmodulepreload. next-
Relevant für
<form>,<link>,<a>und<area>, gibt dernext-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>, dasnofollow-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 entsprechendentarget-Attributswert). Mit anderen Worten, es lässt den Link so funktionieren, als obwindow.openernull wäre undtarget="_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 (keinReferer-Header wird enthalten), und erstellt einen obersten Browsing-Kontext, als ob auchnoopenergesetzt 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"alstarget-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 denpreload-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 derprev-Wert an, dass das aktuelle Dokument Teil einer Serie ist und dass der Link ein vorheriges Dokument in der Serie referenziert.Hinweis: Das Synonym
previousist falsch und sollte nicht verwendet werden. privacy-policy-
Gültig für die
<a>,<area>und<link>Elemente, gibt derprivacy-policy-Wert an, dass das referenzierte Dokument die Datenschutzerklärung ist, die die Datenbestimmungs- und Nutzungspraktiken des aktuellen Dokuments beschreibt. search-
Relevant für
<form>,<link>,<a>und<area>Elemente, gibt diesearch-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 aufapplication/opensearchdescription+xmlgesetzt 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. Dastype-Attribut ist nicht erforderlich, wenn es sich um eintext/css-Stylesheet handelt, da dies der Standardwert ist. Wenn es sich nicht um ein Stylesheet vom Typtext/csshandelt, 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-leerestitlehinzu.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 dertag-Wert desrel-Attributs für ein einzelnes Dokument gilt. terms-of-service-
Gültig für
<a>,<area>und<link>Elemente, derterms-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> |