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

View in English Always switch to English

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 stylesheet 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" />
    
  • 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 Attribut type wird 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 hreflang und type angegeben wird.

    • Wenn hreflang zusammen mit alternate angegeben wird und sein Wert von der Sprache des aktuellen Dokuments abweicht, ist das referenzierte Dokument eine Übersetzung.
    • Wenn type zusammen mit alternate angegeben wird, liegt das referenzierte Dokument in einem alternativen Format vor, beispielsweise als PDF.
    • Die Attribute hreflang und type 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 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 (oder mailto:) 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" wie rel="author" behandelt.

bookmark

Relevant als Wert des Attributs rel fü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üsselwort help gibt 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ür cursor help statt pointer.

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 icon ist das Favicon:

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

Sind mehrere <link rel="icon">-Elemente vorhanden, wählt der Browser anhand ihrer Attribute media, type und sizes das 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 crossorigin wird für rel="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 Werte apple-touch-icon beziehungsweise apple-touch-startup-image.

Hinweis: Der Linktyp shortcut steht häufig vor icon. 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 Wert license gibt 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 copyright wird 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. Mit rel="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 auch modulepreload.

next

Relevant für <form>, <link>, <a> und <area>. Der Wert next gibt 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üsselwort nofollow weist 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 Attribut target hat). Anders ausgedrückt verhält sich der Link so, als wäre window.opener null und target="_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 kein Referer-Header gesendet) und erstellt einen Browsing-Kontext auf oberster Ebene, als wäre auch noopener gesetzt.

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). 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 as angegebenen möglichen Zieltyp und dessen Priorität. Siehe die Seite zum Wert preload.

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 next ist prev fü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 previous ist falsch und sollte nicht verwendet werden.

privacy-policy

Gültig für die Elemente <a>, <area> und <link>. Der Wert privacy-policy gibt an, dass das referenzierte Dokument die Datenschutzerklärung ist, die die Praktiken zur Datenerhebung und -nutzung für das aktuelle Dokument beschreibt.

Relevant für die Elemente <form>, <link>, <a> und <area>. Das Schlüsselwort search gibt 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 type auf application/opensearchdescription+xml gesetzt, 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 Typ text/css ist das Attribut type nicht 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 alternate definiert es ein alternatives Stylesheet. Geben Sie in diesem Fall ein nicht leeres Attribut title an.

Das externe Stylesheet wird weder verwendet noch heruntergeladen, wenn das Medium nicht zum Wert des Attributs media passt.

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 Wert tag bedeutet, 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 Wert tag des Attributs rel auf ein einzelnes Dokument bezieht.

terms-of-service

Gültig für die Elemente <a>, <area> und <link>. Der Wert terms-of-service gibt 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

Browser-Kompatibilität

html.elements.link.rel

html.elements.a.rel

html.elements.area.rel

html.elements.form.rel

Siehe auch