HTML-Attribut: rel

Das rel-Attribut definiert die Beziehung zwischen einer verknüpften Ressource und dem aktuellen Dokument. Es ist gültig bei <link>, <a>, <area> und <form>; die unterstützten Werte hängen von dem Element ab, auf dem das Attribut gefunden wird.

Die Art der Beziehungen wird durch den Wert des rel-Attributs angegeben, das, wenn es vorhanden ist, einen Wert haben muss, der eine ungeordnete Menge von eindeutigen durch Leerzeichen getrennten Schlüsselwörtern ist. Anders als ein class-Name, der keine Semantik ausdrückt, muss das rel-Attribut Tokens ausdrücken, die sowohl für Maschinen als auch für 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-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, werden einige HTML-Validierungsprogramme (wie der W3C Markup Validation Service) eine Warnung generieren.

Die folgende Tabelle listet einige der wichtigsten bestehenden 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 Repräsentationen 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 vorfahren Abschnitt.	Nicht erlaubt	Link	Nicht erlaubt
`canonical`	Bevorzugte URL für das aktuelle Dokument.	Link	Nicht erlaubt	Nicht erlaubt
`compression-dictionary`	Verlinkung zu einem Kompressionswö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 vorsorglich die DNS-Auflösung für den Ursprung der Zielressource durchführen soll.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`external`	Das referenzierte Dokument ist nicht Teil derselben Seite wie das aktuelle Dokument.	Nicht erlaubt	Annotation	Annotation
`expect`	Wenn verwendet mit `blocking="render"`, erlaubt es, die Seite render-blockiert zu halten, bis die wesentlichen Teile des Dokuments geparst sind, damit es konsistent gerendert wird.	Link	Nicht erlaubt	Nicht erlaubt
`help`	Link zu kontextbezogener 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 von der urheberrechtlichen Lizenz des referenzierten Dokuments 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, der der verknüpfte Inhalt gehört.	Link	Link	Nicht erlaubt
`modulepreload`	Weist den Browser an, das Skript vorsorglich herunterzuladen und es im Modul-Map des Dokuments für eine spätere Ausführung zu speichern. Optional können auch die Abhängigkeiten des Moduls heruntergeladen 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 unterstützt.	Nicht erlaubt	Annotation	Annotation
`noopener`	Erstellt einen Top-Level-Browsing-Kontext, der kein Hilfs-Browsing-Kontext ist, wenn der Hyperlink entweder von diesen erstellen würde (d.h. hat einen entsprechenden `target`-Attributswert).	Nicht erlaubt	Annotation	Annotation
`noreferrer`	Kein `Referer`-Header wird inkludiert. Zusätzlich hat es denselben Effekt wie `noopener`.	Nicht erlaubt	Annotation	Annotation
`opener`	Erstellt einen Hilfs-Browsing-Kontext, wenn der Hyperlink ansonsten einen Top-Level-Browsing-Kontext erstellen würde, der kein Hilfs-Browsing-Kontext ist (d.h. hat `"_blank"` als `target`-Attributswert).	Nicht erlaubt	Annotation	Annotation
`pingback`	Gibt die Adresse des Pingback-Servers an, der die Pingbacks zu dem aktuellen Dokument behandelt.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`preconnect`	Gibt an, dass der Benutzeragent vorsorglich eine Verbindung zum Ursprung der Zielressource herstellen soll.	Externe Ressource	Nicht erlaubt	Nicht erlaubt
`prefetch`	Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und zwischenspeichern soll, 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 abrufen und für die aktuelle Navigation zwischenspeichern muss, gemäß dem möglichen 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` Veraltet	Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und auf eine Weise verarbeiten soll, die hilft, in Zukunft eine schnellere Antwort zu liefern. Diese Funktion wird durch die Speculation Rules API ersetzt.	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 Datenanwendungs- und Datenerhebungspraktiken des aktuellen Dokuments.	Link	Link	Nicht erlaubt
`search`	Gibt einen Link zu einer Ressource, die verwendet werden kann, um im aktuellen Dokument und seinen verwandten Seiten zu suchen.	Link	Link	Link
`stylesheet`	Importiert eine 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 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 relevant für eine Teilmenge dieser Elemente. Wie alle HTML-Schlüsselwort-Attributwerte sind diese Werte nicht case-sensitive.

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 bestimmte Beziehung zur Zielressource, außer dass es einen Hyperlink zwischen den beiden gibt. In diesem Fall, bei <link> und <form>, falls das rel-Attribut fehlt, keine Schlüsselwörter hat oder wenn keine oder mehrere der oben genannten durch Leerzeichen getrennten Schlüsselwörter nicht vorhanden sind, dann erzeugt das Element keine Links. <a> und <area> erstellen jedoch weiterhin Links, jedoch ohne eine definierte Beziehung.

Wert

alternate

Gibt eine alternative Repräsentation 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 sich von der Dokumentsprache unterscheidet, zeigt es eine Übersetzung an.
Mit einem type-Attribut mit dem Wert "application/rss+xml" oder "application/atom+xml" erstellt es einen Hyperlink, der auf einen Syndikations-Feed verweist.
html
```
<link
  rel="alternate"
  type="application/atom+xml"
  href="posts.xml"
  title="Blog" />
