lang属性には有効な値が必要です

ルールID: valid-lang
ルールセット: axe-core 4.10
ユーザーへの影響: 深刻
ガイドライン: WCAG 2.1 (AA), WCAG 2.0 (AA), WCAG 2.2 (AA), Trusted Tester, EN 301 549
 

Accessibility testing for dev teams - No experience required

Find and fix up to 80% of accessibility issues with axe DevTools Pro. Get started with your free trial today. No credit card needed.

Compliance Data & Impact

User Impact

深刻
Minor
Critical

Disabilities Affected

  • 視覚障害
  • 視聴覚障害
  • 認識障害

Standard(s)

  • WCAG 2.1 (AA)
  • WCAG 2.0 (AA)
  • WCAG 2.2 (AA)
  • Trusted Tester
  • EN 301 549

WCAG 達成基準 [WCAG 2.1 (AA)]

  • 3.1.2: 必須: Language of Parts

WCAG 達成基準 [WCAG 2.0 (AA)]

  • 3.1.2: 必須: Language of Parts

WCAG 達成基準 [WCAG 2.2 (AA)]

  • 3.1.2: 必須: Language of Parts

Trusted Tester Guidelines

  • 11.B: 必須: The human language for any content segment that differs from the default human language of the page can be programmatically determined.

    修正方法

    lang 属性に指定されている言語コードを有効なものにします (例 <html lang="en"> はドキュメントの言語を英語に設定します)。

    始めの <html> 要素に言語を指定すること、そして属性のスペリングが正しいことを確認してください。例えば、ドキュメントの第一言語が日本語であれば、言語を次のように指定できます:

    <html lang="ja">
        document text
    </html>    
    

    アメリカ英語を意味する "en-US" や カナダのフランス語を意味する "fr-CA" といった方言をコードで示すこともできます。言語と方言コードの一覧は、インターネットで検索できます。

    ドキュメント内で言語が切り替わる場合は、次のように指定することができます:

    <p>Text in one language <span lang="es">text in another language</span></p>

    右から左に書かれる言語を使用している場合は、必ず dir 属性を用いてそのことを指定します。

    <p lang="ar" dir="rtl">Arabic text here</p>

    左から右に書かれる言語を指定したい場合は、dir 属性の値を "ltr" と指定することができます。

    <html lang=" "> に指定されている言語コードが有効で、許可された言語コードであることを確認しましょう。

    ドキュメントの主要言語が日本語であることを指定するには、開始の <html> 要素に2文字の言語コード "ja" と記載します。

    <html lang="ja">   
    

    言語値のコードは、アメリカ英語をイギリス英語と区別する "en-US" やカナダのフランス語をヨーロッパのフランス語と区別する "fr-CA" などのいくつかの方言を含みます。言語の一覧と方言コードは ISO Codes for the Representation of Names of Languages web page で見つけることができます。

    なぜ重要なのか

    スクリーン・リーダーの設定をする際、ユーザーは既定の言語を設定します。もし web ページの言語が指定されていない場合、スクリーン・リーダーはユーザーが設定した既定の言語がそのページの言語であると見なします。複数の言語を話し、複数の言語で web サイトにアクセスするユーザーの場合、言語の選択が問題になります。Web サイトのテキストが正確に発声されるよう、言語を指定すること、そしてそれが有効であることを確認することが重要です。

    スクリーン・リーダーは言語の発音や特徴に応じて、各言語で異なる音声ライブラリーを使用します。スクリーン・リーダーは言語ライブラリーの切り替えを容易にできますが、それはドキュメントが読まれるべき言語を正しく指定していた場合のみです。言語が指定されていなければ、スクリーン・リーダーはユーザーの既定の言語でドキュメントを読み上げるため、わかりづらくなってしまいます。

    ルールの説明

    スクリーン・リーダーのユーザーに正しく発音が伝わるようにするため、HTML ドキュメントに指定する言語は有効な言語のどれかでなければなりません。

    仕組みについて (簡単に言うと)

    lang 属性は有効な値がなければなりません。

    リソース

    その他のリソース

    その他リソースもあわせてご参照ください。

    axe 4.10 ルールの一覧 を参照する

    この情報は役に立ちましたか?

    すでにフィードバックをいただきました、ありがとうございます。.

    あなたの回答は次のとおりです。

    この情報は役に立ちましたか?
    フィードバックが提出された日付/時刻: