YouTubeの埋め込みで、Core Web VitalsのCLSを悪くしない方法
YouTube の動画や SNS の投稿を iframe で埋め込むときは、ページを開いた時点で iframe の高さを決めておけば、Core Web Vitals の CLS(Cumulative Layout Shift)を悪くしません。検証したページでは、横幅を画面に合わせた iframe に CSS の aspect-ratio: 16 / 9 を付けると CLS は 0 でした。同じ iframe の高さを読み込み後にスクリプトで直すと 0.0484、中身の高さを後から知らせてくる投稿の埋め込みでは 0.1586 です。ブログの記事に動画や投稿を埋め込んだら本文がずれる、スマホで動画がはみ出す、といったときの、埋め込みの大きさの決め方をまとめます。
この環境からは YouTube などの埋め込み先に接続できないため、本物の埋め込みの代わりに、別のオリジン(127.0.0.1:8081)から1秒遅れて返すダミーのページで試しています。動画の埋め込みは、黒い四角に「検証用のダミーの動画プレーヤー」と出すだけのページです。投稿の埋め込みは、読み込まれると自分の高さ(480px)を親のページに postMessage で知らせるページで、親のページはその値を iframe の高さに入れます。本物のプレーヤーやウィジェットのスクリプト、埋め込みの中で起きるずれは試していません。web.dev の CLS を改善する方法の解説によると、iframe の中で起きるずれは Web API では測れず、web-vitals などの値には出ませんが、Chrome の利用者のデータ(CrUX)には含まれます。検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0、web-vitals 5.3.0 で、ブラウザは Playwright 1.63.0 に入っている Chrome for Testing 153 です。CLS は、Playwright で幅 412px・高さ 823px の画面を開き、読み込みが終わってから3秒待った値と、Lighthouse をコマンドラインから既定の設定(モバイル、同じ 412×823)で実行した値です。実際の利用者のデータ(PageSpeed Insights のフィールドデータや Search Console)は見ていません。
試した書き方と CLS
検証用のページは、見出しと6つの段落のあいだに、埋め込みを1つ置いたものです。本文の幅は 380px です。動画の埋め込みには、YouTube の埋め込みコードと同じ形(width="560" height="315" の属性付き)の iframe を使いました。この形は、web.dev の埋め込みのベストプラクティスに、YouTube の埋め込みの例として載っています。
<div class="embed"><iframe width="560" height="315" src="http://127.0.0.1:8081/player.html" title="動画プレーヤー" frameborder="0" allowfullscreen></iframe></div>
結果を先に並べます。Playwright の値は web-vitals の onCLS です。
| 書き方 | iframe の大きさ(HTML を読み終えた時点 → 3秒後) | Playwright の CLS | Lighthouse の CLS |
|---|---|---|---|
| 埋め込みコードのまま | 560×315 → 560×315 | 0 | 0 |
width: 100% だけ |
380×315 → 380×315 | 0 | — |
width: 100%; height: auto |
380×150 → 380×150 | 0 | 0 |
width: 100% にして、読み込み後にスクリプトで高さを直す |
380×315 → 380×213.75 | 0.0484 | 0.048 |
width: 100%; height: auto; aspect-ratio: 16 / 9 |
380×213.75 → 380×213.75 | 0 | 0 |
padding-top: 56.25% の箱に入れる |
380×213.75 → 380×213.75 | 0 | 0 |
| 投稿の埋め込み、高さを空けない | 380×150 → 380×480 | 0.1586 | 0.159 |
| 投稿の埋め込み、400px を空けておく | 380×400 → 380×480 | 0.0175 | 0.018 |
CLS が 0 でも、見た目に問題のある書き方があります。次の節から、1つずつ見ていきます。
埋め込みコードのままだと、ずれないが画面からはみ出す
埋め込みコードをそのまま貼ったページは、iframe が最初から 560×315 で、CLS は 0 でした。ただし、幅 412px の画面に 560px の iframe が入らず、ページの横幅(scrollWidth)が 576px に広がりました。スマホで横にスクロールできてしまう状態です。
attrs: iframe 560x315 -> iframe 560x315, next.top 554.640625 -> 554.640625, scrollWidth 576 -> 576
layout-shift entries: []
web-vitals onCLS: 0.0000 rating=good
出力の next.top は、埋め込みのすぐ下の段落の上端の位置です。HTML を読み終えた時点と3秒後で変わっていません。
横幅を width: 100% で画面に合わせると、はみ出しはなくなります。しかし高さは属性の 315px のままなので、iframe は 380×315 になり、16:9 より縦に長い箱になりました。
検証した Chrome では、iframe の width と height の属性から縦横比が決まらなかった
画像なら、width と height の属性を書いておき、CSS で width: 100%; height: auto にすれば、属性の比率で高さが決まります。web.dev の CLS を改善する方法の解説にあるとおり、ブラウザが属性から既定の縦横比を作るためです。
同じ CSS を iframe に付けたところ、高さは 150px になりました。
.embed iframe { width: 100%; height: auto; }
width100-auto: iframe 380x150 -> iframe 380x150, next.top 389.640625 -> 389.640625, scrollWidth 412 -> 412
layout-shift entries: []
web-vitals onCLS: 0.0000 rating=good
150px は、MDN の iframe の解説にある、height 属性を書かなかったときの既定の高さと同じです。検証した Chrome では、width="560" height="315" の属性から縦横比は作られず、高さは 16:9 の 213.75px ではなく、150px になりました。ずれは起きないので CLS は 0 ですが、動画は横長につぶれた箱に入ります。

