html-xml-lang-mismatch
/html-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.
- Autor
- thedaviddias ↗
- Repozytorium
- front-end-checklist ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 06.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 06.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
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.
Oryginalny opis (EN)
Use when applies to XHTML documents and polyglot HTML documents that must parse correctly as both HTML5 and XML. For modern HTML5-only documents, only `lang` is needed and `xml:lang` is not required. Check when auditing documents served as application/xhtml+xml or documents that include both attributes.
Jak działa
- Quick Reference
- Check
- Fix
- Explain
- Code Review
Podgląd SKILL.md
--- name: html-xml-lang-mismatch description: "Use when applies to XHTML documents and polyglot HTML documents that must parse correctly as both HTML5 and XML. For modern HTML5-only documents, only `lang` is needed and `xml:lang` is not required. Check when auditing documents served as application/xhtml+xml or documents that include both attributes." metadata: category: accessibility priority: medium difficulty: beginner estimatedTime: "5" source: frontendchecklist.io url: https://frontendchecklist.io/rules/accessibility/html-xml-lang-mismatch --- # Match lang and xml:lang attributes Screen readers use the `lang` attribute to select the correct voice profile and pronunciation engine. If `lang` and `xml:lang` disagree, XML-based processors (including some EPUB readers and older assistive technologies) may use `xml:lang` and get a different language than intended — causing text to be read aloud in the wrong language. For example, French text read with an English voice profile produces unintelligible output for French-speaking blind users. ## Quick Reference - If both `lang` and `xml:lang` are present on `<html>`, their values must be identical - `xml:lang` is only needed for XHTML or polyglot documents (valid as both HTML and XML) - For standard HTML5 documents, only `lang` is required — `xml:lang` is redundant - The primary language tag must be a valid BCP 47 language code (e.g., `en`, `en-US`, `fr`, `zh-Hant`) - Relates to WCAG 2.1 SC 3.1.1 (Language of Page) ## Check Inspect the `<html>` element for both `lang` and `xml:lang` attributes. If both are present, verify their values are identical (including subtags — `en` vs `en-US` is a mismatch). Also verify that the value is a valid BCP 47 language tag. Flag if the values differ in any way. ## Fix If `lang` and `xml:lang` are present but differ: update both to the same valid BCP 47 language code matching the primary language of the document content. If this is a standard HTML5 document (served as text/html), remove `xml:lang` — it is unnecessary. If this is XHTML or a polyglot document, keep both and ensure they are identical. ## Explain WCAG 2.1 SC 3.1.1 requires that the default human language of each web page can be programmatically determined. The `lang` attribute on `<html>` serves this purpose for HTML parsers. The `xml:lang` attribute serves the same purpose for XML parsers. When a document must be valid as both HTML and XML (polyglot), both attributes must be present and identical. A mismatch means the document claims different languages depending on which parser reads it, which can cause screen readers, translation tools, and spell checkers to use wrong language rules. ## Code Review Review the rendered markup and interactive states that affect Match lang and xml:lang attributes. Flag exact elements, roles, labels, focus behavior, or keyboard interactions that violate the rule, and note how to verify the fix with browser accessibility tooling or assistive tech. --- For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`. Rule page: https://frontendchecklist.io/rules/accessibility/html-xml-lang-mismatch
Pliki w paczce (2)
- SKILL.md 3 KB
- references/rule.md 4 KB
Wersje
W bazie nie ma innych skilli o nazwie html-xml-lang-mismatch.
Migawka bazy z 13.11.2026 · wersja paczki 5444efc0d69d (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
- 100lang-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ą. - 100knx-xml-context
Ładuje kontekst do pracy z XML KNX i plikami knxprod, w tym reguły walidacji. - 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. - 100create-lang-dev-skill
Tworzy skill programistyczny dla konkretnego języka (rust-dev, go-dev, python-dev) na podstawie przeglądów PR, konwencji kodu, systemu budowania i dokumentacji zespołu. - 96multi-lang-readme-cn
Tworzy dwujęzyczne lub wielojęzyczne wersje README na podstawie istniejącego pliku, zachowując jego strukturę Markdown. - 100ui-guidelines
Przedstawia wytyczne UI dla HMIS na stronach JSF i XHTML: komponenty PrimeFaces, układ, formularze, przyciski, panele, tabele danych, responsywność i dostępność.