Core Web VitalsのCLSは「もっと見る」のずれを数えるか
「もっと見る」ボタンを押して増えた要素が、その下のボタンやフッターを押し下げても、押してから 0.5秒以内のずれなら Core Web Vitals の CLS(Cumulative Layout Shift)には数えられません。0.5秒を過ぎてから起きたずれは、同じ大きさでもそのまま数えられます。検証したページでは、続きの取得に 0.4秒かかったときの CLS は 0、0.5秒かかったときは 0.1298 でした。商品一覧や記事一覧に「もっと見る」(Load more)ボタンを置いて続きを読み足すページで、CLS が上がるかどうかを見分けるための記事です。
検証環境は Ubuntu 24.04、Node.js 22、web-vitals 5.3.0、Lighthouse 13.6.0 です。ブラウザは Playwright 1.63.0 に入っている Chrome for Testing 153 を使いました。検証用のページは、検証環境で動かした小さなサーバー(localhost:8080)から配っています。続きの取得にかかる時間は、サーバーが応答を遅らせて作りました。画面は幅 412px・高さ 823px です。押し方はマウスのクリックと、キーボードの Enter で試しました。スマホのタップ、スクロールで自動的に読み足す作り(無限スクロール)、Lighthouse の通常の測定(ナビゲーション)、実際の利用者のデータ(PageSpeed Insights のフィールドデータや Search Console)は試していません。
検証に使ったページ
ヘッダーと見出しの下に、記事のカードが 3枚、「もっと見る」ボタン、フッターと続くページです。ボタンを押すと、カードを 3枚(1枚の高さは 112px)足します。URL の delay で、続きの取得にかかる時間を変えられるようにしました。delay を付けないときは、取得をせずにその場でカードを足します。
…
<ul id="list">
<li class="card">記事 1:猫の手で書いた記事の紹介文です。</li>
…(カードは全部で3枚)
</ul>
<button id="more">もっと見る</button>
</main>
<footer>フッター(運営者の情報など)</footer>
<script>
const params = new URLSearchParams(location.search);
const delay = params.get('delay'); // 取得にかかる時間(ms)。なければ取得せずにすぐ足す
const skeleton = params.get('skeleton'); // 押した瞬間に、仮の枠を先に足すか(short なら低い仮の枠)
…
document.getElementById('more').addEventListener('click', async () => {
if (delay === null) {
…
list.append(...makeCards(titles));
return;
}
let slots = [];
if (skeleton !== null) {
slots = [0, 1, 2].map(() => Object.assign(document.createElement('li'), { className: skeleton === 'short' ? 'card skeleton short' : 'card skeleton' }));
list.append(...slots);
}
const res = await fetch(`/items.json?from=${next}&delay=${delay}`);
const titles = await res.json();
next += titles.length;
if (skeleton !== null) slots.forEach((li, i) => { li.className = 'card'; li.textContent = titles[i]; });
else list.append(...makeCards(titles));
});
</script>
測定には、Playwright で動かすスクリプト(measure.cjs)を書きました。ページを開いて 1秒後に「もっと見る」を押し、3秒待ってから、PerformanceObserver で受け取った layout-shift のエントリーと、web-vitals の onCLS が出した CLS を表示します。出力の input+…ms は、押してからずれが起きるまでの時間です。
押してから0.5秒以内のずれは数えられなかった
まず、取得をせずにその場でカードを足した場合です。マウスで押した場合と、キーボードの Enter で押した場合を測りました。
$ node measure.cjs ":click" ":enter" "delay=300" "delay=400" "delay=500" "delay=600" "delay=800" "delay=800&skeleton" "delay=800&skeleton=short"
(取得なし) click: input at 1111ms, footer.top 569 -> 941
shift t=1113 (input+2ms) value=0.1298 hadRecentInput=true sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.0000 rating=good
(取得なし) enter: input at 1060ms, footer.top 569 -> 941
shift t=1076 (input+16ms) value=0.1309 hadRecentInput=true sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [496.390625,50]->[0,0]
web-vitals onCLS: 0.0000 rating=good
…
押した直後に、ずれが 1回起きています。動いたのはフッターとボタンで、フッターの上端は 569px から 941px に下がり、高さ 823px の画面の外に出ました。ずれの値は 0.1298(Enter では 0.1309)で、それだけ見れば CLS の「良い」の目安の 0.1 を超える大きさです。それでも web-vitals の onCLS は 0 でした。
違いは hadRecentInput=true です。web.dev の CLS の解説には、ユーザーの入力から 500ミリ秒以内に起きたレイアウトシフトは hadRecentInput が付き、CLS の計算から除外できると書かれています。この入力は、タップ、クリック、キー入力のような一回ごとの操作に限られ、スクロール、ドラッグ、ピンチでの拡大縮小は含まれません。
続きの取得に 0.3秒、0.4秒かかるようにしても、結果は同じでした。ここから下の出力は、上と同じ実行から、該当するページの行だけを抜き出したものです。
delay=300 click: input at 1076ms, footer.top 569 -> 941
shift t=1383 (input+307ms) value=0.1298 hadRecentInput=true sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.0000 rating=good
delay=400 click: input at 1082ms, footer.top 569 -> 941
shift t=1488 (input+406ms) value=0.1298 hadRecentInput=true sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.0000 rating=good
0.5秒を過ぎると、同じずれがそのまま数えられた
取得に 0.5秒以上かかるようにすると、ずれの大きさは同じ 0.1298 のまま、hadRecentInput が false になり、CLS に入りました。
delay=500 click: input at 1086ms, footer.top 569 -> 941
shift t=1594 (input+508ms) value=0.1298 hadRecentInput=false sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.1298 rating=needs-improvement
delay=600 click: input at 1077ms, footer.top 569 -> 941
shift t=1684 (input+607ms) value=0.1298 hadRecentInput=false sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.1298 rating=needs-improvement
delay=800 click: input at 1073ms, footer.top 569 -> 941
shift t=1881 (input+808ms) value=0.1298 hadRecentInput=false sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.1298 rating=needs-improvement
CLS は 0.1298 で、web-vitals の評価は needs-improvement(改善が必要)でした。web.dev の解説で「良い」とされるのは 0.1 以下です。web-vitals 5.3.0 の中でも、境目は CLSThresholds = [0.1, 0.25] と決められています。ボタンを押したのは同じでも、続きが届くのが遅いだけで、このページは「良い」から外れました。
| 押してからずれまで | hadRecentInput | web-vitals の CLS |
|---|---|---|
| 2ms(取得なし、クリック) | true | 0 |
| 16ms(取得なし、Enter) | true | 0 |
| 307ms(取得に0.3秒) | true | 0 |
| 406ms(取得に0.4秒) | true | 0 |
| 508ms(取得に0.5秒) | false | 0.1298 |
| 607ms(取得に0.6秒) | false | 0.1298 |
| 808ms(取得に0.8秒) | false | 0.1298 |

