スケルトンローディング CSS 6種 — マークアップから画像まで
スケルトンローディングは灰色の棒ではなく計算だ — 段落幅はテキスト分布から、表のセルは列比率から、画像寸法はaspect-ratio予約から出る。CSSでローディング状態を作る六つの道を規則計算だけで再現する。六つのシーンすべて、骨格の幅と速さと寸法を実測と定数の算術で組み立てるところを見せます。
01 markup-anatomy-aria
02 enter-exit-wipe-crossfade
03 table-col-ratio-cells
04 tailwind-utility-cost
05 generator-param-output
06 image-ratio-blurup
- 01 マークアップ構造型 — セマンティック骨格とaria-busy
- 02 出現・消失エフェクト — クロスフェードとワイプの対称
- 03 表型スケルトン — 列比率と行の高さ配分の計算
- 04 Tailwindユーティリティ — animate-pulse構成の得損
- 05 ジェネレーター — 行数・比率・速度からCSS出力まで
- 06 画像型 — aspect-ratio予約とblur-up
skeleton loading css とは何か — 読み込み状態を先に見せる予約レイアウト
内容が到着する前に席と寸法を先に押さえておく灰色のブロックが skeleton loading css の出発点です。リストにカードが新しく付くときや画像が遅れて届くとき、空の画面の代わりに骨格が先に置かれると、画面は待ち時間の割に遅く感じられず、到着の瞬間に高さが跳ぶことも防げます。
このデモの六つのシーンは、その骨格をごまかしではなく算術で作ります。段落バーの幅は実測した長さ分布からサンプリングし、表の列は実測幅を比率に正規化して配分し、画像の枠は幅を比率で割って高さを先に決めます。骨格が本文とずれたら、そのずれの大きさまで数字で採点します。
骨格幅を引き出す cdfInvert
幅サンプリングの本体は短い関数です — ソースの補助計算区間をそのまま載せます。
function ema(prev, x, k) {
return prev + (x - prev) * k;
}
// cdfInvert — 逆累積分布サンプリング。r^expo: expo>1 だと短い側(最後の行)に寄る
function cdfInvert(r, expo, lo, hi) {
return lo + (hi - lo) * Math.pow(r, expo);
}
名前は難しそうでも動きは単純で、0 と 1 の間の値に指数を掛けて分布を片側に傾けるだけです。指数 2.0 では幅が短い側に寄り、下限 0.16 と上限 0.95 が極端に短い棒や満幅の棒を防ぎます。
6種 — マークアップ・出現エフェクト・表・Tailwind・ジェネレーター・画像
定数と実測を分ける線
ソースに埋め込まれて計算に使う値と、レンダリングを測って出てくる値は種類が違います。260ms の進入待ち・520ms のワイプ・420ms の滞在・640ms のクロスフェードのようにソースの定数が動作を決め、累積面積と強度はレンダリング 2 秒を 24 コマに切り、隣り合うコマの差 23 個で測ります。累積面積は一周期の中で一度でも絵が変わった画素が場面で占める割合、強度は変わった画素の明るさと色の差を 0〜255 で平均した値で、レンダリングのジターで小数第一位は ±0.1 揺れます。
測定の正答表
六つの場面を全部レンダリングして測った値が次の表です。
| シーン | 累積面積 | 動いたフレーム | 強度平均 |
|---|---|---|---|
| 01 マークアップ構造型 | 10.8% | 23/23 | 65.6 |
| 02 出現・消失エフェクト | 20.6% | 23/23 | 79.6 |
| 03 表型スケルトン | 26.1% | 23/23 | 54.6 |
| 04 Tailwind ユーティリティ | 13.3% | 23/23 | 106.2 |
| 05 ジェネレーター | 4.8% | 23/23 | 108.9 |
| 06 画像型 | 26.9% | 23/23 | 44.3 |
面積は画像型の 26.9% と表型の 26.1% が広く、ジェネレーターの 4.8% が最も狭い — 二つの板が並んで動く場面と小さなコードパネル一つが舞台だからです。強度はその狭いジェネレーターが 108.9 で最も強く、面積 10% 未満はジェネレーターの一つだけで、六つの場面で二つまでが許される規則に余裕で収まります。
六つのシーンがこの順序なのは
骨格の構造(01)から骨格が行き来する遷移(02)へと進み、その後は骨格が座る対象の順です — 表(03)・ユーティリティ比較(04)・ジェネレーター(05)・画像(06)。同じ骨格のテーマでも、チャット回答の画面は AI 回答スケルトン 9種 が別にあり、ここでは汎用のリスト・表・画像側を担います。
01マークアップ構造型はどう組むか — セマンティック骨格とaria-busy
記事カードの骨格がセマンティック注釈(head・thumb・lines)と共に組み上がり、段落バーごとに幅がサンプリングで決まります。組み立ての間、カードは aria-busy を true に設定して待ち状態を伝え、本文の幅が公開される瞬間には、骨格と実測幅のずれがバンドとして重なって見えます。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 535-01 마크업 구조형 스켈레톤 — 시맨틱 골격과 aria-busy (531 base 계승)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: mix($subject-cream, $subject-ink, 45%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 267줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 344줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승, 채팅 버블 대신 아티클 골격·CSS 조판 판)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
… (총 417줄 — 아래 「전체 코드」에서 원문 전체)// Skel01MarkupAnatomyAria - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./Skel01MarkupAnatomyAria.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승, 채팅 버블 대신 아티클 골격·CSS 조판 판)
const W = 480;
const CX0 = 8;
const CW = 432;
… (총 442줄 — 아래 「전체 코드」에서 원문 전체)01 · マークアップ構造型 — セマンティック骨格とaria-busy — 計測 累積面積 10.763% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
本文到着後の採点 — errArea と hitRate
レンダリング実測ではこの場面は累積面積 10.8%・強度 65.6 を記録し、フレーム差 23 個すべてで動きました。
for (let i = 0; i < PARA_N; i += 1) {
const last = i === PARA_N - 1;
const u = last ? 1 : clamp(gammaSample(2.2, 0.38, 7.7, i), LIN_MIN, LIN_TOP);
true01[i] = u;
const band = make('i', 'band', scWrap);
const x = CARD_X + 12;
const y = CARD_Y + 104 + i * 14;
band.style.left = (x + 244 * u - 4) + 'px';
band.style.top = y + 'px';
band.style.height = '8px';
bandEls.push(band);
}
}
for (let i = 0; i < PARA_N; i += 1) {
const sk = bars01[i].offsetWidth / 244;
const u = true01[i];
err += Math.abs(sk - u);
if (Math.abs(sk - u) <= 0.08) {
hits += 1;
}
}
err = err / PARA_N;
if (errEl) {
errEl.textContent = 'errArea Σ|skel-real| = ' + f2(err);
}
02出現・消失エフェクトの違い — クロスフェードとワイプの対称
出現はワイプ — スケルトンが左から入り、進行端に沿ってピクセルバーが積もります。消失はクロスフェード — 本文が骨格の上に浮かび、二つの不透明度曲線が 640ms の間、互いを鏡のように映します。

