YouTubeの埋め込みで、Core Web VitalsのCLSを悪くしない方法

​​Core Web Vitals​CSS,iframe,Lighthouse,Playwright,web-vitals

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 の埋め込みの例として載っています。

html
<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 に広がりました。スマホで横にスクロールできてしまう状態です。

console
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 になりました。

css
.embed iframe { width: 100%; height: auto; }
console
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 ですが、動画は横長につぶれた箱に入ります。

幅412pxの画面を2つ縦に並べた画像。上はwidth: 100%; height: auto;だけのページで、ダミーの動画プレーヤーが横長につぶれ、下の段落の上端は390px。下はaspect-ratio: 16 / 9;を足したページで、プレーヤーが16:9の大きさになり、下の段落の上端は453px
height: auto だけでは iframe の高さが 150px になり、aspect-ratio を足すと 16:9 になる

埋め込みを 16:9 のまま幅いっぱいに表示する CSS の書き方は、既存の記事「CSSで、埋め込み動画を16:9のまま幅いっぱいに表示する方法」で詳しく扱っています。

読み込み後にスクリプトで高さを直すと、本文が動く

つぶれた高さを直すために、読み込みが終わってから JavaScript で高さを計算して入れる書き方もあります。width: 100% にした iframe(高さは属性の 315px)に、ページの load のあとで幅の 9/16 の高さを入れてみました。

js
addEventListener('load', () => {
  for (const f of document.querySelectorAll('.embed iframe')) f.style.height = (f.clientWidth * 9 / 16) + 'px';
});
console
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 で縦横比を指定した書き方です。

css
.embed iframe { width: 100%; height: auto; aspect-ratio: 16 / 9; }
console
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 でした。

css
.ratio { position: relative; padding-top: 56.25%; }
.ratio iframe { position: absolute; inset: 0; width: 100%; height: 100%; }
console
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 の高さに入れます。

js
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 です。

console
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
幅412pxの画面を2つ縦に並べた画像。上は投稿の中身が届く前で、埋め込みは高さ150pxの空白、下の段落の上端は390px。下は中身の高さが届いた後で、高さ480pxのダミーの投稿が表示され、下の段落の上端は720pxまで押し下げられている
投稿の高さが届くと、埋め込みの下の段落が 390px から 720px へ下がる

web.dev の CLS を改善する方法の解説では、後から入る内容の場所を最初から空けておくよう勧めています。大きさが決まらない内容には、使われる大きさのうち最も小さいものを空け、それより大きい内容のずれは受け入れる考え方も書かれています。そこで、実際の高さより小さく見積もった例として、iframe に先に height: 400px を付けておき、その iframe に 480px の投稿が届いたときの動きを測りました。

css
.embed iframe.post { width: 100%; height: 400px; }
console
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 でクリックしました。

js
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);
});
console
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 でした。

console
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 から除かれます。ただし、読者から見れば、押した場所の下の本文が動くことには変わりありません。ボタンもプレーヤーと同じ縦横比にしておくと、押したあとも本文は動きません。

​Posted by 86