Lighthouseでhtmlにlang属性がないときの直し方
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 を書いていません。
<!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 を実行しました。
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つ並ぶ](https://neko-note.org/wp-content/uploads/2026/11/lighthouse-html-lang-html-has-lang.png)
説明によると、ページに lang 属性がないと、スクリーンリーダーは利用者が設定した既定の言語でページが書かれていると見なします。そのため、実際の言語が違うと、文章を正しく読み上げられないことがあります。
JSON のレポートから、アクセシビリティの点数と、言語に関わる4つの監査の結果を取り出すと次のとおりです。
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 lang="ja">
同じ条件で Lighthouse を実行し直すと、html-has-lang が合格し、点数は100になりました。
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" が並ぶ](https://neko-note.org/wp-content/uploads/2026/11/lighthouse-html-lang-html-lang-valid.png)
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でした。
[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になるためです。