```
Andernfalls erstellt es einen Hyperlink auf eine alternative Darstellung des aktuellen Dokuments, 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, zeigt dies an, dass das referenzierte Dokument eine Übersetzung ist.
- Wenn type zusammen mit alternate angegeben wird, zeigt dies 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 weitere Informationen über den Autor des aktuellen Dokuments oder Artikels bereitstellt. Relevanz für <link>, <a> und <area>-Elemente.

Bei <a> und <area> gibt es an, dass das verlinkte Dokument (oder mailto:) Informationen über den Autor des nächsten <article>-Vorfahren liefert, falls vorhanden, ansonsten das gesamte Dokument.

Bei <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ächstgelegene Vorfahren-<article>-Element an, falls vorhanden. Wenn kein Vorfahren-<article>-Element vorhanden ist, gibt es einen Permalink 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 verwendet werden kann, um zukünftige Downloads für Ressourcen auf dieser Seite zu komprimieren, so dass die Downloadgrößen dieser Ressourcen kleiner sind als bei regulärer Kompression.

dns-prefetch

Relevant für das <link>-Element sowohl im <body> als auch im <head>, es teilt dem Browser mit, dass er vorsorglich die DNS-Auflösung für den Ursprung der Zielressource durchführen soll. 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 vorsorglich durchgeführt hat. Siehe dns-prefetch beschrieben in resource hints.

external

Relevanz 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 auf eine Weise zu gestalten, die dem Benutzer anzeigt, dass sie die aktuelle Website verlassen werden.

expect Experimentell

Erlaubt der Seite, render-blockiert zu werden, bis die wesentlichen Teile des Dokuments geparst werden, so dass es konsistent gerendert wird. Beachten Sie, dass das Render-Blocking nur auftritt, wenn es mit dem blocking="render"-Attribut ergänzt wird.

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

help

Relevanz für <form>, <link>, <a> und <area>, das help-Schlüsselwort gibt an, dass der verlinkte Inhalt kontextbezogene Hilfe bietet und Informationen für das übergeordnete Element des Elements liefert, das den Hyperlink definiert, sowie dessen Kinder. Wenn innerhalb von <link> verwendet, ist die Hilfe für das gesamte Dokument. Wenn es bei <a> und <area> enthalten ist und unterstützt wird, ist der Standard-cursor help anstelle von pointer.

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.

Der häufigste Gebrauch 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 erkannt wird, zum Beispiel weil es ein nicht unterstütztes Format verwendet, fährt der Browser mit dem nächst best geeigneten fort und so weiter.

Hinweis: Das crossorigin-Attribut wird für rel="icon" in Chromium-basierten Browsern nicht unterstützt. Siehe den offenen Chromium-Issue.

Hinweis: Apples iOS verwendet diesen Link-Typ nicht, noch das sizes-Attribut, wie es andere mobile Browser tun, um ein Webseiten-Icon für Web Clip oder einen Startplatzhalter auszuwählen. Stattdessen verwendet es das nicht standardmäßige apple-touch-icon und apple-touch-startup-image jeweils.

Hinweis: Der shortcut-Link-Typ wird häufig vor icon gesehen, 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, 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 im referenzierten Dokument beschriebene urheberrechtliche Lizenz abgedeckt ist. Wenn nicht im <head>-Element, unterscheidet der Standard nicht zwischen einem Hyperlink, der auf einen spezifischen Teil des Dokuments oder auf das Dokument als Ganzes anzuwenden ist. Nur die Daten auf der Seite können dies anzeigen.

html

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

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

manifest

Web-App-Manifest. Erfordert die Verwendung des CORS-Protokolls für eine Domain-übergreifende Abfrage.

modulepreload

Nützlich zur Verbesserung der Leistung, und relevant für das <link> irgendwo im Dokument, das Setzen von rel="modulepreload" teilt dem Browser mit, dass er das Skript (und Abhängigkeiten) vorsorglich abrufen und es im Modul-Map des Dokuments für eine spätere Auswertung speichern soll. modulepreload-Links können sicherstellen, dass das Netzwerkabrufen mit dem Modul bereit (aber nicht ausgewertet) im Modul-Map erfolgt, bevor es notwendigerweise benötigt wird. Siehe auch modulepreload.

next

Relevant für <form>, <link>, <a>, und <area>, der next-Wert gibt an, dass das aktuelle Dokument Teil einer Serie ist und dass das nächste Dokument in der Serie das referenzierte Dokument ist. Wenn es in einem <link> enthalten ist, können Browser davon ausgehen, dass das Dokument als nächstes abgerufen wird und es als Ressourcenzuschlag behandeln.

nofollow

Relevant für <form>, <a>, und <area>, das nofollow-Schlüsselwort teilt Suchmaschinen-Suchbots mit, die Link-Beziehung zu ignorieren. Die nofollow-Beziehung kann darauf hinweisen, dass der Besitzer des aktuellen Dokuments das referenzierte Dokument nicht unterstützt. Es wird oft von Suchmaschinenoptimierern eingefügt, die ihren Link-Farmen vortäuschen, keine Spam-Seiten zu sein.

noopener

Relevant für <form>, <a>, und <area>, erstellt einen Top-Level-Browsing-Kontext, der kein Hilfs-Browsing-Kontext ist, wenn der Hyperlink entweder von diesen erstellen würde (d.h. hat einen entsprechenden target-Attributswert). Mit anderen Worten, es lässt den Link so 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>, einschließlich dieses Werts macht den Referrer unbekannt (kein Referer-Header wird inkludiert) und erstellt einen Top-Level-Browsing-Kontext, als ob auch noopener gesetzt wäre.

opener

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

pingback

Gibt die Adresse des Pingback-Servers an, der die Pingbacks zu dem aktuellen Dokument behandelt. Siehe die Pingback-Spezifikation.

preconnect

Bietet dem Browser einen Hinweis, dass er im Voraus eine Verbindung zur verlinkten Website herstellen soll, ohne private Informationen preiszugeben oder Inhalte herunterzuladen, damit, wenn der Link gefolgt 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 mehr Informationen.

preload

Gibt an, dass der Benutzeragent die Zielressource vorsorglich abrufen und für die aktuelle Navigation zwischenspeichern muss, gemäß dem möglichen 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 soll, die hilft, in Zukunft eine schnellere Antwort zu liefern, zum Beispiel durch Abrufen seiner Unterressourcen oder durch Rendering. Diese Funktion wird durch die Speculation Rules API ersetzt.

prev

Ähnlich dem next-Schlüsselwort, relevant für <form>, <link>, <a>, und <area>, der prev-Wert gibt 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, der privacy-policy-Wert gibt an, dass das referenzierte Dokument die Datenschutzerklärung ist, die die Datenanwendungs- und Datenerhebungspraktiken 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 zum Durchsuchen im aktuellen Dokument, der Seite und den verwandten Ressourcen gestaltet ist und einen Link zu einer Ressource bietet, die zum Suchen verwendet werden kann.

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

stylesheet

Gültig für das <link>-Element, importiert es eine externe Ressource als Stylesheet. Das type-Attribut ist nicht notwendig, wenn es sich um ein text/css-Stylesheet handelt, da dies der Standardwert ist. Wenn es kein Stylesheet des Typs text/css ist, ist es am besten, den Typ zu deklarieren.

Während dieses Attribut den Link als ein Stylesheet definiert, beeinflusst die Interaktion mit anderen Attributen und anderen Schlüsselwörtern 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 sollte ein nicht-leerer title enthalten sein.

Das externe Stylesheet wird nicht verwendet oder sogar heruntergeladen, wenn das Medienattribut den Wert des media nicht entspricht.

Erfordert die Verwendung des CORS-Protokolls für eine Domain-übergreifende Abfrage.

tag

Gültig für die <a>- und <area>-Elemente, gibt es 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 Tag beschreibt, das auf das Dokument zutrifft, in dem er sich befindet. Dieser Link-Typ ist nicht für Tags innerhalb einer Tag-Wolke gedacht, da diese Tags auf eine Gruppe von Seiten zutreffen, während der tag-Wert des rel-Attributs für ein einzelnes Dokument gilt.

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 beschreibt, die die Vereinbarungen zwischen dem Anbieter des aktuellen Dokuments und den Benutzern beschreibt, die das bereitgestellte Dokument verwenden möchten.

Nicht-standardgemäße Werte

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

Spezifikationen

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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

HTML-Attribut: rel

Wert

Nicht-standardgemäße Werte

Spezifikationen

Browser-Kompatibilität

html.elements.link.rel

html.elements.a.rel

html.elements.area.rel

html.elements.form.rel

Siehe auch

Help improve MDN