Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

hreflang — język zasobu docelowego

Atrybut hreflang podaje język zasobu wskazanego przez odnośnik. Przyjmuje poprawny znacznik języka BCP 47 i stanowi jedynie wskazówkę: nie ustala języka bieżącego dokumentu ani nie zastępuje informacji językowych pobranego zasobu.

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

Składnia

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

Atrybut hreflang opisuje język zasobu wskazanego przez odnośnik, a nie język tekstu odnośnika. Jego wartość musi być poprawnym znacznikiem języka BCP 47, takim jak en lub en-GB. Nie jest to atrybut logiczny: podaj znacznik języka, zamiast zostawiać pustą wartość.

Na elemencie a opisuje cel hiperłącza. Na elemencie link ma takie samo znaczenie; połączenie rel="alternate" z hreflang pozwala wskazać alternatywną wersję językową. Sam hreflang nie oznacza, że zasób jest tłumaczeniem bieżącej strony.

Informacja jest wyłącznie doradcza. Po pobraniu zasobu przeglądarka musi ustalać jego język na podstawie informacji związanych z tym zasobem, a nie metadanych odnośnika. Nie myl hreflang z lang, który określa język treści elementu; atrybut nie tłumaczy też tekstu.

W przykładzie lang="pl" opisuje dokument, natomiast oba wystąpienia hreflang="en" opisują guide-en.html. Widoczny tekst to English guide; metadane link nie dodają drugiego widocznego odnośnika.

Przykłady

<!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>

Wynik

English guide

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła