Lighthouseでmeta viewportがないときの直し方

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

Lighthouse で meta viewport がないと指摘されたときは、HTML の <head> に次の1行を入れると直ります。

html
<meta name="viewport" content="width=device-width, initial-scale=1">

この1行がないページは、スマホで開くと画面より広い幅(検証では 980px)で描かれ、画面の幅まで縮小されます。スマホで見ると文字が小さく、ページ全体が縮んで表示されるときの原因の1つです。Lighthouse の指摘は、ページがスマホの画面の幅に合わせて描かれる設定になっていないことを知らせるものです。

指摘の文言は Lighthouse のバージョンで違います。Lighthouse 12 までは「ベストプラクティス」の欄に「Does not have a <meta name="viewport"> tag with width or initial-scale」と出ます。Lighthouse 13 では「パフォーマンス」の欄のインサイトに「Optimize viewport for mobile」(日本語のレポートでは「ビューポートをモバイル向けに最適化する」)と出ます。私は検証環境で、meta viewport のないページと直したページに両方のバージョンの Lighthouse を実行し、指摘が出ることと消えることを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Lighthouse 13.6.0 と 12.8.2(npm で入れた CLI。13.6.0 の中で使われている axe-core は 4.14.0)、ブラウザは Google Chrome for Testing 153 のヘッドレスです。Lighthouse は初期設定のモバイル向けの条件(画面の幅 412px)で実行しました。ページは手元で作り、127.0.0.1 から配信しました。スマホとしての表示は、Playwright 1.63.0 でスマホの画面を再現して確かめました。Chrome の DevTools の Lighthouse パネルや PageSpeed Insights、実機のスマホでの表示は試していません。

Lighthouse 13 では、パフォーマンスのインサイトに出る

検証に使ったのは、見出しと2つの段落、ボタンだけの小さなページです。<head> には <meta charset="utf-8"> と <title>、<style> だけを入れ、meta viewport は入れていません。

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

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

検証では Chrome for Testing を使うため、環境変数 CHROME_PATH にその実行ファイルの場所(/path/to/chrome のような値)を指定してから実行しました。--no-sandbox は、検証用の環境で Chrome を起動するために付けたものです。

HTML のレポートでは、パフォーマンスの「Insights」の中に、左にオレンジの四角が付いた「Optimize viewport for mobile」が表示されました。

Lighthouse 13 のレポートで「Optimize viewport for mobile」を開いた画面。オレンジの四角と、タップ操作が最大 300 ms 遅れることがあるという説明、「Unscored」の表示が並ぶ
meta viewport のないページのレポート。パフォーマンスのインサイトに出る

JSON のレポートから、点数と関係する項目を取り出すと次のとおりです(バージョンなどの行は省いています)。

text
performance score: 100
accessibility score: 100
viewport-insight: score=0.5 | metricSavings | title=Optimize viewport for mobile
  metricSavings: {"INP":0}
meta-viewport: score=null | notApplicable | title=`[user-scalable="no"]` is not used in the `<meta name="viewport">` element and the `[maximum-scale]` attribute is not less than 5.
audit "viewport" exists: false

パフォーマンスの点数は100のままでした。レポートの「Unscored」の表示のとおり、このインサイトは点数に入りません。Lighthouse 13.6.0 の設定で、viewport-insight の重みが0になっているためです。点数が100でも、インサイトの欄に出ていれば直す対象です。

インサイトの点数が0ではなく0.5なのは、不合格でも、改善で縮む時間の見積もりがどれも0のときは、Lighthouse が点数を0.5にするためです。このインサイトは、計測中のタップが遅れた時間から、INP(操作への反応の速さの指標)がどれだけ縮むかを見積もります。ページを読み込むだけの計測ではタップがないので、INP の見積もりは0でした。レポートの説明には、ビューポートがモバイル向けに最適化されていないと、タップ操作が最大 300 ミリ秒遅れることがある、と書かれています。

最後の行の audit "viewport" exists: false は、Lighthouse 12 までの viewport という監査がレポートにないことを示しています。Lighthouse 13 の viewport-insight は、viewport の監査に置き換わるものとして作られています。Lighthouse 13.0.0 の変更履歴にも、パフォーマンスのインサイトに置き換わった監査を消したことが書かれています。

Lighthouse 12 では、ベストプラクティスの点数が下がる

同じページに Lighthouse 12.8.2 を実行すると、指摘は「ベストプラクティス」の欄に出て、点数も下がりました(どのカテゴリーに入っているかを示す行は省いています)。

text
lighthouseVersion: 12.8.2
performance score: 100
accessibility score: 100
best-practices score: 89
seo score: 90
viewport: score=0 | title=Does not have a `<meta name="viewport">` tag with `width` or `initial-scale`
  explanation: No `<meta name="viewport">` tag found

ベストプラクティスの89は、viewport のほかに、文字が小さすぎることを指摘する font-size も落ちた結果です。直したページでは96になり、残りは favicon がないことによるコンソールのエラーだけでした。Lighthouse 13 では、13.0.0 の変更履歴にあるとおり font-size の監査も削除されていて、検証でもレポートにありませんでした。

