HTML-Attribut: rel

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

Die Art der Beziehungen wird durch den Wert des rel Attributs angegeben, der, falls vorhanden, ein Wert sein muss, der aus einer ungeordneten Menge von einzigartigen, durch Leerzeichen getrennten Schlüsselwörtern besteht. Anders als ein class Name, der keine Semantik ausdrücken, muss das rel Attribut Token ausdrücken, die sowohl für Maschinen als auch Menschen semantisch gültig sind. Die aktuellen Register für die möglichen Werte des rel Attributs sind das IANA link relation registry, der HTML Living Standard und die frei bearbeitbare existing-rel-values page im Microformats-Wiki, wie vorgeschlagen vom Living Standard. Wenn ein rel Attribut verwendet wird, das in einer der drei oben genannten Quellen nicht vorhanden ist, erzeugen einige HTML-Validatoren (wie der W3C Markup Validation Service) eine Warnung.

Die folgende Tabelle listet einige der wichtigsten existierenden Schlüsselwörter auf. Jedes Schlüsselwort innerhalb eines durch Leerzeichen getrennten Wertes sollte einzigartig innerhalb dieses Wertes 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ächsten übergeordneten Abschnitt.	Nicht erlaubt	Link	Nicht erlaubt
`canonical`	Bevorzugte URL für das aktuelle Dokument.	Link	Nicht erlaubt	Nicht erlaubt
`compression-dictionary`	Link zu einem Komprimierungswörterbuch, das verwendet werden kann, um zukünftige Downloads für Ressourcen auf dieser Seite zu komprimieren.	Link	Nicht erlaubt	Nicht erlaubt
`dns-prefetch`	Teilt dem Browser mit, dass er DNS-Auflösungen für den Ursprung der Zielressource vorsorglich durchführen soll.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`external`	Das referenzierte Dokument gehört nicht zur selben Seite wie das aktuelle Dokument.	Nicht erlaubt	Anmerkung	Anmerkung
`expect`	Ermöglicht der Seite das Render-Blockierung bis die wesentlichen Teile des Dokuments analysiert wurden, so dass es konsistent gerendert wird.	Link	Nicht erlaubt	Nicht erlaubt
`help`	Link zu kontextsensitiver Hilfe.	Link	Link	Link
`icon`	Ein Symbol, das das aktuelle Dokument repräsentiert.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`license`	Gibt an, dass der Hauptinhalt des aktuellen Dokuments durch die Urheberrechtslizenz abgedeckt ist, die durch das referenzierte Dokument beschrieben wird.	Link	Link	Link
`manifest`	Web-App-Manifest.	Link	Nicht erlaubt	Nicht erlaubt
`me`	Gibt an, dass das aktuelle Dokument die Person repräsentiert, die den verlinkten Inhalt besitzt.	Link	Link	Nicht erlaubt
`modulepreload`	Teilt dem Browser mit, das Skript vorsorglich abzurufen und in der Modulkarte des Dokuments zu speichern, um es später auszuwerten. Optional können auch die Abhängigkeiten des Moduls abgerufen werden.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`next`	Gibt an, dass das aktuelle Dokument Teil einer Serie ist und das nächste Dokument in der Serie das referenzierte Dokument ist.	Link	Link	Link
`nofollow`	Gibt an, dass der ursprüngliche Autor oder Herausgeber des aktuellen Dokuments das referenzierte Dokument nicht unterstützt.	Nicht erlaubt	Anmerkung	Anmerkung
`noopener`	Erstellt einen obersten Browsing-Kontext, der kein zusätzlicher Browsing-Kontext ist, wenn der Hyperlink entweder von diesen erstellt würde (d.h. hat einen geeigneten `target`-Attributswert).	Nicht erlaubt	Anmerkung	Anmerkung
`noreferrer`	Kein `Referer`-Header wird eingeschlossen. Zusätzlich hat es die gleiche Wirkung wie `noopener`.	Nicht erlaubt	Anmerkung	Anmerkung
`opener`	Erstellt einen zusätzlichen Browsing-Kontext, wenn der Hyperlink ansonsten einen obersten Browsing-Kontext erstellt, der kein zusätzlicher Browsing-Kontext ist (d.h. hat `"_blank"` als `target`-Attributswert).	Nicht erlaubt	Anmerkung	Anmerkung
`pingback`	Gibt die Adresse des Pingback-Servers an, der Pingbacks zum aktuellen Dokument verarbeitet.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`preconnect`	Gibt an, dass der Benutzeragent vorsorglich eine Verbindung zum Ursprung der Zielressource herstellen sollte.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prefetch`	Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und zwischenspeichern sollte, da sie wahrscheinlich für eine nachfolgende Navigation benötigt wird.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`preload`	Gibt an, dass der Benutzeragent die Zielressource vorsorglich für die aktuelle Navigation abrufen und zwischenspeichern muss, gemäß dem potenziellen Ziel, das durch das `as`-Attribut angegeben wird (und der Priorität, die mit dem entsprechenden Ziel verbunden ist).	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prerender`	Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und auf eine Weise verarbeiten sollte, die dazu beiträgt, in der Zukunft eine schnellere Antwort zu liefern.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prev`	Gibt an, dass das aktuelle Dokument Teil einer Serie ist und das vorherige Dokument in der Serie das referenzierte Dokument ist.	Link	Link	Link
`privacy-policy`	Gibt einen Link zu Informationen über die Datensammlung und Nutzungspraktiken an, die für das aktuelle Dokument gelten.	Link	Link	Nicht erlaubt
`search`	Gibt einen Link zu einer Ressource an, die verwendet werden kann, um das aktuelle Dokument und seine verwandten Seiten zu durchsuchen.	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 angewendet wird.	Nicht erlaubt	Link	Nicht erlaubt
`terms-of-service`	Link zum Vertrag oder den Nutzungsbedingungen zwischen dem Anbieter des Dokuments und den Benutzern, die das Dokument verwenden möchten.	Link	Link	Nicht erlaubt

Das rel Attribut ist relevant für die <link>, <a>, <area>, und <form> Elemente, aber einige Werte sind nur für eine Teilmenge dieser Elemente von Bedeutung. Wie alle HTML-Schlüsselwortattributwerte sind diese Werte nicht case-sensitiv.

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

Werte

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> erstellt es ein alternatives Stylesheet.

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 Sprach des Dokuments unterscheidet, weist es auf eine Übersetzung hin.
Mit dem type Attributwert von "application/rss+xml" oder "application/atom+xml" wird ein Hyperlink erstellt, der auf einen Syndikationsfeed verweist.
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, deren Art durch die hreflang und type Attribute angegeben wird.
- Wenn hreflang zusammen mit alternate angegeben wird und der Wert von hreflang sich von der Sprache des aktuellen Dokuments unterscheidet, wird angezeigt, dass das referenzierte Dokument eine Übersetzung ist.
- Wenn type zusammen mit alternate angegeben wird, wird angezeigt, dass das referenzierte Dokument ein alternatives Format (z.B. ein PDF) ist.
- 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

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

Mit <a> und <area> zeigt es an, dass das verlinkte Dokument (oder mailto:) Informationen über den Autor des nächsten übergeordneten <article> Elements bietet, falls vorhanden, ansonsten 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ächstliegende übergeordnete <article> Element an, falls vorhanden. Wenn kein übergeordnetes <article> Element vorhanden ist, gibt es einen Permalink für den Abschnitt an, mit dem das verknüpfende Element am engsten in Verbindung steht.

canonical

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

compression-dictionary Experimentell

Gültig für <link>, definiert ein Komprimierungswörterbuch, das verwendet werden kann, um zukünftige Downloads für Ressourcen auf dieser Seite zu komprimieren, sodass die Downloadgrößen dieser Ressourcen kleiner sind als bei der Standardkomprimierung.

dns-prefetch

Relevant für das <link> Element sowohl im <body> als auch im <head>, teilt es dem Browser mit, dass er DNS-Auflösungen für den Ursprung der Zielressource vorsorglich durchführen soll. Nützlich für Ressourcen, die der Benutzer wahrscheinlich benötigt, trägt es dazu bei, die Latenz zu verringern und die Leistung zu verbessern, wenn der Benutzer die Ressourcen tatsächlich aufruft, da der Browser die DNS-Auflösung für den Ursprung der angegebenen Ressource vorsorglich durchgeführt hat. Siehe dns-prefetch, beschrieben in resource hints.

external

Relevant für <form>, <a> und <area>, es zeigt an, dass das referenzierte Dokument nicht Teil der aktuellen Seite ist. Dies kann mit Attributselektoren verwendet werden, um externe Links so zu stilisieren, dass sie den Benutzer darauf hinweisen, dass sie die aktuelle Seite verlassen werden.

expect Experimentell

Ermöglicht der Seite, bis die wesentlichen Teile des Dokuments analysiert wurden, render-blockiert zu bleiben, damit es konsistent gerendert wird. Beachten Sie, dass eine Render-Blockierung nur auftritt, wenn sie mit dem blocking="render" Attribut ergänzt wird.

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

help

Relevant für <form>, <link>, <a> und <area>, zeigt das Schlüsselwort help an, dass der verlinkte Inhalt kontextbezogene Hilfe bietet, indem er Informationen für das übergeordnete Element des Hyperlink-definierenden Elements und seine untergeordneten Elemente bereitstellt. Bei Verwendung in <link> ist die Hilfe für das gesamte Dokument. Bei Verwendung mit <a> und <area> und unterstützt, wird der Standard-cursor help anstelle von pointer sein.

icon

Gültig mit <link>, repräsentiert die verlinkte Ressource das Symbol, 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 ihre media, type und sizes Attribute, um das am besten geeignete Symbol auszuwählen. Wenn mehrere Symbole gleichermaßen geeignet sind, wird das letzte verwendet. Wenn festgestellt wird, dass das am besten geeignete Symbol später ungeeignet ist, beispielsweise weil es ein nicht unterstütztes Format verwendet, geht der Browser zum nächst geeigneteren über und so weiter.

Hinweis: Das crossorigin Attribut wird bei rel="icon" in auf Chromium basierenden Browsern nicht unterstützt. Siehe das offene Chromium-Problem.

Hinweis: Apples iOS verwendet diesen Linktyp nicht, noch das sizes Attribut, wie es mobile Browser tun, um ein Webseiten-Symbol für Web Clip oder ein Start-Up-Platzhalter auszuwählen. Stattdessen verwendet es das nicht-standardisierte apple-touch-icon und apple-touch-startup-image.

Hinweis: Der shortcut Linktyp wird oft vor icon gesehen, ist jedoch nicht normkonform, ignoriert und Web-Autoren dürfen ihn nicht mehr verwenden.

license

Gültig auf den <a>, <area>, <form>, <link> Elementen, weist der license Wert darauf hin, dass der Hyperlink zu einem Dokument führt, das die Lizenzinformationen beschreibt; dass der Hauptinhalt des aktuellen Dokuments von der Urheberrechtslizenz abgedeckt ist, die durch das referenzierte Dokument beschrieben wird. Wenn es sich nicht innerhalb des <head> Elements befindet, unterscheidet der Standard nicht zwischen einem Hyperlink, der sich auf einen bestimmten Teil des Dokuments bezieht, oder auf das Dokument als Ganzes. Nur die Daten auf der Seite können dies anzeigen.

html

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

Hinweis: Obwohl anerkannt, ist das Synonym copyright inkorrekt und muss vermieden werden.

manifest

Web-App-Manifest. Erfordert die Verwendung des CORS-Protokolls für das Abrufen von Ursprung-übergreifenden Inhalt.

modulepreload

Nützlich zur Leistungsverbesserung und relevant für <link> überall im Dokument, rel="modulepreload" besagt dem Browser, das Skript vorsorglich (mit Abhängigkeiten) abzurufen und es in der Modulkarte des Dokuments für eine spätere Bewertung zu speichern. modulepreload Links können gewährleisten, dass die Netzwerkabfrage mit dem Modul ausführbereit (aber nicht ausgewertet) in der Modulkarte liegt, bevor es notwendig ist. Siehe auch modulepreload.

next

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

nofollow

Relevant für <form>, <a> und <area>, teilt das nofollow Schlüsselwort den Suchmaschinenspinnen mit, die Link-Beziehung zu ignorieren. Die nofollow Beziehung kann darauf hindeuten, dass der Besitzer des aktuellen Dokuments das referenzierte Dokument nicht unterstützt. Es wird häufig von Suchmaschinenoptimierern verwendet, die vortäuschen, dass ihre Linkfarmen keine Spamseiten sind.

noopener

Relevant für <form>, <a> und <area>, erstellt einen obersten Browsing-Kontext, der nicht ein zusätzlicher Browsing-Kontext ist, wenn der Hyperlink entweder von diesen beiden erstellt würde (d.h. hat einen geeigneten target Attributswert). Mit anderen Worten, es lässt den Link verhalten, als wäre window.opener null und target="_parent" wäre gesetzt.

Dies ist das Gegenteil von opener.

noreferrer

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

opener

Erstellt einen zusätzlichen Browsing-Kontext, wenn der Hyperlink sonst einen obersten Browsing-Kontext erstellt, der kein zusätzlicher Browsing-Kontext ist (d.h. hat "_blank" als target Attributswert). Im Wesentlichen das Gegenteil von noopener.

pingback

Gibt die Adresse des Pingback-Servers an, der Pingbacks zum aktuellen Dokument verarbeitet. Siehe die Pingback-Spezifikation.

preconnect

Bietet dem Browser ein Signal, dass er in Voraus eine Verbindung zur verlinkten Webseite öffnen soll, ohne private Informationen preiszugeben oder Inhalte herunterzuladen, so dass, wenn der Link verfolgt wird, der verlinkte Inhalt schneller abgerufen werden kann.

prefetch

Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und zwischenspeichern soll, da sie wahrscheinlich für eine nachfolgende Navigation benötigt wird. Siehe prefetch für weitere Informationen.

preload

Gibt an, dass der Benutzeragent die Zielressource vorsorglich für die aktuelle Navigation abrufen und zwischenspeichern muss, gemäß dem potenziellen Ziel, das durch das as Attribut angegeben wird (und der Priorität, die mit dem entsprechenden Ziel verbunden ist). Siehe die Seite für den preload Wert.

prerender Veraltet Nicht standardisiert

Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und auf eine Weise verarbeiten sollte, die dazu beiträgt, in der Zukunft eine schnellere Antwort zu liefern, indem er zum Beispiel dessen Unterressourcen abruft oder eine erste Verarbeitung durchführt.

prev

Ähnlich dem next Schlüsselwort, relevant für <form>, <link>, <a> und <area>, zeigt prev an, dass das aktuelle Dokument Teil einer Serie ist, und dass der Link auf ein vorheriges Dokument in der Serie verweist.

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

privacy-policy

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

search

Relevant für <form>, <link>, <a> und <area> Elemente, zeigt der search Schlüsselwörter an, dass der Hyperlink auf ein Dokument verweist, dessen Benutzeroberfläche speziell für die Suche im aktuellen Dokument, auf der Seite und verwandten Ressourcen ausgelegt ist, und bietet einen Link zu einer Ressource, die dafür verwendet werden kann.

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

stylesheet

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

Obwohl dieses Attribut den Link als ein Stylesheet definiert, beeinflussen die Interaktion mit anderen Attributen und anderen Schlüsselbegriffen innerhalb des rel Wertes, ob das Stylesheet heruntergeladen und/oder verwendet wird.

Bei Verwendung mit dem alternate Schlüsselwort, definiert es ein alternatives Stylesheet. In diesem Fall sollte ein nicht-leerer title eingeschlossen werden.

Das externe Stylesheet wird nicht verwendet oder sogar heruntergeladen, wenn das Medienattribut nicht mit dem Wert des media Attributs übereinstimmt.

Erfordert die Verwendung des CORS-Protokolls für das Abrufen von Ursprung-übergreifendem Inhalt.

tag

Gültig für die <a> und <area> Elemente, gibt es ein Tag an (identifiziert durch die angegebene Adresse), das auf das aktuelle Dokument angewendet wird. Der Tag-Wert zeigt an, dass sich der Link auf ein Dokument bezieht, das ein auf das Dokument angewendetes Tag beschreibt. Dieser Linktyp ist nicht für Tags innerhalb einer Tagcloud gedacht, da jene Tags auf eine Gruppe von Seiten angewendet werden, während der tag Wert des rel Attributs für ein einziges Dokument ist.

terms-of-service

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

Nicht-standardisierte Werte

apple-touch-icon: Gibt das Symbol für eine Web-Anwendung auf einem iOS-Gerät an.

Spezifikationen

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

HTML-Attribut: rel

Werte

Nicht-standardisierte Werte

Spezifikationen

Browser-Kompatibilität

html.elements.link.rel

html.elements.a.rel

html.elements.area.rel

html.elements.form.rel

Siehe auch