HTML-Attribut: rel

Das rel Attribut definiert die Beziehung zwischen einer verknüpften Ressource und dem aktuellen Dokument. Es kann auf den Elementen <link>, <a>, <area>, und <form> verwendet werden. Welche Werte unterstützt werden, hängt davon ab, auf welchem Element das Attribut verwendet wird.

Die Art der Beziehungen wird durch den Wert des rel Attributs angegeben, der, falls vorhanden, ein ungeordnetes Set von einzigartigen, durch Leerzeichen getrennten Schlüsselwörtern sein muss. Im Gegensatz zu einem class Namen, der keine Semantik ausdrückt, muss das rel Attribut semantisch gültige Tokens sowohl für Maschinen als auch für Menschen ausdrücken. 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 vorgeschlagen vom Living Standard. Wenn ein rel Attribut verwendet wird, das in keiner der drei oben genannten Quellen vorhanden ist, wird ein HTML-Validator (wie der W3C Markup Validation Service) eine Warnung generieren.

Die folgende Tabelle listet einige der wichtigsten vorhandenen Schlüsselwörter auf. Jedes Schlüsselwort innerhalb eines durch Leerzeichen getrennten Werts sollte innerhalb dieses Werts 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`	Permanent-Link 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 Kompressionswörterbuch, das zur Komprimierung künftiger Downloads für Ressourcen auf dieser Seite verwendet werden kann.	Link	Nicht erlaubt	Nicht erlaubt
`dns-prefetch`	Weist den Browser an, präventiv eine DNS-Auflösung für den Ursprung der Zielressource durchzuführen.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`external`	Das referenzierte Dokument gehört nicht zur gleichen Seite wie das aktuelle Dokument.	Nicht erlaubt	Annotation	Annotation
`expect`	Erlaubt, dass die Seite blockierend gerendert wird, bis die wesentlichen Teile des Dokuments analysiert sind, damit es konsistent gerendert wird.	Link	Nicht erlaubt	Nicht erlaubt
`help`	Link zu kontextsensitiver Hilfe.	Link	Link	Link
`icon`	Ein Icon, das das aktuelle Dokument repräsentiert.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`license`	Gibt an, dass der Hauptinhalt des aktuellen Dokuments durch die im referenzierten Dokument beschriebene Urheberrechtslizenz abgedeckt ist.	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`	Weist den Browser an, das Skript präventiv zu laden und im Modul-Map des Dokuments für eine spätere Auswertung zu speichern. Optional können auch die Abhängigkeiten des Moduls geladen werden.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`next`	Gibt an, 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`	Gibt an, dass der ursprüngliche Autor oder Herausgeber des aktuellen Dokuments das referenzierte Dokument nicht befürwortet.	Nicht erlaubt	Annotation	Annotation
`noopener`	Erstellt einen übergeordneten Browsing-Kontext, der kein Hilfs-Browsing-Kontext ist, wenn der Hyperlink von Anfang an entweder einen von beiden erstellen würde (d.h. wenn er einen geeigneten `target` Attributwert hat).	Nicht erlaubt	Annotation	Annotation
`noreferrer`	Kein `Referer` Header wird eingeschlossen. Zudem hat es den gleichen Effekt wie `noopener`.	Nicht erlaubt	Annotation	Annotation
`opener`	Erstellt einen Hilfs-Browsing-Kontext, wenn der Hyperlink andernfalls einen übergeordneten Browsing-Kontext erstellen würde, der kein Hilfs-Browsing-Kontext ist (d.h. wenn `"_blank"` als `target` Attributwert angegeben ist).	Nicht erlaubt	Annotation	Annotation
`pingback`	Gibt die Adresse des Pingback-Servers an, der die Pingbacks zum aktuellen Dokument verarbeitet.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`preconnect`	Gibt an, dass der Nutzeragent präventiv eine Verbindung zum Ursprung der Zielressource herstellen sollte.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prefetch`	Gibt an, dass der Nutzeragent die Zielressource präventiv 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 Nutzeragent die Zielressource präventiv abrufen und zwischenspeichern muss für die aktuelle Navigation gemäß der potenziellen Destination, die durch das `as` Attribut (und der Priorität, die der entsprechenden Destination zugeordnet ist) gegeben wird.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prerender`	Gibt an, dass der Nutzeragent die Zielressource präventiv abrufen und auf eine Weise verarbeiten sollte, die dazu beiträgt, eine schnellere Antwort in der Zukunft zu liefern.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prev`	Gibt an, 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 Datenverarbeitungs- und Nutzungspraxen an, die für das aktuelle Dokument gelten.	Link	Link	Nicht erlaubt
`search`	Gibt einen Link zu einer Ressource, die verwandt 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 gegebene Adresse) an, das auf das aktuelle Dokument angewandt wird.	Nicht erlaubt	Link	Nicht erlaubt
`terms-of-service`	Link zum Vertrag oder den Nutzungsbedingungen, zwischen dem Anbieter des Dokuments und den 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 alle HTML-Schlüsselwort-Attributwerte sind diese Werte nicht case-sensitiv.

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