押した瞬間に仮の枠を足すと、0.8秒かかっても0になった
web.dev の CLS を改善する方法の解説には、「もっと見る」のようにユーザーが読み込みを始める作りにすることと、押してから 500ミリ秒以内に起きたずれは CLS に数えられないことが書かれています。取得のように 500ミリ秒を超えそうな場合は、その 500ミリ秒の間に場所を確保して、ずれを先に済ませておけば、CLS に入らないとも書かれています。
検証用のページでは、押した瞬間に、中身のない灰色のカード(card skeleton)を 3枚足しておき、取得が終わったらその中に文字を入れるようにしました。最初に載せたコードの if (skeleton !== null) の部分です。取得には 0.8秒かかるようにしてあります。
delay=800&skeleton click: input at 1080ms, footer.top 569 -> 941
shift t=1082 (input+2ms) value=0.1298 hadRecentInput=true sources=FOOTER [y,h] [569.390625,192]->[0,0], BUTTON#more [y,h] [497.390625,48]->[0,0]
web-vitals onCLS: 0.0000 rating=good
ずれは押してから 2ms 後の 1回だけで、hadRecentInput=true になり、CLS は 0 でした。0.8秒後に文字が入ったときには、カードの高さが変わらないので、ずれの記録はありません。
仮のカードを、届くカードの半分の高さ(56px)にしたページも試しました。URL に skeleton=short を付けると、仮のカードに short というクラスが付き、CSS の .card.skeleton.short { height: 56px; } で低くなります。押した瞬間のずれは数えられませんでしたが、0.8秒後に文字が入ってカードが 112px に伸びたときに、もう一度ずれが起きて、こちらは数えられました。
delay=800&skeleton=short click: input at 1073ms, footer.top 569 -> 941
shift t=1075 (input+2ms) value=0.0862 hadRecentInput=true sources=FOOTER [y,h] [569.390625,192]->[773.390625,49.609375], BUTTON#more [y,h] [497.390625,48]->[701.390625,48]
shift t=1880 (input+807ms) value=0.06 hadRecentInput=false sources=LI [y,h] [565.390625,56]->[621.390625,112], LI [y,h] [633.390625,56]->[745.390625,77.609375], FOOTER [y,h] [773.390625,49.609375]->[0,0], BUTTON#more [y,h] [701.390625,48]->[0,0]
web-vitals onCLS: 0.0600 rating=good
CLS は 0.06 で、「良い」の範囲には入っていますが、0 にはなりませんでした。仮のカードは、届くカードと同じ高さにしておく必要があります。
Lighthouseのタイムスパンでは、通信の遅さを再現して0.5秒を超えた
Lighthouse には、操作を含む一定の時間を測るタイムスパン(timespan)というモードがあります。web.dev の解説でも、操作の流れの中でレイアウトシフトが増えていないかを確かめる方法として挙げられています。既定のナビゲーションというモードは、ページの読み込み1回を調べるものなので、「もっと見る」を押したあとのずれを測るにはタイムスパンを使います。
Node.js から Lighthouse 13.6.0 のユーザーフローを動かし、測定を始めて 1秒後に「もっと見る」を押すスクリプト(flow.mjs)で測りました。取得に 0.3秒かかるページは、Playwright で測ったときは CLS が 0 でしたが、Lighthouse では 0.13 になりました。
$ node flow.mjs ":1000" "delay=300:1000:on" "delay=300:1000:off" "delay=800:1000:off" "delay=800&skeleton:1000:on" ":0:on"
(取得なし) wait=1000ms throttle=on: lighthouse 13.6.0 gatherMode=timespan screen=412x823 throttlingMethod=devtools
timespan CLS: 0 (numericValue 0.0000, score 1)
delay=300 wait=1000ms throttle=on: lighthouse 13.6.0 gatherMode=timespan screen=412x823 throttlingMethod=devtools
/items.json: 568ms
timespan CLS: 0.13 (numericValue 0.1298, score 0.82)
- body > footer score=0.1298
delay=300 wait=1000ms throttle=off: lighthouse 13.6.0 gatherMode=timespan screen=412x823 throttlingMethod=provided
/items.json: 304ms
timespan CLS: 0 (numericValue 0.0000, score 1)
…
原因は、Lighthouse が再現する通信の遅さです。Lighthouse 13.6.0 の既定の設定は、遅いモバイル回線(mobileSlow4G)を計算で見積もる方法(simulate)ですが、タイムスパンではこれが、ブラウザの通信を実際に遅らせる方法(devtools)に置き換わります。そのときにブラウザに渡す通信の遅延(requestLatencyMs)は 150 * 3.75、つまり 562.5ミリ秒です。実際に、サーバーが 0.3秒遅らせて返すようにした /items.json は 568ms かかり、ずれが 0.5秒を過ぎて数えられました。通信を遅らせない設定(throttlingMethod: 'provided')にすると、304ms で返り、CLS は 0 でした。
同じ 0.3秒のページでも、通信の遅さを再現しない設定では数えられず、遅いモバイル回線を再現すると数えられた、ということです。押した瞬間に仮のカードを足したページは、通信を遅らせた設定でも 0 でした。
delay=800&skeleton wait=1000ms throttle=on: lighthouse 13.6.0 gatherMode=timespan screen=412x823 throttlingMethod=devtools
/items.json: 809ms
timespan CLS: 0 (numericValue 0.0000, score 1)
もう一つ、測定を始めてすぐに押すと、取得をしないページでも CLS が 0.13 になりました。
(取得なし) wait=0ms throttle=on: lighthouse 13.6.0 gatherMode=timespan screen=412x823 throttlingMethod=devtools
timespan CLS: 0.13 (numericValue 0.1298, score 0.82)
- body > footer score=0.1298
Lighthouse 13.6.0 の CLS を計算する部分(core/computed/metrics/cumulative-layout-shift.js)のコメントには、画面サイズのエミュレーションを変えたときにも Chrome が had_recent_input を付けてしまうと書かれています。そのため Lighthouse は、記録の始まり(記録の中に画面サイズの変更があれば、その時点)から 500ミリ秒以内のずれを、had_recent_input が付いていても数えます。ただし、それより前に、この値が付いていないずれが1回でもあれば、数えません。タイムスパンで「もっと見る」を試すときは、測定を始めてから 500ミリ秒より長く(検証では 1秒)待って押すと、押したことによるずれだけを見られます。





