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

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.

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

  1. Quick Reference
  2. Check
  3. Fix
  4. Explain
  5. Code Review
Sekcje z nagłówków SKILL.md, w oryginale · 36 linii, 407 słów
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ść.

Uwagi i zgłoszenia

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