LighthouseでDOMサイズの指摘が出たときの直し方

​​Lighthouse​Core Web Vitals,CSS,HTML,パフォーマンス

Lighthouse の「DOM サイズを最適化する」(英語では Optimize DOM size)という指摘は、1ページに並べる項目の数を減らすか、CSS の content-visibility: auto で画面の外の項目の描画を後回しにすると消えます。記事一覧や商品一覧、履歴のように、同じ形の項目を何千件も1ページに並べていて、ページを開いたときのレイアウトの計算が重いときに出る指摘です。検証した 3,000 件の一覧ページでは、1ページを 20 件にして入れ子も減らすと、要素の数が 33,005 個から 87 個になり、指摘は3回とも出ませんでした。一方、件数はそのままで、項目の中の入れ子の div を減らすだけでは、要素の数が 3 分の 1 程度になっても指摘は残りました。

補足

検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)、Chrome for Testing 153 です。Lighthouse はコマンドラインから既定の設定(モバイル)で実行し、パフォーマンスのカテゴリーだけを、ページごとに3回ずつ調べました。ページは検証環境で動かした小さなサーバー(localhost:8080)から配りました。高さの測定とレポートの画面の撮影には Playwright 1.63.0 を使いました。Chrome の DevTools の Lighthouse パネルやパフォーマンス パネル、PageSpeed Insights、React などのフレームワークでの仮想スクロール(react-window など)、公開しているサイトでの動きは試していません。

Lighthouse 13 では要素の数だけでは指摘されない

この指摘は、Lighthouse 13 から中身が変わりました。Lighthouse 12 までの監査項目「Avoid an excessive DOM size」の解説には、body の中のノードが約 800 個を超えると警告、約 1,400 個を超えるとエラーにすると書かれています。同じページに、この項目は Lighthouse 13 から「Optimize DOM size」のインサイトに移ったとも書かれています。Lighthouse 13.6.0 のソースコードでも、新しい項目(dom-size-insight)は、以前の項目(dom-size)を置き換えるものとして定義されていました。

新しい項目の判定は、要素の数ではありません。Chrome の「Optimize DOM size」インサイトの解説によると、指摘になるのは、40 ミリ秒を超える大きなレイアウトか、スタイルの再計算があったときだけです。大きなレイアウトは 100 個を超えるレイアウト オブジェクト(ほぼ要素の数)を扱うもの、大きなスタイルの再計算は 300 個を超える要素に及ぶものを指します。Lighthouse 13.6.0 が使っているコード(DOMSize.js)でも、40 ミリ秒・100 個・300 個という同じ値で判定していました。そのため、要素が何万個あっても、レイアウトが 40 ミリ秒未満で終われば指摘になりません。

点数への影響もありません。Lighthouse 13.6.0 の既定の設定ファイルでは、この項目の重みは 0 です。

3,000 件の日記を1ページに並べたら

検証に使ったのは、猫の日記を 3,000 件(1日1件)並べたページです。1件ごとに、見た目に関係のない入れ子の div を何段も重ねて書きました。

html
<li><div class="card"><div class="card-inner"><div class="card-body"><div class="row"><div class="col"><span class="date">2021-01-01</span><span class="name">たま</span></div></div><div class="row"><div class="col"><p class="note">窓辺で昼寝をした</p></div></div></div></div></div></li>

Lighthouse を実行し、結果の JSON から、点数と指標、この項目の結果を小さなスクリプト(summarize.mjs)で抜き出しました。--save-assets で保存したトレースからは、40 ミリ秒以上かかった大きなレイアウトとスタイルの再計算を、DOMSize.js と同じしきい値(40 ミリ秒・100 個・300 個)で別のスクリプト(events.mjs)で拾っています(最後の行の large updates)。--quiet を付けた Lighthouse 自体は何も表示しないので、下の出力は2つのスクリプトのものです。記事に載せた15回では、このスクリプトが大きなレイアウトを拾った回にだけ、Lighthouse の指摘が出ました(informative)。拾わなかった回は numeric でした。

console
$ npx lighthouse http://localhost:8080/before/ --only-categories=performance --save-assets --output=json --output=html --output-path=./out/before-2 --chrome-flags="--headless=new --no-sandbox" --quiet
$ node summarize.mjs out/before-2.report.json
lighthouseVersion: 13.6.0  requestedUrl: http://localhost:8080/before/
performance score: 97
FCP: 0.6 s (score 1)  LCP: 0.6 s (score 1)  SI: 0.7 s (score 1)  TBT: 190 ms (score 0.91)  CLS: 0 (score 1)
dom-size-insight: score=1 scoreDisplayMode=informative title="Optimize DOM size" numericValue=33005 metricSavings={"INP":0}
  - Total elements: 33005
  - DOM depth: 9  (<span class="date">)
  - Most children: 3000  (<ul>)
$ node events.mjs out/before-2-0.trace.json
large updates (>=40ms): Layout 63.1ms dirtyObjects=37457