埋め込みを 16:9 のまま幅いっぱいに表示する CSS の書き方は、既存の記事「CSSで、埋め込み動画を16:9のまま幅いっぱいに表示する方法」で詳しく扱っています。
読み込み後にスクリプトで高さを直すと、本文が動く
つぶれた高さを直すために、読み込みが終わってから JavaScript で高さを計算して入れる書き方もあります。width: 100% にした iframe(高さは属性の 315px)に、ページの load のあとで幅の 9/16 の高さを入れてみました。
addEventListener('load', () => {
for (const f of document.querySelectorAll('.embed iframe')) f.style.height = (f.clientWidth * 9 / 16) + 'px';
});
js-fit: iframe 380x315 -> iframe 380x213.75, next.top 554.640625 -> 453.390625, scrollWidth 412 -> 412
layout-shift entries: [{"t":1024,"value":0.0484,"hadRecentInput":false,"sources":["P top 554.640625->453.390625",…]}]
web-vitals onCLS: 0.0484 rating=good
iframe の中身が届くのを待つため、load は約1秒後になり、そこで高さが 315px から 213.75px に縮みました。下の段落は 554px から 453px へ、約 101px 上に動き、CLS は 0.0484 です。Lighthouse でも 0.048 でした。web.dev の CLS の解説では 0.1 以下を「良い」としているので、ページの中のずれがこの1回だけなら、0.1 以下に収まります。
aspect-ratio で、開いた時点から 16:9 の高さにする
ずれもつぶれも起きなかったのは、CSS の aspect-ratio で縦横比を指定した書き方です。
.embed iframe { width: 100%; height: auto; aspect-ratio: 16 / 9; }
aspect: iframe 380x213.75 -> iframe 380x213.75, next.top 453.390625 -> 453.390625, scrollWidth 412 -> 412
layout-shift entries: []
web-vitals onCLS: 0.0000 rating=good
iframe は開いた直後から 380×213.75 で、中身が届いても大きさは変わらず、CLS は 0 でした。Lighthouse でも 0 です。MDN の aspect-ratio の解説によると、aspect-ratio が効くのは、幅と高さの少なくとも一方が自動で決まる場合です。そのため、height: auto と組み合わせています。
aspect-ratio を使わずに、padding-top: 56.25%(9 ÷ 16)の箱に iframe を重ねる書き方も試しました。箱の高さは 213.75px で、CLS は 0 でした。
.ratio { position: relative; padding-top: 56.25%; }
.ratio iframe { position: absolute; inset: 0; width: 100%; height: 100%; }
padding: div 380x213.75 -> div 380x213.75, next.top 453.390625 -> 453.390625, scrollWidth 412 -> 412
layout-shift entries: []
web-vitals onCLS: 0.0000 rating=good
結果は同じなので、新しく書くなら、箱を1つ減らせる aspect-ratio のほうが簡単です。
高さを後から知らせる投稿の埋め込みは、先に高さを空けておく
SNS の投稿のような埋め込みは、中身によって高さが変わるので、縦横比では決められません。web.dev の埋め込みのベストプラクティスでは、大きさの属性が付いていない埋め込みコードの例として、Twitter のタイムラインが挙がっています。
ここでは、読み込まれると自分の高さ(480px)を postMessage で知らせてくるダミーの投稿を使いました。親のページは、届いた値を iframe の高さに入れます。
addEventListener('message', (e) => {
if (e.origin !== 'http://127.0.0.1:8081' || e.data?.type !== 'embed-height') return;
document.querySelector('iframe.post').style.height = e.data.height + 'px';
});
高さを何も指定しないと、iframe は既定の 150px で表示され、約1秒後に 480px に広がりました。下の段落は 390px から 720px へ、330px 下がっています。CLS は 0.1586 で、web-vitals の判定は needs-improvement(改善が必要)でした。Lighthouse でも 0.159 です。
post: iframe 380x150 -> iframe 380x480, next.top 389.640625 -> 719.640625, scrollWidth 412 -> 412
layout-shift entries: [{"t":1032,"value":0.1586,"hadRecentInput":false,"sources":["P top 389.640625->719.640625",…]}]
web-vitals onCLS: 0.1586 rating=needs-improvement

