アーティストの公式サイトを PageSpeed にかけた七月の終わり、「適切なサイズの画像」の欄に、見覚えのある作品の名前が並んでおりました。スマホでは 380×507 ほどの枠にしか出ない絵に、1108×1477 の原寸を送っていたのです。無駄と判定された転送量は 734 KiB でした。
直し方は分かっているつもりでした。幅の違う WebP を何段か作り、srcset と sizes を付けるだけです。エージェントと一緒に一通り付け終え、本番に出して開いてみると、トップの作品が一回り小さくなっておりました。縦横比を固定しようと width と height の属性を足すと、今度はヒーローの画像が横に引き伸ばされました。同じ日に、別の理由で二度崩したことになります。
どちらも、画像を「どれを読むか」の設定だと思って触った値が、実は「どう見せるか」まで決めていた、という同じ根を持っていました。そう気づいたのは、二度目の崩れを直し終えたあとでした。ここでは、その二つを手元で再現した数値と、いまの私の決め方、公開前に走らせている点検スクリプトを書き残します。
最初にお伝えしたいのは、sizes は表示の大きさも決めるということです
sizes は、ブラウザに「この画像はおよそ何 px で表示されます」と先に伝えるための値です。ブラウザはその値と画面の密度から、srcset の候補のうちどれを読むかを選びます。ここまでは多くの解説に書かれているとおりです。
あまり書かれていないのは、その先です。w 記述子の srcset で選ばれた画像は、ファイルの画素数ではなく、sizes で宣言した幅を自分の固有の幅として持ちます。CSS が width を決めていない画像は、この固有の幅で描かれます。つまり sizes を小さく見積もると、読む画像が小さくなるだけでなく、表示そのものが縮みます。
私の構成では、作品画像の大きさを max-height: 74vh や max-width の割合だけで抑え、width は書いておりませんでした。「上限は CSS が決めているのだから、sizes は少し控えめでも大丈夫」と考えたのが、一度目の崩れの原因です。手元では気づかず、本番環境で開いて初めて分かった落とし穴でした。
手元で再現した数値
再現には、自分のマシンの Playwright(Chromium・ヘッドレス)を使いました。1108×1477 の画像から 320/480/800/1108 の WebP を作り、CSS は max-height: 74vh; max-width: 90vw だけを当てた小さなページです。PC 相当(1280px・等倍)とスマホ相当(390px・3 倍)で、描画の大きさと currentSrc を読みました。
A は、CSS の上限が 444px まで許しているのに 200px で止まっています。スマホでは 3 倍の密度に合わせて 800 版をきちんと読んでいるのに、表示は 200px のままです。読み込みは正しく、見た目だけが縮むので、ネットワークの記録を見ても異常が見つかりません。
もう一つ意外だったのは、A の naturalWidth が 320 でも 800 でもなく、200 を返したことです。naturalWidth はファイルの画素数だと思い込んでいると、点検のスクリプトまで読み違えます。srcset 付きの画像では、密度で割り戻した値が返ってくるのです。
縮ませない sizes の書き方
決め方は一つだけにしました。sizes は起こりうる最大の表示幅より少し大きめに宣言し、最終的な大きさは CSS の max-* に決めさせる、です。
<!-- Before: 控えめに見積もったため、表示が 200px で止まった -->
<img
src="/works/art-1108.webp"
srcset="/works/art-320.webp 320w, /works/art-480.webp 480w,
/works/art-800.webp 800w, /works/art-1108.webp 1108w"
sizes="200px"
alt="作品の題">
<!-- After: 最大の表示幅(スマホは 90vw・PC は 444px 前後)より一段大きく宣言する -->
<img
src="/works/art-1108.webp"
srcset="/works/art-320.webp 320w, /works/art-480.webp 480w,
/works/art-800.webp 800w, /works/art-1108.webp 1108w"
sizes="(max-width: 860px) 90vw, 900px"
alt="作品の題">
大きめに宣言すると、表のとおり PC では 444px の表示に 1108 版を読むことがあります。それでも、上限だけで抑える構成ならこちらをお勧めします。一段大きい版を掴む無駄は残りますが、原寸を全員に送っていたころよりははるかに軽く、何より見た目が縮みません。私は、ここは「少し多めに読む」ほうを選んでいます。
逆に、きっちり合わせたいなら CSS の側で width を決めてしまう方法もあります。ただ、作品の縦横比がまちまちなサイトでは、width を固定すると縦長の絵が画面からはみ出します。高さで抑える構成のまま sizes を合わせ込もうとすると、画面の高さと縦横比から逆算する式になり、後で触る人が読めなくなります。
width と height を足して横に伸びたときの一行
二度目の崩れは、width と height の属性でした。読み込み前に縦横比を確定させてレイアウトのずれを防ぐための属性ですが、HTML の属性はそのまま CSS の width と height としても効きます。
max-height: 74vh だけで抑えている画像にこの属性を足すと、高さは 74vh で止まる一方、幅は属性の 1108px のまま残ります。表の C がそれで、PC では 1108×592 という、元の絵とは似ても似つかない比率になりました。
直し方は CSS に一行です。
/* 属性は付けたまま、大きさは CSS の max-* に任せる */
.hero img,
.works img {
width: auto;
height: auto; /* 属性は aspect-ratio としてだけ働く */
max-height: 74vh;
max-width: 90vw;
}
/* 枠いっぱいに内接させている箇所は、歪んでも見た目が崩れないので属性だけでよい */
.frame img {
width: 100%;
height: 100%;
object-fit: contain;
}
width: auto; height: auto を書くと、属性はブラウザ既定の aspect-ratio の材料としてだけ使われます。デコード前から縦横比は確定し、大きさは従来どおり max-height が決めます。表の D で、幅と高さが A〜B と同じ比率に戻っているのが確かめた結果です。
object-fit: contain で枠に内接させている画像は、要素の箱が歪んでも絵の見た目は崩れないので、属性を足すだけで済みました。崩れるのは「CSS で幅も高さも決めず、上限だけを書いている画像」に限られます。
額縁に縦長の絵を入れるとき、sizes は絵の幅で書きます
作品を 4:5 の額のような枠に object-fit: contain で入れている箇所では、別の無駄が残りました。縦長の作品ほど、実際に描かれる絵の幅は枠よりはるかに狭くなります。本番では 447×1800 の作品が、306px の枠の中で 106px ほどの幅にしか描かれておりませんでした。
ここで枠の幅のまま sizes="306px" と書くと、3 倍の密度のスマホでは 918px 相当が要ると判断され、原寸が選ばれます。せっかく 240 や 320 の版を用意しても使われません。手元の再現でも、390px・3 倍の条件で sizes="306px" は原寸の 447 版を選び、下の関数で絵の幅から割り出した sizes="95px" に替えると 320 版を選びました。等倍の PC なら 240 版です。
割り出し方は、枠の縦横と絵の縦横比から一行で出せます。
// 枠に contain で内接する絵の、実際の表示幅を sizes に渡す
// frameW: 枠の幅(px)、frameRatio: 枠の 高さ÷幅(4:5 の額なら 1.25)
// imgW, imgH: 作品の原寸
export function framedSizes(frameW, frameRatio, imgW, imgH) {
const aspect = imgW / imgH; // 縦長ほど小さい
const scale = Math.min(1, aspect * frameRatio); // 枠の高さで止まる割合
return `${Math.ceil(frameW * scale)}px`;
}
// 例: 306px の 4:5 枠に 447×1800 の作品
console.log(framedSizes(306, 1.25, 447, 1800)); // "95px"
// 横長の作品は枠の幅で止まるので、枠の幅そのものになる
console.log(framedSizes(306, 1.25, 1600, 1200)); // "306px"
本番の額は余白の帯がある分だけ枠の内側の比率が違い、係数は 1.25 ではなく 1.218 でした。額の内側を実際に測って係数を決めるのが確実です。要素の箱の大きさは width・height 属性と CSS で決まるので、sizes をここまで絞ってもレイアウトは一切動きません。前の節の「縮む」問題が起きないのは、枠の側が大きさを決めているからです。
なお、縦長の作品は原寸の幅そのものが小さいため、「幅を基準に 480・800…と段を作る」生成スクリプトでは小さい段が一つも作られないことがありました。320 や 240 の段を必ず作るように直してから、ようやくこの割り出しが効くようになりました。
段の数が変わる箇所は、sizes も段ごとに
別のアーティストのサイトでは、作品の並びを 1 段と 2 段で切り替えられるようにしておりました。既定は 2 段なのに、sizes は 1 段のときの値のまま残っており、PC では 313px の枠に 800 版を読んでいました。1 段用と 2 段用の sizes を分けたところ、PC で最後までスクロールしたときの画像の転送量は 10.6MB から 5.3MB に半減しました。
同じサイトの作品ページでは、大きな図に 3 倍のスマホで約 1,030px が要るのに、用意していた段が 800 の次は 1600 でした。間に 1200 の段を足すと、1 点あたり 773KB が 512KB になりました。sizes を合わせても、段の刻みが粗いと結局一段上を読みます。
一方で、トップの表紙だけは sizes="85vw" のまま残しています。高さから決まる式に書き換えたところ、フレームワークが自動で差し込む先読みと img 本体が別の版を選び、同じ絵を二重に落とすようになったためです。どこまで合わせ込むかには、こうした副作用との釣り合いがあります。
eager と srcset の組み合わせは、先読みを head に増やします
もう一つ、srcset を付けた後で遅くなった箇所がありました。スライドショーで前後 2 点を loading="eager" で先読みしていたところ、ビルド後の HTML の <head> の先頭に、作品 4 点分の <link rel="preload" as="image"> が並んでいたのです。React のサーバー描画が、srcset 付きの eager な画像に先読みを自動で差し込んでおりました。
作品の先読みがフォントの先読みより前に来たため、低速回線の計測で FCP は 2.7 秒から 3.7 秒に悪化しました。eager は初回表示に本当に要る 1 点だけにし、前後の作品は lazy に戻して、ようやく元に戻りました。
確かめ方は、ビルド後の HTML を数えるだけです。
#!/usr/bin/env bash
# 使い方: bash check_preload.sh out/index.html
set -euo pipefail
html="${1:?HTML のパスを渡してください}"
img_preload=$(grep -o '<link rel="preload" as="image"' "$html" | wc -l | tr -d ' ')
font_pos=$(grep -bo 'rel="preload"[^>]*woff2' "$html" | head -1 | cut -d: -f1 || true)
echo "画像の preload: ${img_preload} 本"
echo "フォント preload の位置: byte ${font_pos:-なし}"
# 画像の先読みは 1 本まで。2 本以上ならどの img が eager かを洗い出す
if [ "$img_preload" -gt 1 ]; then
echo "NG: eager な srcset 画像が多すぎます"
exit 1
fi
フォントの先読みの位置は、CSS をインラインで埋め込んだときにも沈みます。先頭から 1 万バイト以内にあるかを、ついでに見るようにしています。
公開前に走らせている点検スクリプト
ここまでの三つの崩れ方は、どれも「ネットワークは正しく、見た目だけがおかしい」か「見た目は正しく、読む量だけが多い」かのどちらかでした。目で見て気づける前者と、数値でしか気づけない後者が混ざるので、公開前に一枚ずつ読む小さなスクリプトを作りました。
# 使い方: python3 audit_img.py <URL> [幅] [DPR]
import sys
from playwright.sync_api import sync_playwright
JS = """
async () => {
// 遅延読み込みを起こすため、下まで送ってから戻る
for (let y = 0; y < document.body.scrollHeight; y += innerHeight) {
scrollTo(0, y); await new Promise(r => setTimeout(r, 150));
}
scrollTo(0, 0);
const out = [];
for (const img of document.images) {
const shown = (img.currentSrc || img.src).split("/").pop();
const box = img.getBoundingClientRect();
const cs = getComputedStyle(img);
// naturalWidth は srcset の w 記述子で補正されるので、ファイルの画素は読み直して取る
const probe = new Image();
probe.src = img.currentSrc || img.src;
try { await probe.decode(); } catch (e) {}
// sizes が見た目を縮めていないかは、srcset なしの「双子」を隣に置いて比べる。
// 同じ要素の srcset を外して測ると、Chromium では直前の密度が残って測り違えた
let freeW = box.width;
if (img.srcset && cs.objectFit === 'fill') {
const twin = document.createElement('img');
twin.className = img.className;
twin.style.cssText = img.style.cssText + ';visibility:hidden';
for (const a of ['width', 'height']) if (img.hasAttribute(a)) twin.setAttribute(a, img.getAttribute(a));
twin.src = img.getAttribute('src') || img.currentSrc; // フォールバック(たいてい原寸)
img.after(twin);
try { await twin.decode(); } catch (e) {}
freeW = twin.getBoundingClientRect().width;
twin.remove();
}
out.push({ freeW,
src: shown,
w: box.width, h: box.height,
natural: img.naturalWidth, fileW: probe.naturalWidth, fileH: probe.naturalHeight,
fit: cs.objectFit, sizes: img.sizes, dpr: devicePixelRatio,
});
}
return out;
}
"""
def judge(r):
issues = []
if r["w"] == 0:
return ["描画幅 0(測れていない・実ページで再確認)"]
# 1. srcset を外した双子のほうが大きく描かれる=sizes が表示幅を決めている
if r["sizes"] and r["freeW"] > r["w"] + 1:
issues.append(f"sizes が表示を縮めている({r['w']:.0f}px → 本来 {r['freeW']:.0f}px)")
# 2. object-fit なしで縦横比がずれている(width/height 属性が CSS として効いた疑い)
if r["fit"] == "fill" and r["fileW"] and r["fileH"]:
drift = abs((r["w"] / r["h"]) / (r["fileW"] / r["fileH"]) - 1)
if drift > 0.02:
issues.append(f"縦横比が {drift:.0%} ずれている")
# 3. 必要な画素の 1.6 倍を超えて取っている
need = r["w"] * r["dpr"]
if r["fit"] == "contain" and r["fileW"] and r["fileH"]:
# 枠に内接する画像は、絵そのものの幅で見積もる
need = min(r["w"], r["h"] * r["fileW"] / r["fileH"]) * r["dpr"]
if r["fileW"] > need * 1.6:
issues.append(f"取りすぎ {r['fileW']}px(必要 約{need:.0f}px)")
return issues
def main():
url = sys.argv[1]
width = int(sys.argv[2]) if len(sys.argv) > 2 else 390
dpr = float(sys.argv[3]) if len(sys.argv) > 3 else 3
with sync_playwright() as p:
b = p.chromium.launch()
page = b.new_page(viewport={"width": width, "height": 844}, device_scale_factor=dpr)
page.goto(url, wait_until="load")
rows = page.evaluate(JS)
b.close()
print(f"== {url} @ {width}px x{dpr}")
for r in rows:
issues = judge(r)
mark = "NG" if issues else "OK"
print(f"{mark} {r['src']} {r['w']:.0f}x{r['h']:.0f} file={r['fileW']}px", " / ".join(issues))
if __name__ == "__main__":
main()
再現ページに 390px・3 倍で走らせると、A の行は「sizes が表示を縮めている(200px → 本来 351px)」、C の行は「縦横比が 25% ずれている」と出ました。B と D は OK です。
作っている途中で、二つつまずきました。一つ目は、点検対象の画像そのものから srcset を外して測り直したときです。Chromium では直前に選ばれた密度が残り、1108 版を読み直しても 277px という中途半端な幅で描かれました。それで、隣に「双子」の画像を置いて比べる形に変えています。
二つ目は、同じページの後ろに原寸を直接指す img があると、前にある srcset の画像までその原寸を使ったことです。小さな再現ページを三つ作って確かめると、原寸の画像が後ろにあるページだけで、sizes="200px" の画像が 1108 版に替わりました。双子に原寸を読ませる点検でも同じことが起きるので、「取りすぎ」の判定は参考にとどめ、気になる行はその画像だけのページで確かめ直しています。flex や grid の中では双子が並びの幅を分け合うため、こちらも NG が出たら目で確かめる前提です。
確かめ方そのものの落とし穴(別タブの iframe で点検して誤診したこと)は、画像が壊れて見えたのは、確かめ方のせいでしたに分けて書いております。
エージェントに srcset を足してもらうときに、指示文へ書いておくこと
最初の夜の崩れは、エージェントの書いたコードが間違っていたわけではありませんでした。sizes を「見えている枠の幅」で書くのは、教科書どおりの書き方です。ただ、私のサイトが「幅を書かず、上限だけで抑える」構成だという前提を、私が伝えていなかったのです。伝えていれば、最初の夜の崩れは避けられたのかもしれません。
いまは、画像まわりを頼むときに次の前提を指示文の頭に置いています。
画像まわりの前提(このサイト固有)
- 作品画像は CSS で width を決めず、max-height / max-width の上限だけで大きさを抑えている
- そのため sizes は最大の表示幅より一段大きく書く(小さく書くと表示が縮む)
- width / height 属性を足すときは、同じ img に CSS で width:auto; height:auto を当てる
- object-fit: contain で枠に入れている画像は、sizes を絵の実際の幅で書く(枠の幅ではない)
- loading="eager" は初回表示の 1 点だけ。ビルド後に <head> の画像 preload が 1 本か確かめる
- sizes の値を正規表現で一括置換しない(メディアクエリの数値まで変わる)
- 終わったら audit_img.py を 390px・3 倍と 1280px・等倍で走らせ、NG の行を報告する
一行目の「このサイト固有」が要です。レスポンシブ画像の一般論はエージェントのほうがよく知っています。知らないのは、私が過去にどこで崩したかと、なぜこの構成を選んだかです。
いまの線引きと、次にやること
二度崩して、ようやく役割の分け方が見えました。どれを読むかは sizes に、どう見せるかは CSS に。 sizes に見た目の調整を背負わせようとすると縮み、属性に大きさを任せると伸びます。両方の値を、それぞれの持ち場から外さないことだけを守っています。
次に画像を触るときは、まず自分のサイトの画像が「CSS で幅を決めている」のか「上限だけで抑えている」のかを、一枚ずつ確かめるところから始めていただければと思います。後者が一枚でもあれば、そこが sizes を大きめに書く場所です。個人開発のサイトは、こうした前提を知っているのが自分一人であることが多いので、私も指示文に書き残すようにしております。