A11yDocs 検査項目エラー集 WCAG 3.1.1

WCAG 3.1.1: ページの既定言語が html lang 等で宣言されているか確認する

ページ全体の主要な言語がhtml要素のlang属性で正しく宣言され、支援技術が適切な読み上げ言語を選択できるか確認します。

Level A 確認方法: 自動検査

意図的な失敗例: ページの既定言語がない

html要素にlang属性を付けないページとして生成します。

This page contains Japanese text, but the html lang attribute is missing.

確認観点

  • axeのhtml-has-langとhtml-lang-valid結果を確認する
  • html要素にページの主要言語を表すlang属性を設定する
  • 日本語ページではlang="ja"など、有効なBCP 47言語タグを使う
  • ページの主要言語と異なるlang値が設定されていないか確認する

人の判断が必要な例

  • スクリーンリーダーでページを読み上げたとき、主要言語に合った発音になるか確認する
  • 多言語サイトで、ページごとに正しいlang値へ切り替わるか確認する
  • lang属性をbodyやmetaだけに設定して十分と判断していないか確認する

補助ツール候補

  • html-has-lang
  • html-lang-valid

生成メモ

manual-judgment-catalog.ja.json の内容から生成しています。