要素は全部で 33,005 個、いちばん深い要素は 9 段目、子の数がいちばん多いのは 3,000 件の日記を持つ <ul> です。このときは 63.1 ミリ秒かかったレイアウトがあり、指摘が出ました(scoreDisplayMode=informative)。日本語の表示(--locale=ja)では、項目の名前は「DOM サイズを最適化する」、表の行は「合計要素数」「DOM の深さ」「子の最大数」と出ます。

HTML のレポートでは、「Insights」の欄に灰色の丸の項目として出ました。「Unscored」と書かれているとおり、点数には入りません。

LighthouseのレポートでOptimize DOM sizeの項目を開いた画面。灰色の丸とUnscoredの表示があり、表にTotal elementsが33,005、DOM depthが9、Most childrenが3,000と並んでいる
直す前のレポート。灰色の丸で出る

ただし、同じページでも毎回出るとは限りません。記事に結果を載せた3回のうち1回は、いちばん長いレイアウトが 35.2 ミリ秒で、指摘になりませんでした(large updates (>=40ms): none)。その前に同じ手順で試した3回は、3回とも出ています。合わせると6回中5回で、指摘が出た回の大きなレイアウトは 45.6〜63.1 ミリ秒でした。このページのように、35.2〜63.1 ミリ秒と 40 ミリ秒をまたぐと、実行するたびに結果が変わりました。

入れ子の div を減らすだけでは消えなかった

まず、件数は 3,000 件のまま、1件ごとの入れ子を減らしました。同じ CSS のクラスを使い、li と中の3つの要素だけで書きます。

html
<li class="card"><span class="date">2021-01-01</span><span class="name">たま</span><p class="note">窓辺で昼寝をした</p></li>

要素の数は 33,005 個から 12,005 個に、深さは 9 段から 4 段になりました。それでも指摘は、記事に結果を載せた3回と、その前に試した3回の、6回とも出ました。

console
lighthouseVersion: 13.6.0  requestedUrl: http://localhost:8080/flat/
performance score: 99
FCP: 0.6 s (score 1)  LCP: 0.6 s (score 1)  SI: 0.7 s (score 1)  TBT: 140 ms (score 0.95)  CLS: 0 (score 1)
dom-size-insight: score=1 scoreDisplayMode=informative title="Optimize DOM size" numericValue=12005 metricSavings={"INP":0}
  - Total elements: 12005
  - DOM depth: 4  (<span class="date">)
  - Most children: 3000  (<ul>)
large updates (>=40ms): Layout 48.5ms dirtyObjects=24008

40 ミリ秒を超えたレイアウトは 48.5〜72.6 ミリ秒でした。このページでは、1件あたりの要素を減らしても、3,000 件をまとめてレイアウトする時間は 40 ミリ秒を下回りませんでした。入れ子を減らすことは公式の解説にも直し方として挙がっていますが、このページでは、それだけでは足りませんでした。

1ページに出す件数を減らす

次に、入れ子を減らした書き方のまま、1ページに出す日記を 20 件にし、最後に「次の20件」のリンクを置きました。リンク先の2ページ目(./page/2/)も別の HTML として用意しています。

html
<li class="card"><span class="date">2021-01-20</span><span class="name">しろ</span><p class="note">ごはんを全部食べた</p></li>
</ul>
<p><a href="./page/2/">次の20件</a></p>

要素の数は 87 個になり、40 ミリ秒を超えるレイアウトはなくなりました。指摘は3回とも出ていません。

console
lighthouseVersion: 13.6.0  requestedUrl: http://localhost:8080/paged/
performance score: 100
FCP: 0.6 s (score 1)  LCP: 0.6 s (score 1)  SI: 0.6 s (score 1)  TBT: 10 ms (score 1)  CLS: 0 (score 1)
dom-size-insight: score=1 scoreDisplayMode=numeric title="Optimize DOM size" numericValue=87 metricSavings={"INP":0}
  - Total elements: 87
  - DOM depth: 4  (<span class="date">)
  - Most children: 20  (<ul>)
large updates (>=40ms): none

レポートでは、この項目は緑の丸になり、「Passed audits」(合格した項目)の欄に移りました。

LighthouseのレポートでOptimize DOM sizeの項目に緑の丸が付き、表にTotal elementsが87、DOM depthが4、Most childrenが20と並んでいる画面
1ページを20件にした後のレポート。緑の丸で出る

Lighthouse 12 までの監査項目の解説にも、最初の表示で見えない要素は最初に読み込む HTML から外し、スクロールやボタンのクリックなど、必要になったときに作るという直し方が書かれています。ページを分ける代わりに「もっと見る」のボタンで続きを足す作りにするのも、この考え方です。

全件を1ページに残すなら content-visibility を使う

