Lighthouseでhtmlにlang属性がないときの直し方

​​Lighthouse​HTML,アクセシビリティ,トラブルシュート

Lighthouse のアクセシビリティの監査で「<html> element does not have a [lang] attribute」(日本語のレポートでは「<html> 要素に [lang] 属性が指定されていません」)と出るのは、ページの言語が HTML に書かれていないためです。日本語のページなら、<html> の開始タグを <html lang="ja"> にすれば指摘は消えます。スクリーンリーダーにページを正しい言語で読み上げてもらうための設定です。

私は検証環境で、lang のないページに Lighthouse を実行して指摘が出ることと、lang="ja" を書くと消えることを確かめました。あわせて、lang="jp" や lang="ja_JP" のような書き間違い、meta タグや HTTP ヘッダーで言語を伝えた場合も試しています。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Lighthouse 13.6.0(npm で入れた CLI。中で使われている axe-core は 4.14.0)、ブラウザは Google Chrome for Testing 153 のヘッドレスです。アクセシビリティの項目だけ(--only-categories=accessibility)を、初期設定のモバイル向けの条件で実行しました。ページは検証環境で作り、127.0.0.1 から配信しました。Chrome の DevTools の Lighthouse パネルや PageSpeed Insights、実際のスクリーンリーダーでの読み上げは試していません。

指摘が出るページ

検証に使ったのは、見出しと段落が1つずつあるだけの日本語のページです。<html> に lang を書いていません。

html
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>lang の検証(直す前)</title>
</head>
<body>
<main>
<h1>今日の猫</h1>
<p>窓辺で寝ているところです。</p>
</main>
</body>
</html>

このページを python3 -m http.server で配信し、次のように Lighthouse を実行しました。

bash
npx lighthouse http://127.0.0.1:8000/bad.html \
  --only-categories=accessibility \
  --output=json --output=html --output-path=./out/bad \
  --chrome-flags="--headless=new --no-sandbox" --quiet

HTML のレポートでは、この指摘は「INTERNATIONALIZATION AND LOCALIZATION」の欄に出ました。この指摘を開くと、<html> が「Failing Elements」に並んでいます。

Lighthouse のレポートで「<html> element does not have a [lang] attribute」を開いた画面。説明文の下の Failing Elements に html 要素が1つ並ぶ
lang のないページのレポート。html 要素が指摘される

説明によると、ページに lang 属性がないと、スクリーンリーダーは利用者が設定した既定の言語でページが書かれていると見なします。そのため、実際の言語が違うと、文章を正しく読み上げられないことがあります。

JSON のレポートから、アクセシビリティの点数と、言語に関わる4つの監査の結果を取り出すと次のとおりです。

text
accessibility score: 85
[html-has-lang] weight=7 score=0 (binary)
  title: `<html>` element does not have a `[lang]` attribute
  - html | <html>
      Fix any of the following:
        The <html> element does not have a lang attribute
[html-lang-valid] weight=0 score=null (notApplicable)
  title: `<html>` element has a valid value for its `[lang]` attribute
[html-xml-lang-mismatch] weight=0 score=null (notApplicable)
  title: `<html>` element has an `[xml:lang]` attribute with the same base language as the `[lang]` attribute.
[valid-lang] weight=0 score=null (notApplicable)
  title: `[lang]` attributes have a valid value
failed accessibility audits: html-has-lang

不合格になったのは html-has-lang の1つだけです。ほかの3つは、<html> の lang の値、lang と xml:lang の食い違い、<html> 以外の要素の lang を調べる監査です。このページには調べる対象がないので「該当なし」(notApplicable)になりました。判定は、Lighthouse が中で使っている axe-core の html-has-lang のルールで決まります。

html に lang="ja" を書く

直すのは開始タグの1か所だけです。

html
<html lang="ja">

同じ条件で Lighthouse を実行し直すと、html-has-lang が合格し、点数は100になりました。

text
accessibility score: 100
[html-has-lang] weight=7 score=1 (binary)
  title: `<html>` element has a `[lang]` attribute
[html-lang-valid] weight=7 score=1 (binary)
  title: `<html>` element has a valid value for its `[lang]` attribute
[html-xml-lang-mismatch] weight=0 score=null (notApplicable)
  title: `<html>` element has an `[xml:lang]` attribute with the same base language as the `[lang]` attribute.
[valid-lang] weight=0 score=null (notApplicable)
  title: `[lang]` attributes have a valid value
failed accessibility audits: (none)

