GODRICH
#cssアニメーション#ボタン#ローディング#トランジション#スクロール#ダッシュボード#実用ui#デザイントレンド

スケルトンローディング CSS 6種 — マークアップから画像まで

スケルトンローディングは灰色の棒ではなく計算だ — 段落幅はテキスト分布から、表のセルは列比率から、画像寸法はaspect-ratio予約から出る。CSSでローディング状態を作る六つの道を規則計算だけで再現する。六つのシーンすべて、骨格の幅と速さと寸法を実測と定数の算術で組み立てるところを見せます。

zip の中身と開き方

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 に設定して待ち状態を伝え、本文の幅が公開される瞬間には、骨格と実測幅のずれがバンドとして重なって見えます。

マークアップ構造型 — セマンティック骨格とaria-busy
全文コード 新しいタブで開く

01 · マークアップ構造型 — セマンティック骨格とaria-busy — 計測 累積面積 10.763% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

cdfInvertaria-busymkBones

本文到着後の採点 — 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 の間、互いを鏡のように映します。

出現・消失エフェクト — クロスフェードとワイプの対称
全文コード 新しいタブで開く

02 · 出現・消失エフェクト — クロスフェードとワイプの対称 — 計測 累積面積 20.578% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

crossFadewipeXWIPE_MS

二つの曲線が鏡になる条件

実測は累積面積 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 の表にトラックとして配分します。セルは行と列を足した対角順に着き、セル内のバー幅は列比率のガンマサンプルなので、どの列も計算から外れません。

表型スケルトン — 列比率と行の高さ配分の計算
全文コード 新しいタブで開く

03 · 表型スケルトン — 列比率と行の高さ配分の計算 — 計測 累積面積 26.054% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

colRatioautoFitstaggerZ

最後のトラックが誤差を吸収する方法

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 させます。下の計器が二枚の宣言数・固有の色数・クラスの文字数をリアルタイムで数えてバーに重ねます — ユーティリティの速さとトークンの一貫性が、一つの画面で天秤にかけられます。

Tailwindユーティリティ — animate-pulse構成の得損
全文コード 新しいタブで開く

04 · Tailwindユーティリティ — animate-pulse構成の得損 — 計測 累積面積 13.308% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

twStackbemMatchtokDiff

宣言数と色数を数える計器

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 するので、作ったコードがその場で骨格を描きます。

ジェネレーター — 行数・比率・速度からCSS出力まで
全文コード 新しいタブで開く

05 · ジェネレーター — 行数・比率・速度からCSS出力まで — 計測 累積面積 4.83% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

genCSSPULSE_Semit

出力がカードを描く順序

累積面積 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 へ徐々に解けていきます。

画像型 — aspect-ratio予約とblur-up
全文コード 新しいタブで開く

06 · 画像型 — aspect-ratio予約とblur-up — 計測 累積面積 26.937% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る

ratioReserveBLUR_MSedgeSweep

ジャンプを 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

解凍パスワードを入力してください

パスワードはこの記事の本文の中にあります。読み進めると出てきます。