web.dev の CLS を改善する方法の解説では、後から入る内容の場所を最初から空けておくよう勧めています。大きさが決まらない内容には、使われる大きさのうち最も小さいものを空け、それより大きい内容のずれは受け入れる考え方も書かれています。そこで、実際の高さより小さく見積もった例として、iframe に先に height: 400px を付けておき、その iframe に 480px の投稿が届いたときの動きを測りました。
.embed iframe.post { width: 100%; height: 400px; }
post-reserve: iframe 380x400 -> iframe 380x480, next.top 639.640625 -> 719.640625, scrollWidth 412 -> 412
layout-shift entries: [{"t":1042,"value":0.0175,"hadRecentInput":false,"sources":["P top 639.640625->719.640625",…]}]
web-vitals onCLS: 0.0175 rating=good
足りなかった 80px の分だけ段落が下がり、CLS は 0.0175 でした。何も空けなかったときの 0.1586 から、約9分の1になっています。
クリックで iframe に差し替えるなら、クリック直後のずれは数えられない
動画の埋め込みは、最初はサムネイルのボタン(ファサード)だけを置き、押されたときに本物の iframe に差し替える方法もあります。web.dev の埋め込みのベストプラクティスで、ページの読み込みを軽くするやり方として紹介されています。
ボタンを、プレーヤーと同じ aspect-ratio: 16 / 9 で作っておき、開いて 0.5 秒後に Playwright でクリックしました。
document.querySelector('.facade').addEventListener('click', (e) => {
const f = document.createElement('iframe');
f.src = 'http://127.0.0.1:8081/player.html'; f.title = '動画プレーヤー'; f.allowFullscreen = true;
e.currentTarget.replaceWith(f);
});
facade: button 380x213.75 -> iframe 380x213.75, next.top 453.390625 -> 453.390625, scrollWidth 412 -> 412
layout-shift entries: []
web-vitals onCLS: 0.0000 rating=good
ボタンと iframe の大きさが同じなので、差し替えても何も動かず、CLS は 0 でした。
ボタンの高さを 120px にして、差し替えた iframe(16:9 で 213.75px)と大きさが違うようにしたページも測りました。クリックの直後に段落が約 94px 下がり、layout-shift の記録は残りましたが、onCLS は 0 でした。
facade-mismatch: button 380x120 -> iframe 380x213.75, next.top 359.640625 -> 453.390625, scrollWidth 412 -> 412
layout-shift entries: [{"t":577,"value":0.0507,"hadRecentInput":true,"sources":["P top 359.640625->453.390625",…]}]
web-vitals onCLS: 0.0000 rating=good
記録の hadRecentInput が true になっています。web.dev の CLS の解説によると、クリックやタップ、キー入力から 500 ミリ秒以内に起きたずれにはこの値が付き、CLS から除かれます。ただし、読者から見れば、押した場所の下の本文が動くことには変わりありません。ボタンもプレーヤーと同じ縦横比にしておくと、押したあとも本文は動きません。