lang を書いたことで、値が正しいかを調べる html-lang-valid も計算の対象になり、こちらも合格しています。lang の値は、MDN の lang 属性のページにあるとおり、BCP 47 の言語タグで書きます。日本語は ja です。

値を書き間違えると別の指摘が出る

lang を書いても、値が正しくないと html-lang-valid の監査で「<html> element does not have a valid value for its [lang] attribute.」と出ます。値だけを変えたページで、次の結果になりました。

<html> の書き方 不合格になった監査 点数
lang なし html-has-lang 85
lang=""(空) html-has-lang 85
lang="jp" html-lang-valid 87
lang="japanese" html-lang-valid 87
lang="ja_JP" html-lang-valid 87
lang="ja" なし 100
lang="ja-JP" なし 100
Lighthouse のレポートで「<html> element does not have a valid value for its [lang] attribute.」を開いた画面。Failing Elements に html lang="jp" が並ぶ
lang="jp" のページのレポート。値が正しくないと指摘される

lang="jp" の理由は「Value of lang attribute not included in the list of valid languages」でした。axe-core は、lang の値の最初の部分(- より前)を、axe-core が持っている言語コードの一覧と照らし合わせます。この一覧は ISO 639-1/2 の言語コードで、日本語は ja です。jp も japanese も一覧にないので不合格になりました。

ja_JP のように _ でつないだ書き方も不合格でした。axe-core は言語の部分を - で区切って取り出すので、_ でつなぐと、小文字にした ja_jp 全体が1つの言語コードとして扱われ、一覧にないと判定されます。地域まで書きたいときは ja-JP のようにハイフンでつなぎます。

lang="" は、lang を書いていないのと同じ扱いになりました。axe-core の has-lang のチェックは、値が空白だけのときも lang がないと見なします。MDN にも、値を空文字にすると言語は「不明」になる、と書かれています。

一方で、日本語のページに lang="en" と書いても、点数は100でした。Lighthouse が調べるのは値が言語コードとして正しいかどうかで、ページの文章がその言語で書かれているかは見ていません。日本語のページなら ja を書いてください。

meta タグや HTTP ヘッダーでは消えない

MDN の lang 属性のページには、祖先の要素に言語の指定がない場合は、<meta http-equiv="content-language"> や HTTP の Content-Language ヘッダーでも言語を指定できる、とあります。そこで、lang のないページで次の2つを試しました。

  • <head> に <meta http-equiv="content-language" content="ja"> を入れる
  • サーバーが Content-Language: ja のヘッダーを付けて返す

どちらも html-has-lang は不合格のままで、点数は85でした。axe-core の has-lang のチェックが見るのは、<html> の lang 属性と xml:lang 属性だけです。Lighthouse の指摘を消すには、<html> に lang を書く必要があります。

開始タグには lang を書かず、ページの中の <script> で document.documentElement.lang = "ja" と後から付けたページでも試しました。この場合は合格し、点数は100でした。開始タグに書いていなくても、Lighthouse が調べた時点で <html> に lang が付いていれば、合格になります。

ページの一部だけ別の言語にするとき

日本語のページの中に英語の段落を入れるときは、その段落に lang を書きます。ここで値を書き間違えると、<html> とは別の valid-lang の監査で指摘されます。<p lang="english">The cat is sleeping.</p> を入れたページでは、点数は89でした。

text
[valid-lang] weight=7 score=0 (binary)
  title: `[lang]` attributes do not have a valid value
  - body > main > p | <p lang="english">
      Fix all of the following:
        Value of lang attribute not included in the list of valid languages

<p lang="en"> に直すと合格し、点数は100になりました。

<html> に xml:lang も書いている場合は、<html lang="ja" xml:lang="en"> のように2つの言語が食い違うと、html-xml-lang-mismatch の監査で不合格になり、点数は95でした。xml:lang を消すか、lang と同じ値にそろえます。

点数がいくつ下がるか

Lighthouse 13.6.0 の既定の設定ファイル(default-config.js)では、アクセシビリティの点数での重みは、html-has-lang、html-lang-valid、valid-lang が7、html-xml-lang-mismatch が3です。

アクセシビリティの点数は、計算の対象になった監査の重みのうち、合格した分の割合です。検証のページは中身が少ないので、対象になった監査の重みは合計47でした。lang がないと、そこから html-has-lang の7を失って40になり、点数は85です(40÷47)。点数は重みの割合で計算されるので、重みの合計が大きいページほど、同じ7を失っても下がる点数は小さくなります。lang="jp" のときに87と少し高いのは、html-lang-valid が計算の対象に加わり、重みの合計が54、得点が47になるためです。

​Posted by 86