全件を1ページに置いたまま、ブラウザーの「ページ内検索」で探せるようにしておきたいときは、CSS の content-visibility: auto が使えます。MDN の content-visibility の解説によると、auto を指定した要素は、画面から遠いあいだは中身の描画が省かれます。省かれた中身も DOM とアクセシビリティツリーには残り、ページ内検索やタブキーでの移動の対象になります。

直す前のページ(入れ子の多いもの)の .card に、次の1行を足しました。contain-intrinsic-size は、描画を省いているあいだに使う仮の高さです。

css
.card { content-visibility: auto; contain-intrinsic-size: auto 52px; }

要素の数は 33,005 個のままですが、40 ミリ秒を超えるレイアウトはなくなり、指摘は3回とも出ませんでした。CLS も 0 です。

console
lighthouseVersion: 13.6.0  requestedUrl: http://localhost:8080/cv/
performance score: 100
FCP: 0.6 s (score 1)  LCP: 0.6 s (score 1)  SI: 0.6 s (score 1)  TBT: 20 ms (score 1)  CLS: 0 (score 1)
dom-size-insight: score=1 scoreDisplayMode=numeric title="Optimize DOM size" numericValue=33005 metricSavings={"INP":0}
  - Total elements: 33005
  - DOM depth: 9  (<span class="date">)
  - Most children: 3000  (<ul>)
large updates (>=40ms): none

仮の高さに padding と border を含めると CLS が悪くなる

仮の高さを、padding と border を含めた日記1件の高さの 70px にしたページも試しました。このときも指摘は3回とも消えましたが、CLS(レイアウトのずれ)が3回とも 0.138 になり、点数は 94〜95 に下がりました。

console
lighthouseVersion: 13.6.0  requestedUrl: http://localhost:8080/cv-70/
performance score: 95
FCP: 0.6 s (score 1)  LCP: 0.6 s (score 1)  SI: 0.6 s (score 1)  TBT: 50 ms (score 1)  CLS: 0.138 (score 0.79)

トレースに残った LayoutShift の記録を、node -e の小さなスクリプトで抜き出しました。画面の下のほうの日記が、高さ 88px で並んだ後に、実際の高さの 70px に縮んでいました。

console
LayoutShift score=0.1378737988925575 old h=88 -> new h=70, old h=88 -> new h=70, old h=88 -> new h=70, old h=88 -> new h=70, old h=88 -> new h=70

88px は、仮の高さの 70px に、上下の padding(8px ずつ)と border(1px ずつ)を足した値です。contain-intrinsic-size に書く高さは、padding と border を除いた中身の高さとして扱われていました。

日記1件の高さは、Lighthouse と同じ Chrome を、Lighthouse のモバイルの設定(幅 412px、高さ 823px、deviceScaleFactor 1.75)に合わせて Playwright で開いて測りました。

console
$ node measure.cjs
chrome 153.0.8010.12: card heights (all cards, distinct values)=70px box-sizing=content-box computed height=52px padding=8px 8px border=1px 1px
before: document height=234126px
cv-70: document height=287676px
cv: document height=234126px

日記1件の高さは、padding と border を含めて 70px、中身だけで 52px でした。仮の高さを 52px にすると、開いた直後のページ全体の高さが、content-visibility を使わないページ(before)と同じ 234,126px になりました。70px のときは 287,676px で、そのぶん長くなっています。

注意

contain-intrinsic-size には、実際の画面で測った中身の高さ(padding と border を除いた高さ)を書きます。DOM サイズの指摘が消えたことだけで終わらせず、CLS も確かめます。

高さは、Playwright でのブラウザーの起動のしかたによっても変わりました。Playwright の chromium.launch() を既定のまま使って測ると、日記1件は 64px(中身 46px)でした。日記 2,000 件のページで先に 46px を試すと、CLS は3回とも 0.047 でした。Lighthouse が起動したのと同じ Chrome の実行ファイルを executablePath に指定して測り直した値が、上の 52px です。なお、MDN の contain-intrinsic-size の解説によると、要素が最初に描画されるまでは、ここに書いた長さが使われます。

試した直し方の比較

ページごとの、記事に結果を載せた3回の結果です。

ページ 合計要素数 DOM の深さ 指摘が出た回数 CLS
直す前(3,000 件、入れ子が多い) 33,005 9 3回中2回 0
入れ子を減らした(3,000 件) 12,005 4 3回中3回 0
1ページを 20 件にした(入れ子も減らした書き方) 87 4 3回中0回 0
content-visibility(仮の高さ 70px) 33,005 9 3回中0回 0.138
content-visibility(仮の高さ 52px) 33,005 9 3回中0回 0

Lighthouse 13 のこの指摘は、要素の数を数えた結果ではなく、ページを開いたときのレイアウトやスタイルの計算にかかった時間を見ています。表のとおり、要素の数を減らしても計算の時間が 40 ミリ秒を下回らなければ指摘は残り、要素の数が同じでも、一度に計算する量が減れば指摘は消えました。

​Posted by 86