Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Przegląd i audyt

lang-attribute

/lang-attribute

Sprawdza atrybut lang w dokumentach HTML: niepusty, poprawny kod BCP 47 w znaczniku html oraz zmiany języka na elementach z treścią wielojęzyczną.

Licencja
MIT
Ostatnia zmiana repozytorium
06.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Sprawdza atrybut lang w dokumentach HTML: niepusty, poprawny kod BCP 47 w znaczniku html oraz zmiany języka na elementach z treścią wielojęzyczną.

Oryginalny opis (EN)

Use when applies to all HTML documents. Check the `<html>` opening tag for a `lang` attribute with a non-empty, valid BCP 47 language code. Also check for `lang` attribute changes on individual elements when the document contains content in multiple languages (inline quotes, foreign terms, multilingual sections). The `lang` attribute is inherited — child elements inherit the language from their nearest ancestor with `lang`.

Jak działa

  1. Quick Reference
  2. Check
  3. Fix
  4. Explain
  5. Code Review
Sekcje z nagłówków SKILL.md, w oryginale · 36 linii, 486 słów
Podgląd SKILL.md
---
name: lang-attribute
description: "Use when applies to all HTML documents. Check the `<html>` opening tag for a `lang` attribute with a non-empty, valid BCP 47 language code. Also check for `lang` attribute changes on individual elements when the document contains content in multiple languages (inline quotes, foreign terms, multilingual sections). The `lang` attribute is inherited — child elements inherit the language from their nearest ancestor with `lang`."
metadata:
  category: html
  priority: high
  difficulty: beginner
  estimatedTime: "5"
  source: frontendchecklist.io
  url: https://frontendchecklist.io/rules/html/lang-attribute
---

# Set the page lang attribute

Screen readers select the correct text-to-speech voice and pronunciation engine based on the `lang` attribute. Without it, VoiceOver defaults to the user's system language, and NVDA uses its default voice — both may mispronounce words in other languages, making content unintelligible. French text read with an English voice profile is incomprehensible. The `lang` attribute also enables browser translation features (Chrome's Translate), hyphenation algorithms (CSS `hyphens: auto`), and correct spell checking. This is a WCAG Level A requirement — the most fundamental accessibility baseline.

## Quick Reference

- The `<html>` element must have a `lang` attribute — WCAG 2.1 SC 3.1.1 (Language of Page, Level A)
- The value must be a valid BCP 47 language tag: `en`, `en-US`, `fr`, `zh-Hant`, `ar`, etc.
- Use `lang` on individual elements to indicate language changes within the page — WCAG 2.1 SC 3.1.2 (Level AA)
- The `lang` attribute affects screen reader pronunciation, spell checking, hyphenation, and browser translation
- An empty `lang=''` is treated as unknown language — equivalent to having no `lang` attribute

## Check

Inspect the `<html>` element in the page source. Verify: (1) a `lang` attribute is present; (2) its value is non-empty; (3) its value is a valid BCP 47 language code matching the primary language of the page content (e.g., `en` for English, `fr` for French, `zh-Hant` for Traditional Chinese). Flag: missing `lang`, empty `lang=''`, language codes using full names instead of codes (e.g., `lang='english'` is invalid), and mismatches where the declared language does not match the actual content language. For multilingual pages, also check for `lang` changes on block-level elements containing content in a different language.

## Fix

Add or correct the `lang` attribute on the `<html>` element: `<html lang='en'>` for English, `<html lang='fr'>` for French, `<html lang='es'>` for Spanish, `<html lang='de'>` for German, `<html lang='ja'>` for Japanese, `<html lang='zh-Hans'>` for Simplified Chinese, `<html lang='zh-Hant'>` for Traditional Chinese, `<html lang='ar'>` for Arabic. For content sections in different languages, add `lang` to the containing block element. Validate language codes against the IANA Language Subtag Registry.

## Explain

WCAG 2.1 SC 3.1.1 (Language of Page, Level A) requires that the default human language of each web page can be programmatically determined. The `lang` attribute on `<html>` fulfills this requirement. The value must be a BCP 47 language tag — a standardized system of subtags that identifies language, script, and region. The primary language subtag (e.g., `en`, `fr`) is required; region subtags (e.g., `en-US`, `fr-CA`) are optional but useful for dialect-specific pronunciation and spell checking. SC 3.1.2 (Language of Parts, Level AA) extends this to inline language changes within a page.

## Code Review

Review templates, server-rendered HTML, and shared components that output markup related to Set the page lang attribute. Flag exact elements, attributes, and routes where the rendered HTML violates the rule.

---

For full implementation details, code examples, and framework-specific guidance,
see `references/rule.md`.

Rule page: https://frontendchecklist.io/rules/html/lang-attribute
Pliki w paczce (2)
  • SKILL.md 4 KB
  • references/rule.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie lang-attribute.

Migawka bazy z 13.11.2026 · wersja paczki f4583f56f423 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100html-xml-lang-mismatch
    Sprawdza spójność atrybutów lang i xml:lang w dokumentach XHTML i poliglotycznych HTML, które muszą poprawnie parsować się jako HTML5 i XML.
  • 100wp-bilingual
    Opisuje dwujęzyczny model witryny WordPressa: pola z sufiksami języka, funkcje tłumaczeń, przełącznik języka i atrybut lang.
  • 100okhp3-i18n-page-release
    Waliduje i przygotowuje do wydania zlokalizowany zestaw stron statycznych po przeglądzie tłumaczenia: adresy lokalizacji, wartości html lang BCP-47, canonicale, alternatywy hreflang, noindex na stagingu i dowody języka.
  • 100page-langs
    Wykrywa języki na stronie: zadeklarowane w znacznikach (html lang, hreflang, Content-Language) i obecne w tekście (CLD3) oraz raportuje rozbieżności, przy audytach i18n.
  • 100video-thumbnail
    Sprawdza atrybut poster w elementach video w HTML, czy pokazuje obraz przed startem i nie powoduje przesunięć układu.
  • 100form-brief
    Przekłada brief projektowy (I-Lang lub zwykły język) na konkretny DESIGN.md i opcjonalny podgląd tokenów HTML, rozstrzygając 8 wymiarów od palety po ograniczenia.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.