css 画像 読み込み ブラーアップ 9種 — ぼやけて鮮明になる瞬間まで
css 画像 読み込みで最初に決めるのは、本物の絵が届く前に何を見せるかです。ブラーアップとはぼやいた絵を鮮明な絵の上でゆっくり消す計算です — 01番は読み込みの進みを測って二枚の不透明度を交差させ、02番はblurの半径を指数曲線で減らします。九つの場面のソースはコピペでそのまま動きます。
01 bu-crossover-progress
02 bu-radius-decay-curve
03 bu-blur-scale-compensate
04 bu-progress-ring-overlay
05 bu-shimmer-blurup-content
07 bu-gallery-stagger-wave
08 bu-timeout-fallback-verdict
09 bu-reduced-motion-instant
- 01 読み込みの進みだけ二枚を交差させる基本ブラーアップ
- 02 blur半径を指数曲線で減らす鮮明化
- 03 blurの膨らみだけスケールを逆算して補正する場面
- 04 読み込みの%を円弧で重ねる進行リング
- 05 シマー→ブラーアップ→中身の三段状態機械
- 06 丸いアバターをぼやけてから鮮明に着地させる場面
- 07 遅れを計算して順に鮮明になるギャラリー
- 08 タイムアウト判定でプレースホルダーに留まる失敗フォールバック
- 09 動きを減らす設定でblurなしにすぐ見せる即時切替
九つの場面はどこまで動いたか — 測った数値の読み方
数値は 도구/demo.py が2秒間の場面を24枚で撮り、隣り合う二枚の差23個で動きを測った実測です(測定時刻 2026-11-17 03:50)。累積面積は、どこかのフレームで最初の一枚から変わった画素の割合です。強度はその色差の平均(0〜255)です。一方、減衰曲線の半径の値・スケールの逆算・弧の長さは、ソースの定数から計算したモデル値です — この二つを分けて読みます。
| 場面 | 累積面積 | 動いたフレーム | 強度の平均 |
|---|---|---|---|
| 01 基本のクロスフェード | 23.7% | 23/23 | 108.2 |
| 02 半径の減衰曲線 | 3.4% | 23/23 | 115.9 |
| 03 スケール補正 | 6.3% | 23/23 | 107.8 |
| 04 進行リングの重ね | 12.9% | 23/23 | 109.9 |
| 05 シマー三段 | 25.6% | 23/23 | 78.9 |
| 06 丸いアバター | 6.8% | 23/23 | 116.4 |
| 07 順番ギャラリー | 19.4% | 23/23 | 111.2 |
| 08 失敗フォールバック | 24.1% | 23/23 | 118.6 |
| 09 即時切替 | 22.5% | 23/23 | 107.0 |
面積が最も広いのは05シマー三段の25.6%、最も狭いのは02半径減衰の3.4%です。強度は08の118.6が最も高く、05の78.9が最も低く、すべての強度が判定の目安15を大きく超えています。九つとも23/23で、空いたフレームなく2秒の間ずっと動きました。
面積が10%より狭い02・03・06は、半径が0へ収束するにつれて動く画素が自然に狭くなる性質です。広さの代わりに、減衰式・逆算補正・円弧の均一補正という計算の精密さで読む場面です。収束の小数点は描画の揺らぎで±0.1pxほど変わるため、確定していません。
01読み込みの進みだけ二枚を交差させる基本ブラーアップ
進み p が0から1へ進む間、ぼやけた絵の不透明度を 1−p へ下げ、鮮明な絵を p へ上げます — 二つの合計が毎瞬間1なので、途中で背景が透けません。読み込みの開始 LOAD_AT 220ms・交差 CROSS_MS 900 で、220〜1120msにわたって交差が続きます。
開始時刻が完了より前、という条件が順序の核心です。まだ届いていない絵が先に上がってこないようにする守りです。画面の「α ぼやけ + α 鮮明 = 1」の表示がその合計を毎フレーム検証して、1880msでぼやけた絵へ戻ります。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="読み込みの進み0から1まで二枚の不透明度を常に1になるように交差させる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 374줄 — 아래 「전체 코드」에서 원문 전체)// BuCrossoverProgress - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuCrossoverProgress.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 364줄 — 아래 「전체 코드」에서 원문 전체)01 · 読み込みの進みだけ二枚を交差させる基本ブラーアップ — 計測 累積面積 23.722% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
交差のすべてはこの数行です — p ひとつが二枚を正確に逆へ動かします。
function applyCross(p) {
if (lowEl) {
lowEl.style.opacity = f2(1 - p);
}
if (highEl) {
highEl.style.opacity = f2(p);
}
02blur半径を指数曲線で減らす鮮明化
不透明度ではなくblurの半径そのものを減らす分岐です。R = R0 × e^(−DECAY_RATE × t) の指数曲線に沿って blur(20px) が blur(0) へ収束します — 最初の大きい半径は速く消え、最後の残りかすはゆっくり残る、カメラのピントが合う減衰そのものです。
画面の検算の行は t=1s R=11.5 · t=2s R=6.66 をそのつど計算し直して見せます(モデル値)。曲線が緩やかになるほど動く画素は狭くなり、累積面積は3.4%で九つの中で最も狭いのに、23/23フレームずっと生きています。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="blur半径が指数曲線に沿って20pxから0へ減り、カメラのピントのように残りかすが遅く消える場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 374줄 — 아래 「전체 코드」에서 원문 전체)// BuRadiusDecayCurve - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuRadiusDecayCurve.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 370줄 — 아래 「전체 코드」에서 원문 전체)02 · blur半径を指数曲線で減らす鮮明化 — 計測 累積面積 3.41% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
減衰の主役は定数三つで、下の五つの場面が同じ曲線を共有します。
const DECAY_RATE = 0.55; // 減衰の速さ (変形: 0.28)
const R0 = 20; // blurの初期半径 px
const START_AT = 250; // 減衰の開始時刻 (最初の変化 t>=200ms)
function applyRadius(t) {
const r = blurRadius(R0, DECAY_RATE, Math.max(0, t - START_AT));
if (lowEl) {
lowEl.style.filter = 'blur(' + f2(r) + 'px)';
}
if (rEl) {
rEl.textContent = fill('R = {a}px (開始 {b}px · e^-{c}t)', f2(r), f0(R0), f2(DECAY_RATE));
}
03blurの膨らみだけスケールを逆算して補正する場面
filter: blur(20px) は絵の縁からおよそ20px外へにじんで透明になります。この場面は、にじむ分だけ絵を scale = 1 + R/400 で大きくしてから、半径が減るにつれ1.0へ逆算して戻し、にじみを箱の中に閉じ込めます。
二枚のカードを並べて、左(補正あり)は縁が毎瞬間内側に留まり、右(scale 1 固定)はblurのにじみがカードの外へ漏れる比較を見せます — R=20px のとき1.05、R=10px のとき1.025です(モデル値)。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="blurのにじみだけスケールを上げてから戻し、二枚のカードの縁が分かれる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 389줄 — 아래 「전체 코드」에서 원문 전체)// BuBlurScaleCompensate - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuBlurScaleCompensate.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 385줄 — 아래 「전체 코드」에서 원문 전체)03 · blurの膨らみだけスケールを逆算して補正する場面 — 計測 累積面積 6.313% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
逆算の補正は、定数ひとつと割り算の一行です。
// backSolve — blur が外へにじむ(edge bleed)半径の分だけスケールを大きくする逆算の補正.
// R=20px のとき 1.05 になるよう EDGE_K=400: scale = 1 + R/400
const EDGE_K = 400;
function backSolve(r) { return 1 + r / EDGE_K; }
const DECAY_RATE = 0.55; // 02 と同じ減衰曲線
const R0 = 20;
const START_AT = 250;
const SHOW_S = 24; // 補正ありカード x
const SHOW_N = 236; // 補正なしカード x — blur が漏れる側の比較
const CW2 = 188; // カードの幅
04読み込みの%を円弧で重ねる進行リング
ブラーアップの上に実際の進みの%を載せる円弧の計算です。円周 RING_C 176px(直径56pxの円、56×π≈176)を先に決めて、弧の長さ = 176 × %/100 · stroke-dashoffset = 176 − 弧の長さ で下げます。34%では円周のうち59.8px≈60pxだけが描かれる算術が毎瞬間%と一致します(検算値)。
リングが満ちていく間、ぼやけた絵のblurも 8×(1−p) px へ一緒に減ります。時間表(LOAD_AT 220ms · CROSS_MS 900)が同じ01の対です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="読み込みの%だけ円弧の長さが正確に描かれ、リングと絵が同じ進みを分け合う場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 403줄 — 아래 「전체 코드」에서 원문 전체)// BuProgressRingOverlay - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuProgressRingOverlay.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 395줄 — 아래 「전체 코드」에서 원문 전체)04 · 読み込みの%を円弧で重ねる進行リング — 計測 累積面積 12.94% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
フレーム関数が%を、弧とblurの二つの表現へ分けて入れます。
function frame(t) {
const p = progress(t, LOAD_AT, CROSS_MS);
const pct = p * 100;
const arc = ringArc(RING_C, pct);
if (fgEl) {
fgEl.setAttribute('stroke-dashoffset', f2(RING_C - arc));
}
if (highEl) {
highEl.style.opacity = f2(p);
}
if (lowEl) {
lowEl.style.filter = 'blur(' + f2(8 * (1 - p)) + 'px)';
}
05シマー→ブラーアップ→中身の三段状態機械
待機・切替・完成の三つの状態をガード二つでつなぐ状態機械です。待機状態(0〜600ms)では48pxの斜めタイルのシマーが画面を流れ、ガード1「t≥600」が移行を許すと、R0 14 が DECAY_FAST 2.2 の曲線で収束するブラーアップが始まります。
ガード2「R<0.5」が満たされると中身の状態へ固まります。戻る辺がないので、一度固まった中身は再びぼやけません。累積面積25.6%は、シマーのタイルが広く流れるこの600msの区間が作った値です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="シマーが流れ、ブラーアップが起き、中身の状態へ固まる三段が一つの流れにつながる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 388줄 — 아래 「전체 코드」에서 원문 전체)// BuShimmerBlurupContent - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuShimmerBlurupContent.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 381줄 — 아래 「전체 코드」에서 원문 전체)05 · シマー→ブラーアップ→中身の三段状態機械 — 計測 累積面積 25.569% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
移行の条件がコードに明示されているので、状態の図をソースからそのまま読めます。
function step(t) {
// 状態遷移 — ガードは二つだけ (t>=WAIT_END · R<0.5px). 戻る辺はない
if (state === 'wait' && t >= WAIT_END) {
state = 'cross';
}
const r = state === 'wait' ? R0 : blurRadius(R0, DECAY_FAST, t - WAIT_END);
if (state === 'cross' && r < 0.5) {
state = 'content';
}
06丸いアバターをぼやけてから鮮明に着地させる場面
プロフィールカードに使う丸いブラーアップです。直径72pxの円形の切り抜きの中で半径12が DECAY_RATE 1.4 で減りますが、このときスケールの補正を四角ではなく円に合わせて計算し直して、膨らみが円弧に沿って均一になるようにします — 角のない形でもにじみません。
アバター三つが220・420・620msに順に始まって「鮮明 n/3」の数がひとつずつ上がります。開始時刻をずらすしくみは、07ギャラリーと同じ遅れ順番の最小の形です。
<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="丸いアバター三つが順に着地し、角のない形でもにじまず鮮明になる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 387줄 — 아래 「전체 코드」에서 원문 전체)// BuAvatarCircleCrop - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuAvatarCircleCrop.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 382줄 — 아래 「전체 코드」에서 원문 전체)06 · 丸いアバターをぼやけてから鮮明に着地させる場面 — 計測 累積面積 6.786% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
円形のマスクの中で、半径の減衰とスケールの逆算を一緒に掛けます。
function frame(t) {
let sharpCount = 0;
for (let i = 0; i < 3; i += 1) {
const r = blurRadius(R0, DECAY_RATE, Math.max(0, t - AV_AT[i]));
const s = backSolve(r);
const av = avs[i];
if (av.low) {
av.low.style.filter = 'blur(' + f2(r) + 'px)';
av.low.style.transform = 'scale(' + (Math.round(s * 1000) / 1000) + ')';
}
07遅れを計算して順に鮮明になるギャラリー
九枚の格子で、各絵のブラーアップの開始を index × STAGGER_MS(140) でずらして、最初のカード250ms・最後のカード1370ms(250 + 8×140)の波で順に鮮明にします(モデルの算術)。鍵はGPUコストの分散です — filter blur は絵ごとに独立な層を作るので、九枚が同時に掛かると性能の低い機械がつまずきます。
開始をずらすと同時のブラーアップは最大1枚になります。画面の「ブラーアップ中 n枚(同時最大1)」の表示がその判定を毎フレーム見せます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="格子の九つがindexの遅れだけずれて順に鮮明になり、波のように払う場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 385줄 — 아래 「전체 코드」에서 원문 전체)// BuGalleryStaggerWave - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuGalleryStaggerWave.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 378줄 — 아래 「전체 코드」에서 원문 전체)07 · 遅れを計算して順に鮮明になるギャラリー — 計測 累積面積 19.387% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
indexDelay 関数が遅れの算術と同時実行の制限を一緒に作り、下の輪が毎フレーム同時に動いている枚数を直接数えます。
const STAGGER_MS = 140; // 格子の index 間の遅れ (変形: 400)
const indexDelay = function (i) { const gpuSpread = 1; return BASE_AT + i * STAGGER_MS * gpuSpread; }; // 同時ブラーアップ最大1枚で GPU を分散
const start = indexDelay(cell.i); // gpuSpread — 一度に一枚ずつ
const r = blurRadius(R0, DECAY_RATE, Math.max(0, t - start));
if (cell.low) {
cell.low.style.filter = 'blur(' + f2(r) + 'px)';
}
if (r < 0.5) {
done += 1;
}
else if (t >= start) {
active += 1;
}
08タイムアウト判定でプレースホルダーに留まる失敗フォールバック
TIMEOUT_MS 4000 の間に読み込みが終わらないとき、ブラーアップをやめてプレースホルダーに代替の文を出す、無限の待ちがない判定です。判定の瞬間に aria-busy を解き、失敗を文(role=status の polite)で知らせて、1720msでぼやけた待ち状態へ戻ります。
実際の基準値4000msは2秒のデモの窓を越えるので、デモは判定の到達を1200msへ圧縮して再現し、画面に「実際の値 TIMEOUT_MS 4000」と明示します。累積面積24.1%・強度118.6は、フォールバックの文の板が遅れて一気に現れる画面の切り替えが作った値です。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="読み込みが終わらないとタイムアウト判定がブラーアップを止め、代替の文が席を守る場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 406줄 — 아래 「전체 코드」에서 원문 전체)// BuTimeoutFallbackVerdict - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuTimeoutFallbackVerdict.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 388줄 — 아래 「전체 코드」에서 원문 전체)08 · タイムアウト判定でプレースホルダーに留まる失敗フォールバック — 計測 累積面積 24.058% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
判定は状態の切り替えひとつで済みます — 下はその前半です。
if (!failed && t >= FAIL_AT) {
// 判定 — ブラーアップ中止, aria-busy 解除, フォールバックの文
failed = true;
if (lowEl) {
lowEl.style.filter = 'none';
lowEl.style.opacity = '0';
}
if (highEl) {
highEl.style.opacity = '0';
}
if (fbEl) {
fbEl.style.opacity = '1';
}
const cardEl = fbEl ? fbEl.parentElement : null;
if (cardEl) {
cardEl.setAttribute('aria-busy', 'false');
}
09動きを減らす設定でblurなしにすぐ見せる即時切替
prefers-reduced-motion が有効ならblurの段階を飛ばして鮮明な絵をすぐ見せます — ぼやけた絵をまったく描かない分岐なので、切替のコストも0です。二枚のカードを並べて、左は通常の交差(220〜920ms)・右は即時の分岐が SWAP_AT 900ms に一フレームで切り替わる比較を見せます。
この場面は、九つすべてに仕込まれた減らす分岐を画面の中に取り出したデモです。実際に減らす設定の環境では場面そのものが右のカードのように動き — 「動きを減らす設定 · blurなしの鮮明な絵一枚」の文と一緒に、鮮明な絵一枚だけを描きます。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__in" data-role="inner">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、左右の矢印キーで別の値へ">
<div class="ez__scene" data-role="scene" role="img" aria-label="左はブラーアップを歩み、右はぼやけた段階を描かずにすぐ鮮明になる場面"></div>
<div class="ez__probe" data-role="probe" aria-hidden="true"></div>
<div class="ez__chart" data-role="chart" aria-hidden="true"></div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<p class="ez__reada" data-role="reada" aria-hidden="true"></p>
<p class="ez__readb" data-role="readb" aria-hidden="true"></p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
… (총 18줄 — 아래 「전체 코드」에서 원문 전체)// 525 공통 — 이미지 블러업 로딩 (524 base.scss 계승, 잉크 무대 → 밝은 크림 갤러리 톤)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 90%);
$frame: mix($subject-cream, $subject-ink, 24%);
$dim: mix($subject-cream, $subject-ink, 46%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
… (총 313줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 379줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 393줄 — 아래 「전체 코드」에서 원문 전체)// BuReducedMotionInstant - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./BuReducedMotionInstant.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 525 블러업 공통 — 무대 좌표·문구 틀·요소 조립·이미지 소재·블러업 엔진 (524 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v: number, lo: number, hi: number): number { return v < lo ? lo : (v > hi ? hi : v); }
… (총 383줄 — 아래 「전체 코드」에서 원문 전체)09 · 動きを減らす設定でblurなしにすぐ見せる即時切替 — 計測 累積面積 22.457% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
減らす分岐はぼやけた層を作らずに、完成フレーム一枚で終わります。
if (reduced) {
// 動きを減らす — すべてのアニメーションが消え、場面は blur なしの鮮明な絵一枚 (キューのアクセシビリティ記述)
statusP.textContent = '動きを減らす設定 · blurなしの鮮明な絵一枚';
readB.textContent = 'ぼやけた段階を飛ばして鮮明な絵をすぐ見せる一枚の場面';
doneP.textContent = readB.textContent;
cfg.frame(1e9);
}
ぼやけてから鮮明になるのに必要な値はいくつあるか — 初期半径・減衰の曲線・交差時間・比率の固定
値は四つです。初期半径 R0 はどれだけぼやけて始めるか、減衰の速さ DECAY_RATE(または交差時間 CROSS_MS)はどれだけ速く鮮明になるか、そして読み込みの前に高さ0の絵がレイアウトを押さないための比率の固定です。この四つを決めれば、九つの場面はすべてその値の組み合わせです。
| 値 | 役割 | この記事の基準値 |
|---|---|---|
| R0(初期半径) | 最初の画面のぼやけ — 大きいほど低解像度の跡が残る | 02・03は20px、05は14px、06・07は12px |
| DECAY_RATE | 指数減衰の傾き — 大きいほど速く鮮明になる | 02は0.55、05の切替は2.2、07は2.0 |
| CROSS_MS | クロスフェードの長さ | 01・04は900ms、09の通常は700ms |
| 比率の固定 | 読み込み前の高さ0を防ぐ — width/height または aspect-ratio | すべてのカードが明示的な width・height を持つ |
減衰の曲線とクロスフェードは、同じ目的の二つの分岐です — 不透明度を動かす場合はぼやけた絵と鮮明な絵の二枚が要り(01・04・09)、半径を動かす場合は一枚で済む代わりにピクセル単位の計算のコストが掛かります(02・05・06・07)。どちらでも、絵が完成した後の姿は同じです。
一枚が鮮明になる順番 — decode を待ってから不透明度を上げる
順序が核心です。ぼやけた絵(インラインの data URI で即時)→ 読み込みまたは decode の完了を確認 → その後だけ交差を開始 — この順序が壊れると、まだ届いていない絵が鮮明になる事故が起きます。このデモの絵は data URI の SVG なのでデコードがすぐ終わり、順序の保証は01の LOAD_AT の条件と08のタイムアウト判定の構造で説明します。
実際のサイトでは <img>.decode() がその確認を担います — 絵のデコードが終わった後で then のコールバックが呼ばれるので、その中で不透明度を上げれば、完成した絵だけが鮮明になります。
decode() は caniuse の全世界の対応97.35%(2026-11-17確認)で Chrome 64+・Edge 79+・Firefox 68+・Safari 11.1+・iOS Safari 11.3+・Samsung Internet 9.2+ で動きます。対応しない古い Safari 11.0 以前では、load イベントで同じ順序を保証すれば十分です。
もうひとつ注意 — loading="lazy" は画面に入る前のダウンロードを遅らせるので、ブラーアップの「ぼやけた絵を先に」と順序がずれることがあります。
css 背景 画像 遅延 読み込みを調べて lazy を付けようとするときは、ぼやけた原画はインライン・data URI で即時に置き、本物の絵だけを lazy にするか、両方を eager にする方が安全です。画像 遅延 読み込み css の場面でも、同じ規則が要ります。
css だけでできることとjsが要ること — transition の境界はどこか
境界は「進みを誰が作るか」です。時間表が決まった一度の交差なら、css の transition だけでできます — ぼやけた img の上に鮮明な img を重ねて、不透明度を transition で上げればそれで終わりです。スケルトン ローディング のような待ちの枠を探して貼る人の多くが最初に渡されるのも、この層です。
js なしではできないことは三つにまとまります — 読み込み・decode の完了を待ってから始めるべきとき(順序の保証)、半径を毎フレーム計算すべきとき(02・03・05・06・07 の減衰と逆算)、そして時間を測って失敗を判定すべきとき(08)です。進行リングの円弧の算術とタイムアウトの判定は後者なので js 側にあります。
実際のサイトではここに HTMLImageElement.decode() の待ちが載り、その組み合わせが html の実戦形の progressive な読み込みです。
どこで壊れるか — にじむ縁・割り当てない比率・重なるGPU
この記事を作りながら、壊れる場所を八つ直接確かめました。条件と直し方を一緒に書きます。
一つ目は、blur がカードの外へにじむことです。blur(20px) は絵の縁からおよそ20px外へ広がって透明になります — 03の右のカード(scale 1 固定)がその実態で、縁の外が汚くなります。scale = 1 + R/400 の逆算でにじみをカードの中に閉じ込めれば直ります。
css の filter blur は全世界の対応97.4%(Chrome 18+・Firefox 35+・Safari 6+)ですが、古い Safari は性能の問題があるので大きい半径は避けた方がよいです。
二つ目は、比率を割り当てないときの画面の跳ねです。絵が読み込まれる前に高さが0だと、読み込んだ瞬間に下の内容が上へ押し上げられます — ブラーアップの滑らかさと無関係に、利用者が画面の跳ねとして受ける事故です。
この記事のすべてのカードは明示的な width/height を持ち、実際の画面では aspect-ratio(全世界97.23%、Chrome 88+・Firefox 89+・Safari 15+)が同じ役割を果たします。それより前のブラウザでは width・height の属性が代わりです。
三つ目は、九枚が同時に blur すると低い性能の機械がつまずくことです。filter blur は絵ごとに独立な層を作ります。ギャラリー全体が一斉にブラーアップするとGPUコストが同時に集中します — 07の index の遅れで開始を140msずつずらすと、同時のブラーアップは最大1枚に分散されます。
四つ目は、交差の途中で背景が透けるなら算術が間違っていることです。二枚の不透明度をそれぞれ個別に動かすと、途中で合計が1を破って穴が見えます — それぞれ ease で動かすと交差点で合計が一瞬0.8まで下がります。01のように (1−p)・p の組で合わせれば毎瞬間合計が1です。
五つ目は、decode の前に交差を始めると空の絵が鮮明になることです。読み込み完了の確認なしに不透明度を上げると、まだ届いていない絵が上がってきて、ぼやけた絵がそのまま消えます。01の LOAD_AT(220ms)の確認が順序を保証するデモ版で、実際は decode() のコールバックがその場所です。
六つ目は、loading="lazy" との順序のずれです。lazy は画面に入る前のダウンロードを遅らせるので、ぼやけた原画まで lazy にすると、ブラーアップの最初の画面が空欄から始まります — ぼやけた側は即時に、本物の絵だけを lazy にする規則が要ります。
七つ目は、タイムアウトがないと無限の待ちに掛かることです。絵がまったく失敗したとき、ブラーアップだけを信じていると利用者はぼやけた画面に閉じ込められます。08のように TIMEOUT_MS の間に終わらなければ判定を下して代替の文へ渡すと、失敗も文で案内されます。
八つ目は、最初に戻る時刻の窓です。01のリセット1880ms・08の再開1720msのように、ループの戻りがデモの窓(2秒)の90%の中に入っていると切れ目なく繰り返されます — この記事の九つの場面はすべてこの内側で戻ります。
九つの場面のソースと編集用ファイルをまとめた zip は下の箱から受け取れます。開くときの暗号は m955vg6u です。減衰の速さと交差時間を変えた変形の値まで、ソースに注釈で残してあります。
初期半径と減らす速さを変えると感じはどれだけ変わるか — 三つの定数をひとつずつ
三つの変形は、それぞれ定数をひとつだけ変えた前後を矢印キーでその場で見られます(モデルの算術)。
| 名前 | 変えた値 | 感触 |
|---|---|---|
| 減衰をゆっくりに | 02 DECAY_RATE 0.55 → 0.28 | 半径が倍ほど長く残ります — t=1s R 11.5→15.0 · t=2s 6.66→11.3。現像液から浮かぶ写真の感じ、0.55はカメラのピントが素早く合う感じ |
| 交差時間を短く | 01 CROSS_MS 900 → 350 | 交差が220〜570msで終わって瞬きのピント合わせのようになります — 900は霧が晴れるようにゆったり |
| ギャラリーの遅れを広げる | 07 STAGGER_MS 140 → 400 | 最後のカードの開始が1370→3450msになって波がひと目で読めます — ただし2秒のデモの窓を越えるので、実際の画面では格子の数を減らして合わせます |
減衰を速くする向きは、表の0.55がすでにその例です — 下げるほどゆったり、上げるほど素早く決まります。シマーとの併用では、05のように待ちの段階とブラーアップの段階を状態として分けて重ならないようにすると、読む順序が守られます。ぼやけた絵が先に載って席を守ること自体がプレースホルダーと同じ目的なので、進みをリング(04)で載せるかシマー(05)で載せるかは、内容の性質が決めます。
動きを減らす設定では鮮明な絵一枚 — 読み込みの状態を文で知らせるアクセシビリティ
九つの場面すべてにキーボードの操作が実在します — Space・Enter が一時停止、R が最初から、←→ が値の切り替えです。絵には alt の文がそのまま生きていて、blur が掛かっていても読み上げの内容は変わりません。
読み込みの間は aria-busy を、失敗の判定の後は role=status の文で知らせます(08が直接デモします)。毎フレーム変わる状態の行は aria-live を切って、数字の読み上げを防ぎました。
減らす設定が有効になると、ぼやけた層を最初から作らずに鮮明な絵一枚をすぐ見せます — 09がその分岐を画面の中で並べて再現します。SCSS の減らすブロックは、すべてのアニメーションと切替を一度に止めます。読者のコードへ移す数行は下のとおりです。
@media (prefers-reduced-motion: reduce) {
.ez * { animation: none !important; transition: none !important; }
.ez__pause { transition: none !important; }
}
prefers-reduced-motion は全世界の対応97.35%(Chrome 74+・Edge 79+・Firefox 63+・Safari 10.1+・iOS 10.3+・Samsung Internet 11.1+)で、九つの場面のどこに付けても安心な値です。
JavaScript が切れた環境でもぼやけた層の img は残り、失敗した絵は08のように代替の文が席を守ります。待ちの画面の近い親戚はスケルトンローディング 9種とチャートのローディングスケルトン UI パターンにあります。
減らす設定の全体は動きを減らす設定のガイドに分けて書きました。
画像ブラーアップのFAQ — cssだけ・二枚のファイル・blurが重いとき
css 画像 ブラー のブラーアップは css だけで作れますか
時間表が決まった一度の交差なら作れます — ぼやけた img と鮮明な img を重ねて、不透明度を transition で上げればそれで終わりです。ただし読み込みの完了を待ってから始める順序の保証と、半径を毎フレーム計算する減衰・逆算、タイムアウトの判定は js の側です。
画像ファイルは二枚準備しなければなりませんか
原則は二枚です — 数十バイトの低解像度のサムネイル(またはこの記事のような data URI の SVG)がぼやけた層になり、本物の写真が鮮明な層になります。一枚で済ませるなら、本物の写真に css の blur を掛けて半径を減らす02の方法がありますが、大きい写真がぼやけて回っている間の帯域はそのままです。
blur が重くなったら何を直しますか
同時にブラーアップする絵の枚数から減らします — filter blur は絵ごとに独立な層なので、07の index の遅れで同時の実行を1枚に散らすのが最初の処方で、その次に初期半径を狭めて、03のスケールの逆算を付けます。
絵をいつ鮮明にするかは decode(または load)の完了を待ってからに決めるのが原則で — その後だけ不透明度を上げれば完成した絵だけが鮮明になり、交差時間は350ms前後ならピントが合う感じ・900ms前後なら霧が晴れる感じで、内容の性質が決める値です。
出典: MDN HTMLImageElement.decode()・MDN filter: blur()・MDN aspect-ratio・MDN prefers-reduced-motion