Wert

alternate

Gibt eine alternative Darstellung des aktuellen Dokuments an. Gültig für <link>, <a>, und <area>, die Bedeutung hängt 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 von der Dokumentsprache abweicht, zeigt es eine Übersetzung an.
Mit einem type Attributwert von "application/rss+xml" oder "application/atom+xml", erstellt es einen Hyperlink, der einen Syndikations-Feed referenziert.
html
```
<link
  rel="alternate"
  type="application/atom+xml"
  href="posts.xml"
  title="Blog" />
```
Andernfalls erstellt es einen Hyperlink, der eine alternative Darstellung des aktuellen Dokuments referenziert, deren Art durch die hreflang und type Attribute gegeben ist.
- Wenn hreflang zusammen mit alternate angegeben ist 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 ist, zeigt es an, dass das referenzierte Dokument ein alternatives Format (wie 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

Gibt an, dass das referenzierte Dokument zusätzliche 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, sofern 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 Permanent-Link für das nächste übergeordnete <article> Element an, sofern vorhanden. Wenn kein übergeordnetes <article> Element vorhanden ist, gibt es einen Permanent-Link für den Abschnitt an, mit dem das verlinkende Element am engsten verbunden ist.

canonical

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

compression-dictionary Experimentell

Gültig für <link>, es definiert ein Kompressionswörterbuch, das zur Komprimierung künftiger Downloads für Ressourcen auf dieser Seite verwendet werden kann, sodass die Downloadgrößen dieser Ressourcen kleiner sind als bei normaler Kompression.

dns-prefetch

Relevant für das <link> Element sowohl im <body> als auch im <head>, es teilt dem Browser mit, die DNS-Auflösung für den Ursprung der Zielressource präventiv durchzuführen. Nützlich für Ressourcen, die der Benutzer wahrscheinlich benötigt. Es hilft dabei, die Latenz zu verringern und die Leistung zu verbessern, wenn der Benutzer die Ressourcen tatsächlich abruft, da der Browser präventiv die DNS-Auflösung für den Ursprung der angegebenen Ressource durchgeführt hat. Siehe dns-prefetch, beschrieben in resource hints.

external

Relevant für <form>, <a>, und <area>, es gibt an, dass das referenzierte Dokument nicht Teil der aktuellen Seite ist. Dies kann mit Attributselektoren verwendet werden, um externe Links so zu gestalten, dass dem Benutzer angezeigt wird, dass er die aktuelle Seite verlässt.

expect Experimentell

Erlaubt, dass die Seite blockierend gerendert wird, bis die wesentlichen Teile des Dokuments analysiert sind, damit es konsistent gerendert wird. Beachten Sie, dass das blockierende Rendering nur erfolgt, wenn es mit dem blocking="render" Attribut ergänzt wird.

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

help

Relevant für <form>, <link>, <a>, und <area>, das Schlüsselwort help gibt an, dass der verlinkte Inhalt kontextbezogene Hilfe bietet, die Informationen für das übergeordnete Element des definierenden Hyperlinks und dessen Kinder bereitstellt. Wenn es innerhalb eines <link> verwendet wird, ist die Hilfe für das gesamte Dokument gedacht. Wenn es mit <a> und <area> enthalten ist und unterstützt wird, wird der Standard-cursor help statt pointer sein.

icon

Gültig für <link>, die verlinkte Ressource repräsentiert das Icon, eine Ressource, die die Seite im Benutzerinterface für das aktuelle Dokument darstellt.

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 befunden wird, z.B. weil es ein nicht unterstütztes Format verwendet, fährt der Browser mit dem nächstbesten Icon fort.

Hinweis: Das crossorigin Attribut wird für 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 andere mobile Browser tun, um ein Webseiten-Icon für Webclips oder einen Start-Platzhalter auszuwählen. Stattdessen verwendet es die nicht standardisierten apple-touch-icon und apple-touch-startup-image.

Hinweis: Der shortcut Linktyp wird oft vor icon gesehen, aber dieser Linktyp ist nicht konform, wird ignoriert und Webautoren dürfen ihn nicht mehr verwenden.

license

Gültig für die <a>, <area>, <form>, <link> Elemente, der license Wert gibt 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 sich nicht innerhalb des <head> Elements, 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 angeben.

html

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

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

manifest

Web-App-Manifest. Erfordert die Verwendung des CORS-Protokolls für das Abrufen von fremden Ursprüngen.

modulepreload

Nützlich für verbesserte Leistung, und relevant für das <link> an jeder Stelle im Dokument, gibt rel="modulepreload" an, dass der Browser das Skript (und Abhängigkeiten) präventiv abrufen und im Modul-Map des Dokuments für eine spätere Auswertung speichern soll. modulepreload Links können sicherstellen, dass das Netzwerken beendet ist, bevor das Modul bereit ist (aber nicht ausgewertet) im Modul-Map, bevor es unbedingt benötigt wird. Siehe auch modulepreload.

next

Relevant für <form>, <link>, <a>, und <area>, der next Wert zeigt 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önnen Browser davon ausgehen, dass das Dokument als nächstes abgerufen wird und dies als Ressource Hinweis behandeln.

nofollow

Relevant für <form>, <a>, und <area>, das Schlüsselwort nofollow teilt Suchmaschinen-Spidern mit, die Linkbeziehung zu ignorieren. Die nofollow-Beziehung kann darauf hinweisen, dass der Eigentümer des aktuellen Dokuments das referenzierte Dokument nicht befürwortet. Es wird oft von Suchmaschinenoptimierern eingeschlossen, die behaupten, dass ihre Linkfarmen keine Spampages sind.

noopener

Relevant für <form>, <a>, und <area>, erstellt einen übergeordneten Browsing-Kontext, der kein Hilfs-Browsing-Kontext ist, wenn der Hyperlink von Anfang an entweder einen von beiden erstellen würde (d.h. hat einen geeigneten target Attributwert). Mit anderen Worten, es lässt den Link sich verhalten, 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>, inklusive dieses Werts macht den Referrer unbekannt (kein Referer Header wird eingeschlossen), und erstellt einen übergeordneten Browsing-Kontext, als ob noopener auch gesetzt wäre.

opener

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

pingback

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

preconnect

Bietet dem Browser einen Hinweis, dass er im Voraus eine Verbindung zur verlinkten Website öffnen soll, ohne private Informationen preiszugeben oder Inhalte herunterzuladen, sodass der verlinkte Inhalt schneller abgerufen werden kann, wenn der Link verfolgt wird.

prefetch

Gibt an, dass der Nutzeragent die Zielressource präventiv abrufen und zwischenspeichern sollte, da sie wahrscheinlich für eine nachfolgende Navigation benötigt wird. Für weitere Informationen siehe prefetch.

preload

Gibt an, dass der Nutzeragent die Zielressource für die aktuelle Navigation gemäß der potenziellen Destination, die durch das as Attribut (und der Priorität, die der entsprechenden Destination zugeordnet ist) gegeben wird, präventiv abrufen und zwischenspeichern muss. Siehe die Seite für den preload Wert.

prerender Veraltet Nicht standardisiert

Gibt an, dass der Nutzeragent die Zielressource präventiv abrufen und auf eine Weise verarbeiten sollte, die dazu beiträgt, eine schnellere Antwort in der Zukunft zu liefern, zum Beispiel durch das Abrufen ihrer Unterressourcen oder die Durchführung einiger Renderings.

prev

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

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

privacy-policy

Gültig für <a>, <area>, und <link> Elemente, der privacy-policy Wert gibt an, dass das referenzierte Dokument die Datenschutzrichtlinie ist, die die Datenverarbeitungs- und Nutzungspraxen des aktuellen Dokuments beschreibt.

search

Relevant für <form>, <link>, <a>, und <area> Elemente, die search Schlüsselwörter geben an, dass der Hyperlink auf ein Dokument verweist, dessen Oberfläche speziell für die Suche im aktuellen Dokument, auf der Webseite und in verwandten Ressourcen gestaltet wurde und einen Link zu einer Ressource bietet, 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 des Typs text/css handelt, ist es am besten, den Typ anzugeben.

Während dieses Attribut den Link als Stylesheet definiert, beeinflusst die Interaktion mit anderen Attributen und anderen Schlüsselbegriffen innerhalb des rel-Werts, 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 muss ein nicht-leerer title angegeben werden.

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

Erfordert die Verwendung des CORS-Protokolls für das Abrufen von fremden Ursprüngen.

tag

Gültig für die <a>, und <area> Elemente, es gibt ein Tag an (identifiziert durch die gegebene Adresse), das auf das aktuelle Dokument angewandt wird. Der Tag-Wert gibt an, dass der Link auf ein Dokument verweist, das ein Tag beschreibt, das auf das Dokument angewandt wird, in dem es sich befindet. Dieser Linktyp ist nicht für Tags innerhalb einer Tag-Wolke gedacht, da diese Tags auf eine Gruppe von Seiten angewandt werden, wohingegen der tag Wert des rel Attributs für ein einziges Dokument bestimmt ist.

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 sind, 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: Gibt das Icon für eine Webanwendung auf einem iOS-Gerät an.

Spezifikationen

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

HTML-Attribut: rel

Wert

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