<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="スケルトンが左からワイプで入り、本文がクロスフェードで覆い、2つの不透明度曲線が互いに対照をなす場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 535-02 등장·사라짐 이펙트 — 크로스페이드와 wipe 의 대칭 (531 base 계승)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: mix($subject-cream, $subject-ink, 45%);
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 286줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 348줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
… (총 384줄 — 아래 「전체 코드」에서 원문 전체)// Skel02EnterExitWipeCrossfade - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./Skel02EnterExitWipeCrossfade.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
… (총 409줄 — 아래 「전체 코드」에서 원문 전체)02 · 出現・消失エフェクト — クロスフェードとワイプの対称 — 計測 累積面積 20.578% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
二つの曲線が鏡になる条件
実測は累積面積 20.6%・強度 79.6・動き 23/23 です — 260ms の待ちの後、520ms のワイプと 420ms の滞在、640ms のクロスフェードが一周期を構成します。
function crossFade(k) {
// 滑らかな s カーブ — cubic-bezier(0.4, 0, 0.2, 1) に似せた三次多項式近似
return k * k * (3 - 2 * k);
}
function frame(t) {
if (!skelPanel02 || !textPanel02) {
return '';
}
const tt = t % (T_END + 500);
let enterK = 0;
let exitK = 0;
if (tt < T_IN) {
enterK = 0;
}
else if (tt < T_IN + WIPE_MS) {
enterK = clamp((tt - T_IN) / WIPE_MS, 0, 1);
}
else {
enterK = 1;
}
// ワイプ進行エッジ — clamp(edge) がトラクションを作る(端で滑らない)
edgeX02 = PANEL_W * clamp(enterK * 1.12, 0, 1);
skelPanel02.style.clipPath = 'inset(0 ' + (PANEL_W - edgeX02) + 'px 0 0)';
ワイプの進行端は edge02 要素にも反映されます — 進行端に沿って積もるピクセルバーの位置がこの値で決まります。
03表型スケルトンはどう計算されるか — 列比率と行の高さ配分
名前・状態・金額・日付・操作の五列の実測内容幅(72・48・88・96・40px)を colRatio が比率に正規化し、autoFit がその比率を 404px の表にトラックとして配分します。セルは行と列を足した対角順に着き、セル内のバー幅は列比率のガンマサンプルなので、どの列も計算から外れません。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 535-03 표형 스켈레톤 — 열 비율과 행 높이 배분 (531 base 계승)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: mix($subject-cream, $subject-ink, 45%);
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 269줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 342줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
… (총 390줄 — 아래 「전체 코드」에서 원문 전체)// Skel03TableColRatioCells - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./Skel03TableColRatioCells.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
… (총 415줄 — 아래 「전체 코드」에서 원문 전체)03 · 表型スケルトン — 列比率と行の高さ配分の計算 — 計測 累積面積 26.054% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
最後のトラックが誤差を吸収する方法
table skeleton loading css の核心がこの配分にあり、実測は累積面積 26.1%・強度 54.6・動き 23/23 です。
function autoFit(ratios, total) {
const out = [];
let used = 0;
for (let i = 0; i < ratios.length; i += 1) {
if (i === ratios.length - 1) {
out.push(total - used); // 最後のトラックが丸め誤差を吸収する
}
else {
const w = Math.round(ratios[i] * total);
out.push(w);
used += w;
}
}
return out;
}
04Tailwindスケルトンは何を楽にするか — ユーティリティ構成の得損
同じカードの骨格を、左はユーティリティ文字列で、右はトークンクラスで二回組み立て、同じリズムで pulse させます。下の計器が二枚の宣言数・固有の色数・クラスの文字数をリアルタイムで数えてバーに重ねます — ユーティリティの速さとトークンの一貫性が、一つの画面で天秤にかけられます。

<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="同じカード骨格が左はTailwindユーティリティ文字列、右はトークンクラスで組み上がり、宣言数・色数・クラス長が重ね棒になる場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 535-04 Tailwind 유틸리티 — animate-pulse 구성의 득실 (531 base 계승)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: mix($subject-cream, $subject-ink, 45%);
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 293줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
… (총 390줄 — 아래 「전체 코드」에서 원문 전체)// Skel04TailwindUtilityCost - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./Skel04TailwindUtilityCost.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
… (총 415줄 — 아래 「전체 코드」에서 원문 전체)04 · Tailwindユーティリティ — animate-pulse構成の得損 — 計測 累積面積 13.308% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
宣言数と色数を数える計器
tailwind css loading skeleton の損得が数字のまま置かれます — 実測は累積面積 13.3%・強度 106.2・動き 23/23。
function countDecls(strs) {
// ユーティリティトークン1個 ≈ 宣言1個 — twStack 文字列の空白単位トークン数
let n = 0;
for (let i = 0; i < strs.length; i += 1) {
const parts = strs[i].split(' ');
for (let q = 0; q < parts.length; q += 1) {
if (parts[q].length > 0) {
n += 1;
}
}
}
return n;
}
function classLen(strs) {
let n = 0;
for (let i = 0; i < strs.length; i += 1) {
n += strs[i].length;
}
return n;
}
05ジェネレーターは何を計算するか — 行数・比率・速度からCSS出力まで
左のスライダー三つ(行数・最終行比率・速度)が動くたび、genCSS がセレクタと宣言を文字列として組み立て、右のコードパネルに CSS がタイプされていきます。出力された CSS はそのままプレビューカードに結ばれ、PULSE_S の周期で pulse するので、作ったコードがその場で骨格を描きます。

<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="行数・最終行比率・速度スライダーが動くたびCSSテキストが生成されてコードパネルに打たれ、そのCSSでプレビューカードがpulseする場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 535-05 생성기 — 줄 수·비율·속도에서 CSS 출력까지 (531 base 계승)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: mix($subject-cream, $subject-ink, 45%);
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 285줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 360줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
… (총 367줄 — 아래 「전체 코드」에서 원문 전체)// Skel05GeneratorParamOutput - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./Skel05GeneratorParamOutput.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
… (총 393줄 — 아래 「전체 코드」에서 원문 전체)05 · ジェネレーター — 行数・比率・速度からCSS出力まで — 計測 累積面積 4.83% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
出力がカードを描く順序
累積面積 4.8% と六つの中で最も狭く、強度 108.9 で最も強い — 小さく明るいコードパネルが唯一の舞台だからです(動き 23/23)。
function genCSS(n, last, pulseS) {
// セレクタ・宣言を文字列として emit — 読者がコピーして使える形そのまま
let out = '.skel-line{height:' + ROW_H + 'px;margin-bottom:' + GAP_PX + 'px;border-radius:4px;background:#e3d9c4;animation:skel-pulse ' + f1(pulseS) + 's ease-in-out infinite}\n';
out += '.skel-line:last-child{width:' + f0(last * 100) + '%}\n';
out += '@keyframes skel-pulse{50%{opacity:.45}}';
return out;
}
function emit(n, last, pulseS) {
target05 = genCSS(n, last, pulseS);
typed05 = '';
lastEmit05 = 0;
}
06画像型スケルトンで寸法予約が核の理由 — aspect-ratioとblur-up
ビューポート幅が ±18px 揺れても ratioReserve が高さを先に計算するので、予約済みの枠は跳ねず CLS バーが 0 に張り付きます。予約していない隣のパネルは同じ到着で高さが跳んで CLS が積もり、blur-up は到着後 560ms かけて blur 8px から 0 へ徐々に解けていきます。

<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="aspect-ratioで寸法を予約した箱はビューポートが変わっても高さが跳ばず、予約のない箱は画像到着で高さが跳んでCLSバーが積もる場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 535-06 이미지형 — aspect-ratio 치수 예약과 blur-up (531 base 계승)
@use "../../../../site/static/demo-tokens" as *;
@include stage($subject-cream);
$panel: mix($subject-cream, $subject-ink, 88%);
$dim: mix($subject-cream, $subject-ink, 45%);
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 281줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 347줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
… (총 374줄 — 아래 「전체 코드」에서 원문 전체)// Skel06ImageRatioBlurup - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./Skel06ImageRatioBlurup.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 535 공통 — skeleton loading css 변형 엔진 (531 core 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
… (총 399줄 — 아래 「전체 코드」에서 원문 전체)06 · 画像型 — aspect-ratio予約とblur-up — 計測 累積面積 26.937% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
ジャンプを 0 に留める予約計算
累積面積 26.9% は六つの中で最も広い — 予約済みの板と未予約の板が並んで動く場面なので、動く画素の面積が倍に広がります(強度 44.3・動き 23/23)。
let lastJump06 = -1;
let clsScore06 = 0;
function ratioReserve(w, ratio) {
return w / ratio; // aspect-ratio: w/h 予約 — 幅だけで高さが即座に決まる
}
function clsUnit(movedPx, viewportH) {
// CLS 寄与 = 移動面積 / ビューポート面積(web-vitals 近似 — 一要素の縦移動のみ)
return movedPx / viewportH;
}
作り込んだ骨格が実際に使われる画面 — フィード・ダッシュボード・ギャラリー
リストフィードの次のカード(01)、管理画面のデータ表(03)、ギャラリーのメディア枠(06)が最も多い席です。フィードやダッシュボードへのスケルトンスクリーン 実装では、01 の分布採点がプレースホルダの監査を兼ね、画像枠の寸法予約と blur-up の計算は blur-up 画像読み込み 9種 がより深く扱い、文字が届くストリーミング画面は AI チャットストリーミング が担います。
骨格が本文とずれる瞬間 — 三つの壊れ方
一つ目は均一幅です。すべてのバーを同じ幅で敷くと本文が到着する瞬間に画面が揺れ、01 が測る errArea は分布がずれるほど大きくなり、±8% に入った棒だけを適正と数える hitRate が下がります — 幅分布の指数を 2.9 に上げた性急な骨格が短い側に寄ってずれが広がるのが代表的な実例です。
二つ目は opacity だけの遷移です。スケルトンを薄れるだけで切り替えると、骨格が本文を覆った時間が体感として伸びます — 02 の対称検算で二つの曲線の和が 1 から外れると、ワイプとクロスフェードが一組として読めなくなります。
三つ目は予約のない画像です。aspect-ratio 宣言を落とすと、06 の右の板のように画像の到着瞬間に高さが跳んで CLS バーがそのまま積もります。
六つの場面の html・scss とスケルトンスクリーン react 版のソース全体をパスワード付き zip にまとめました — 開くパスワードは dnnd2xmy で、次の変形表の値はソースの定数の横にコメントで書いてあります。
分布・速度・予約を変えてみる三つの変形
定数を一つだけ変えて骨格の性格を裏返す値が zip と共に入っています。
| 変形 | 変える値 | どう変わるか |
|---|---|---|
| 文段落幅分布を性急に | s01 LIN_BINS 22 → 12・LIN_EXPO 2.0 → 2.9 | 枠が半分に減り、幅が短い側に寄って実段落とのずれが一望できるほど広がる |
| 消失エフェクトを遅く | s02 WIPE_MS 520 → 980 | ワイプがほぼ二倍に伸びて対称が崩れ、覆われた時間の体感が長くなる |
| ジェネレーター速度を下げる | s05 PULSE_S 1.5s → 2.6s | 出力 CSS の pulse 周期が遅くなり、同じ骨格でも体感の待ちが変わる |
三つの値すべてソース上部の定数にあり、コメントの値一つの書き換えで済みます。
reduce を尊重する骨格 — アクセシビリティとaria-busy
六つの場面すべてが matchMedia で prefers-reduced-motion: reduce を読みます — 六つのソースを全部数えて確認した事実です。骨格のパルスは下のひとかたまりでも止められます。
@media (prefers-reduced-motion: reduce) {
.skel { animation: none; }
}
01 は組み立ての間 aria-busy を true で宣言し、本文到着の後 false に切り替えるので、スクリーンリーダーには、骨格が飾りではなく待ち状態だということが伝わります。
skeleton loading css のよくある質問 — 導入前の三つは?
スケルトンスクリーン ui のサンプルをそのまま製品ページに貼れますか?
均一幅の静的なカードならそのまま貼って動きますが、繰り返すリストでは幅が実データと合わず、差し替えのたびに画面が揺れます — このページの zip には六つの場面すべてのソースに変形値のコメントが付き、ライブラリなしでそのまま動きます。
本文が到着する前に段落幅はどう分かりますか?
実際の段落長分布に似た曲線からサンプリングします。到着の後は骨格と実測幅を重ねて errArea と hitRate で採点するので、骨格がどれだけ合っていたかを数字で確かめられます。
骨格のパルス周期はどのくらいが適切ですか?
このデモの既定値は 1.5s です — 変形表のように周期を 2.6s に伸ばすと体感の待ちが増え、速すぎると骨格なのか画面のノイズなのか区別が難しくなります。滞在の長いリストほど遅い側が楽です。
参考資料: MDN ドキュメント aspect-ratio・prefers-reduced-motion・aria-busy









