Коды языков: ISO 639-1 и языковые теги BCP 47

Атрибут lang содержит языковой тег BCP 47: обозначение языка и, при необходимости, уточнения письменности, региона или варианта. Основной код часто состоит из двух или трёх букв: ru, en, fil. Подтеги разделяются дефисом; они не ограничены двумя буквами.

Например, en-US обозначает английский язык в США, zh-Hans — китайский с упрощённой письменностью, es-419 — испанский в Латинской Америке и Карибском регионе. Регион не равнозначен диалекту. Указывайте уточнение только тогда, когда оно важно для текста; таблица ниже перечисляет двухбуквенные коды, а не все допустимые языковые теги.

<p lang="ru">Приветствие: <span lang="fil">Magandang araw</span>.</p>

В примере язык абзаца — русский, а lang="fil" сообщает средствам чтения с экрана язык отдельной фразы. Для остальных вложенных элементов действует язык родителя.

Основная функция глобального атрибута lang определить язык содержимого внутри HTML элемента. Например, атрибут lang, применённый к тегу <html> указывает язык содержимого веб-страницы (для всего текста на странице).

Атрибут имеет следующий синтаксис:

lang = "Код языка"

Пример использования атрибута в мультиязычном документе:

<!DOCTYPE html>
<html lang="ru">
  <!-- указывает язык содержимого веб-страницы -->
  <head>
    <title>Пример использования атрибута lang</title>
  </head>
  <body>
    <p lang="es"> ¿Por qué necesita una traducción? </p>
    <!-- Этот параграф интерпретируется как испанский -->
    <p>И дальше по тексту интерпретация языка продолжается на русском </p><p> </p
  ></body>
</html>

В этом примере основной язык документа является русский ("ru"), а один абзац объявлен на испанском языке ("es").

Таблица содержит регистрацию двухбуквенных кодов (ISO 639-1):

Спецификация

BCP 47: Tags for Identifying Languages.