WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

hreflang — Sprache der verknüpften Ressource

Das Attribut hreflang gibt die Sprache einer verknüpften Ressource an. Sein Wert ist ein gültiges BCP-47-Sprachtag und dient nur als Hinweis: Es legt weder die Sprache des aktuellen Dokuments fest noch ersetzt es Sprachinformationen der abgerufenen Ressource.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<a href="URL" hreflang="language-tag">...</a>
<link rel="alternate" href="URL" hreflang="language-tag">

Das Attribut hreflang beschreibt die Sprache der verknüpften Ressource, nicht die Sprache des Linktexts. Sein Wert muss ein gültiges BCP-47-Sprachtag sein, etwa en oder en-GB. Es ist kein boolesches Attribut: Gib ein Sprachtag an und keinen leeren Wert.

Bei einem a-Element beschreibt es das Ziel des Hyperlinks. Bei einem link-Element hat es dieselbe Bedeutung; die Kombination aus rel="alternate" und hreflang kann eine alternative Sprachversion kennzeichnen. Allein beweist hreflang nicht, dass die Ressource eine Übersetzung der aktuellen Seite ist.

Die Angabe dient ausschließlich als Hinweis. Nach dem Abrufen der Ressource muss der Browser deren Sprache anhand von Informationen bestimmen, die zu dieser Ressource gehören, nicht anhand der Link-Metadaten. Verwechsle hreflang nicht mit lang, das die Sprache des Inhalts eines Elements festlegt; das Attribut übersetzt auch keinen Text.

Im Beispiel beschreibt lang="pl" das Dokument, während sich beide Vorkommen von hreflang="en" auf guide-en.html beziehen. Der sichtbare Text lautet English guide; die link-Metadaten fügen keinen zweiten sichtbaren Link hinzu.

Beispiele

<!doctype html>
<html lang="pl">
<head>
  <meta charset="utf-8">
  <title>hreflang</title>
  <link rel="alternate" href="guide-en.html" hreflang="en">
</head>
<body>
  <a href="guide-en.html" hreflang="en">English guide</a>
</body>
</html>

Ergebnis

English guide

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen