アトミック・レンダリングは何を優先したのか:不完全な状態を見せないという価値選択
アトミック・レンダリングは、UIの状態を「完全」か「非表示」かの二値に強制することで、読み込み中の不完全な状態をユーザーに見せないことを優先している。
① アトミック・レンダリングは何を優先したか
一般的な画像コンポーネントの実装は、loading="lazy" や srcset を設定して読み込みを最適化すれば十分とされる。単一の実行環境(従来のNode.jsサーバー等)では、HTMLの応答時間と画像などの静的リソースの到達時間がほぼ同時であり、読み込み中の「途中状態」は観測されにくい。
Cloudflareのようなエッジ配信環境では、HTMLの応答速度が大幅に向上する一方、静的リソースの取得とのタイムラグが相対的に広がる。この「未確定な時間」がユーザーに見える形で露出するようになった。アトミック・レンダリングは、この露出した時間に対して「表示可能 = 資源確定 ∧ 寸法確定 ∧ レイアウト安定」という制約を課し、中間状態を一切見せない設計を選ぶ。
- 【優先した価値】: UIの視覚的一貫性。読み込み中のALTテキスト露出や破損画像アイコンの表示といった「中途半端な状態」を構造的に排除する
- 【犠牲にした価値】: 実装の単純さ。画像コンポーネントに読み込み状態(loading/loaded/error)を持たせる必要があり、
<img>タグを直接書くだけでは完結しなくなる
② ClaudeMixでやったこと
Before: loading="lazy" と decoding="async" のみを設定した <img> を直接描画していた。読み込み中はブラウザのデフォルト挙動(ALTテキストの表示、または空白)に任せていた。
// app/components/blog/posts/PostCard.tsx(変更前・概念)
const PostCard = ({ thumbnailUrl, title }) => (
<img src={thumbnailUrl} alt={title} loading="lazy" decoding="async" />
);この構成でスケルトンスクリーンやぼかし画像(LQIP)を中間表示する案、useEffect 実行までSSR描画自体を抑制する案をそれぞれ試したが、前者は「中間状態を見せない」という原則に反し、後者はLighthouseのLCPスコアを悪化させたため、どちらも採用しなかった。
After: 読み込み中を示す状態修飾子クラスを初期状態として付与し、onLoad でこのクラスを外すことで「完全に見える」か「完全に見えない」かの二値をCSS側のopacity遷移だけで表現するコンポーネントに書き換えた。数値操作はCSS Transitionに委譲し、JSはクラスの付け外しのみを行う。
// app/components/blog/posts/PostCard.tsx(変更後・抜粋)
<img
src={thumbnailUrl}
alt={title}
loading="lazy"
decoding="async"
onLoad={(e) => e.currentTarget.classList.remove('Blog-PostCard-ThumbnailImg--loading')}
onError={handleImageError}
className="Blog-PostCard-ThumbnailImg Blog-PostCard-ThumbnailImg--loading"
/>/* app/styles/blog/layer2-posts.css(抜粋) */
.Blog-PostCard-ThumbnailImg {
opacity: 1;
transition: opacity var(--transition-duration-slow) var(--transition-timing-function-default);
}
.Blog-PostCard-ThumbnailImg--loading {
opacity: 0;
}読み込み失敗時は handleImageError がフォールバック画像への差し替え、または要素そのものの非表示を行い、破損アイコンを露出させない。
③ 技術的負債
- 【解消した負債】: 画像読み込み中のALTテキスト露出と、読み込み失敗時の破損画像アイコン表示。
opacity: 0の間もレイアウトの占有幅は確保されるため、寸法確定の条件とも両立している - 【新たに生まれた負債(あれば)】: 画像コンポーネントごとに読み込み状態の管理コードを持つ必要が生まれ、単純な
<img>タグの直接記述では完結しなくなった
本文で試行した2つの代替案(スケルトン/LQIP表示、SSR描画の完全抑制)はいずれも失敗として記録されているが、その失敗の程度を独立に数え直せる定量値(改善率等)は本文に存在しない。そのため実測値による比較は行わない。
④ 経営翻訳
窓口の設営が完了するまでの間、案内板を空白のまま出しておくか、それとも設営完了まで案内板自体を出さないでおくか、という選択に相当する。空白の案内板は「まだ何も決まっていない」という中途半端な状態をそのまま来訪者に見せてしまう。設営が完了した瞬間にだけ案内板を出す運用に切り替えることで、来訪者が中途半端な状態を目にすることがなくなった。
この「時間的な不整合が起きやすい配信環境」という背景は、Remix + Viteスタックが直面するPSI計測上の構造的な上限や、サムネイル生成処理をメインリポジトリから切り離した設計とも関わりが深い。