直した後の結果

<head> に <meta name="viewport" content="width=device-width, initial-scale=1"> を入れたページで、同じように実行し直しました。Lighthouse 13.6.0 の結果は次のとおりです(バージョンなどの行は省いています)。

text
performance score: 100
accessibility score: 100
viewport-insight: score=1 | numeric | title=Optimize viewport for mobile
  metricSavings: {"INP":0}
  node: <meta name="viewport" content="width=device-width, initial-scale=1"> 
meta-viewport: score=1 | binary | title=`[user-scalable="no"]` is not used in the `<meta name="viewport">` element and the `[maximum-scale]` attribute is not less than 5.

インサイトは合格(score=1)になり、レポートでは合格した項目の欄にたたまれました。Lighthouse 12.8.2 でも、viewport は合格になりました。

text
viewport: score=1 | title=Has a `<meta name="viewport">` tag with `width` or `initial-scale`

1行で、スマホでの表示がどう変わるか

width=device-width は、ページを描くときの幅(レイアウトの幅)を画面の幅に合わせる指定です。initial-scale=1 は、開いたときの拡大率を等倍にします(MDN の viewport の説明)。

Playwright でスマホの画面(幅 412px、Lighthouse のモバイル設定と同じ幅)を再現し、2つのページを開いて、レイアウトの幅と拡大率を取り出しました。pOnScreenPx は、CSS で 16px にした段落の文字が、画面上で何 px 相当に見えるかを計算した値です。

text
none.html       {"layoutWidth":980,"innerWidth":981,"scale":0.42,"pFontPx":16,"pOnScreenPx":6.7}
good.html       {"layoutWidth":412,"innerWidth":412,"scale":1,"pFontPx":16,"pOnScreenPx":16}

meta viewport がないページは、幅 980px で描かれ、0.42倍に縮小されていました。16px の文字は、画面上では 6.7px 相当です。直したページは、レイアウトの幅が画面と同じ 412px になり、文字は 16px のまま表示されました。

幅 360px のスマホとして開いた画面を並べると、違いがはっきり分かります。

幅 360px のスマホとして開いた2つのページを上下に並べた画像。上の meta viewport のないページは、見出しも本文も小さく縮んで左上に寄り、下の width=device-width, initial-scale=1 を入れたページは、文字が読める大きさで画面の幅いっぱいに並ぶ
上が meta viewport なし、下が直した後。meta viewport の1行のほかは同じ HTML と CSS

width と initial-scale はどちらか1つでもよいか

content の書き方を変えたページも用意し、両方のバージョンで試しました。

content の値 Lighthouse 13 のインサイト Lighthouse 12 の viewport スマホでのレイアウトの幅
(meta viewport なし) 不合格(0.5) 不合格 980px
width=device-width, initial-scale=1 合格 合格 412px
initial-scale=1 合格 合格 412px
width=600 不合格(0.5) 合格 600px

initial-scale=1 だけでも、レイアウトの幅は画面の幅になり、どちらのバージョンでも合格しました。

width=600 のように幅を数字で固定したページは、バージョンによって結果が分かれました。Lighthouse 12 は、width か initial-scale のどちらかが書かれていれば合格にする作りなので、合格になります。Lighthouse 13 のインサイトは、Chrome が描いた画面をモバイル向けとみなしたかどうかで判定するので、不合格になりました。実際の表示も、幅 600px で描いて 0.687 倍に縮小され、16px の文字は 11px 相当でした。

text
fixed.html      {"layoutWidth":600,"innerWidth":600,"scale":0.687,"pFontPx":16,"pOnScreenPx":11}

迷ったら、冒頭の width=device-width, initial-scale=1 をそのまま使えば、どちらのバージョンでも合格します。

拡大を禁止すると、アクセシビリティで落ちる

meta viewport を書くときに、maximum-scale=1 や user-scalable=no を足して、ピンチ操作での拡大を止めているページもあります。この書き方を試すと、viewport のインサイトは合格しましたが、アクセシビリティの meta-viewport が落ち、点数は100から86に下がりました(バージョンなどの行と、viewport のインサイトの細かい行は省いています)。

html
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
text
performance score: 100
accessibility score: 86
viewport-insight: score=1 | numeric | title=Optimize viewport for mobile
meta-viewport: score=0 | binary | title=`[user-scalable="no"]` is used in the `<meta name="viewport">` element or the `[maximum-scale]` attribute is less than 5.
  node: <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"> 
  Fix any of the following:
    user-scalable=no on <meta> tag disables zooming on mobile devices

拡大できないと、画面を拡大して読む弱視の人がページを読めなくなります。meta viewport の指摘を直すときは、user-scalable=no と maximum-scale を足さないでおくのが安全です。

監査の題名には「maximum-scale が5未満」とありますが、検証では maximum-scale=2 のページも合格しました。Lighthouse が使っている axe-core の meta-viewport の判定は、拡大の上限が2倍未満のときに落とす設定(scaleMinimum: 2)です。MDN の viewport の説明にも、WCAG が求めるのは少なくとも2倍まで拡大できることで、5倍まで拡大できるのが望ましいと書かれています。

​Posted by 86