コードブロック CSS 9種 — ウィンドウ枠・行番号・ハイライト・折りたたみ・コピーまで
コードブロックは箱ではなく計算です — 02番は行番号の桁数を数えてから溝の幅が合い、03番はトークンの範囲を決めてから色が正確に塗られ、05番は行数を測ってから折りたたみの高さが決まります。コードブロック css で検索して来た方は、このページで九つの場面をすぐ動かせます。
01 cb-window-frame-filename
02 cb-gutter-digit-width
03 cb-token-span-highlight
04 cb-copy-state-morph
05 cb-fold-height-clamp
06 cb-diff-add-remove-bg
07 cb-row-hover-track
08 cb-language-tab-crossfade
09 cb-terminal-cursor-mix
- 01 ファイル名バーと信号灯のある基本のウィンドウ枠
- 02 桁数を数えて幅を決める行番号の溝
- 03 トークン範囲に色を対応させるハイライト
- 04 押すとアイコンが変わるコピー状態ボタン
- 05 行数を測って高さを決める折りたたみ
- 06 増減行の背景幅を計算したdiffブロック
- 07 ポインターを追う行ホバー
- 08 言語タブで切り替わると交差フェードするコード
- 09 カーソルが点滅し入力を再生する端末混在ブロック
コードブロック CSS 9種 — ウィンドウ枠・行番号・トークンハイライト・コピー状態・折りたたみ・diff・行ホバー・言語タブ・端末カーソル
まず、なぜこの順番に並べたかです。01 の枠と 02 の行番号は骨組みです — コードが窓に収まり番号が付けば、もう他人のブログのような顔になります。03 のハイライトと 04 のコピーボタンがその顔に色と動きを与えます。05 の折りたたみは長さを、06 の diff は変化を、07 の行ホバーは説明を、08 の言語タブは文書構造を、09 の端末は実行の場面を担います。前の番号が後の番号の材料になります — 02 の溝がなければ 06 の diff マークに立つ場所がなく、03 のトークンがなければ 09 のコマンドの色もありません。
測定値を先に置きます。数値は 도구/demo.py が480×300の内側の箱に24枚を撮り、隣り合う二枚の差23個で読んだレンダー実測で、測定時刻は2026-11-17 05:03·05:07です。九つの場面の動きは人の手ではなく、ページが自分で進める注入デモで、pointermove・クリックで同じ判定関数を直接踏むこともできます。
| 番号 | 場面 | 累積面積 | 強度 | 動いたフレーム |
|---|---|---|---|---|
| 01 | 基本のウィンドウ枠 | 10.5% | 66.5 | 23/23 |
| 02 | 行番号の溝 | 6.3% | 91.0 | 23/23 |
| 03 | トークンハイライト | 13.7% | 65.5 | 23/23 |
| 04 | コピー状態ボタン | 10.1% | 121.8 | 23/23 |
| 05 | 折りたたみ・展開 | 14.4% | 94.5 | 23/23 |
| 06 | diff ブロック | 4.6% | 78.8 | 23/23 |
| 07 | 行ホバー | 20.3% | 87.5 | 23/23 |
| 08 | 言語タブ | 10.8% | 83.9 | 23/23 |
| 09 | 端末カーソル | 7.6% | 124.2 | 23/23 |
面積が最も大きい 07 は行の強調背景が画面の全幅を行き来する板で、05 は折りたたみの高さが窓全体を伸ばしたり縮めたりする板だからです。逆に 06 diff が 4.6% で最も小さいのは本質です — 増減の背景をコードの全幅ではなく実際の文字幅だけ塗るのがこの場面の計算の主張で、背景を無理に広げると主張が壊れます。02 の溝(6.3%)と 09 の端末(7.6%)が 10% 未満なのも同じ理由です。累積面積はフレーム間で変わったピクセルの比率、強度はそのピクセル同士の平均色差(0〜255)、動いたフレームは直前の枚と比べて変化があった枚の数です。九つの場面すべてが 23/23 なので毎フレーム何かは動いており、この値は撮影箱の中の画面変化量であって、実際のページの性能値ではありません。
01ファイル名バーと信号灯のある基本のウィンドウ枠
ブログ最初のコードブロックに付けるウィンドウ枠です。外側の枠とバーの二層が pre を包み、バーの三点は半径3pxの円三つを同じ間隔で置き、ファイル名は左から44px離れた位置にあります。

<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="縁とファイル名バーの二層の枠に同じ半径の信号灯が3つ並び、折り目の影が窓の奥行きを計算する場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 383줄 — 아래 「전체 코드」에서 원문 전체)// CbWindowFrameFilename - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbWindowFrameFilename.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 373줄 — 아래 「전체 코드」에서 원문 전체)01 · ファイル名バーと信号灯のある基本のウィンドウ枠 — 計測 累積面積 10.489% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
周期案内で窓が 0→4px 浮き上がるとき影も 0→4px 深くなりますが、両者は同じサイン曲線を共有する対なので、呼吸はずれません。
// 窓が浮かび上がる浮上(lift)と影の深さ(depth) — 同じサイン曲線を共有する対
const s = Math.sin(Math.PI * 2 * clamp(t / DEPTH_MS, 0, 1));
lift01 = t < 200 ? 0 : (1 - Math.cos(Math.PI * 2 * clamp((t - 200) / (DEPTH_MS - 200), 0, 1))) * 2;
depth01 = t < 200 ? 0 : 4 * (0.5 + 0.5 * s);
w01.el.style.transform = 'translateY(-' + f1(lift01) + 'px)';
w01.el.style.boxShadow = '0 ' + f1(4 + depth01) + 'px 0 rgba(23,20,26,0.22)';
ウィンドウ枠はどう描くか — ファイル名バーと信号灯の配置計算
DOM で描けば十行もかかりません。外側の殻一つ、その中にバー一つ、バーの中に点三つとファイル名 — 配置はこの四要素の間隔計算です。
function mkWin() {
const el = make('div', 'win', scWrap);
const b = make('div', 'cb-bar', el);
const lights = make('i', 'cb-lights', b);
for (let k = 0; k < 3; k += 1) {
make('i', 'cb-dot', lights);
}
const fname = make('b', 'cb-fname', b);
fname.textContent = 'main.scss';
const code = make('div', 'cb-code', el);
const gutter = make('div', 'cb-gutter', code);
この mkWin() は九つの場面すべてが呼ぶ共通の組み立て関数なので、枠のスタイルを一か所だけ直せば九つのコードブロックが一緒に変わります。実戦でも同じです — コードブロックUIは一つのコンポーネントとして作っておき、記事ごとに乗せて使い回すのが定石です。ライトの三点を半径3pxに統一したのも計算で、点ごとに大きさを変えると視線がバーに絡め取られ、コードへ下りていけません。バーがコード領域と接する境の影が窓の奥行きを計算し、プリセットごとにファイル名が main.scss → tokens/_map.scss → build-20261117.js と変わるのも見ておきます — ファイル名でコードの言語を知らせる習慣は 09 の端末につながります。
02桁数を数えて幅を決める行番号の溝
行番号のずれたコードブロックをよく見かけますが、原因は溝の幅を固定していないことです。この場面は総行数の桁数を数える digitCount で幅計算の材料を数え、溝の幅は桁数と無関係に GUTTER_CH 3桁で固定します。

<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="全行数の桁数を数えて溝の幅を3桁に固定し、番号を右揃えにする — 9行から100行へ超えてもコードの列が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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 383줄 — 아래 「전체 코드」에서 원문 전체)// CbGutterDigitWidth - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbGutterDigitWidth.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 374줄 — 아래 「전체 코드」에서 원문 전체)02 · 桁数を数えて幅を決める行番号の溝 — 計測 累積面積 6.313% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
98行(2桁)·9行(1桁)·100行(3桁)の三枚の板を通っても、コードの開始列が1ピクセルも動かないのが証拠です。
function digitCount(n) {
let d = 1;
let v = n;
while (v >= 10) {
v = Math.floor(v / 10);
d += 1;
}
return d;
}
行番号がずれる理由 — 桁数を数える溝幅の計算
桁数を数えるのは割り算二回で足ります — 98 は 10 で二回割れるので2桁、100 は三回割る必要があるので3桁です。溝の幅をどの単位で固定するかが実戦の焦点で、等幅フォントでは ch 単位が正確です — 1ch は数字の0一つの幅なので、GUTTER_CH 桁の溝を width: 3ch と宣言すれば桁数と文字幅が同時に合います。ピクセルで固めるとフォントを変えた瞬間にずれます。caniuse 2026-11-17 確認で ch 単位は全体の 98.7% · Chrome 26+ · Firefox 1+ · Safari 7+ です。
残る計算は番号の右揃えです。前に空白を詰めて(fmt2)すべての番号の終わりの桁を同じにすれば、1 と 100 が同じ列に立ちます。溝とコード行を別々の絶対位置に置くとスクロール・折り返しでずれますが、この九つの場面は溝と行の組を同じコンテナの兄弟に置き、同じ translateY を共有します — 配置が整列を保証します。バーの下を行が流れていくときも番号とコードは同じ transform に乗るので、ずれが入る隙がありません。行番号UI全体に興味があれば行番号インターフェースのまとめにこの計算の別の板を集めてあります。
03トークン範囲に色を対応させるハイライト
文字列・数値・コメントがそれぞれ色を持つコードブロックの裏側はトークン分割です。この場面のミニハイライターは、コード一行を種類ごとの範囲(span)に分け、TOKEN_KIND 4種(キーワード·文字列·数値·コメント)に色を一対一で対応させます。

<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="トークンを種類ごとの範囲に分けて4色を一対一で対応させ、コメント内の文字列がコメント色を保つ境界判定の場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 402줄 — 아래 「전체 코드」에서 원문 전체)// CbTokenSpanHighlight - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbTokenSpanHighlight.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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줄 — 아래 「전체 코드」에서 원문 전체)03 · トークン範囲に色を対応させるハイライト — 計測 累積面積 13.706% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
核は、正規表現の順序がそのまま優先順位だということです — コメントの規則が文字列より先に範囲を取るので、コメントの中の 'gutter' が文字列の色で塗られることはありません。
const RE_COMMENT = /(^|\s)\/\/[^\n]*/y;
const RE_STR = /'[^'\n]*'|"[^"\n]*"/y;
const RE_NUM = /\b\d+(\.\d+)?\b/y;
const RE_KW = /\b(const|let|function|return|if|else|for|while|import|from|export|var|new|class)\b/y;
// tokenize — ソース一行をトークン範囲(Tok[])に分ける。句読点一つがどのトークンに属するかの
// 境界(boundary)を決めるこの計算が、ハイライトの正確さを決める
function tokenize(line) {
const out = [];
const rules = [[RE_COMMENT, 3], [RE_STR, 1], [RE_KW, 0], [RE_NUM, 2]];
ハイライト色はどこから来るか — トークン範囲を決めて色を対応させる計算
塗りのスイープが上から下へ通り抜け、デモコード4行のトークン13個を順に塗り、コメントの中の 'gutter' だけコメントの色で残すのが境界の証拠です。正規表現テーブルで取った範囲を別の規則が再検査しないという規則までがハイライトのすべてで、ここまでが自作の実装です — 検証を終えた精度より高いものが必要になったときに、ライブラリを検討すれば十分です。
ひとつ区別しておく点があります。TOKEN_KIND はハイライト場面のソースではなく、九つの場面が共有する共通エンジンの定数です。溝の番号を描く組み立て関数と端末のコマンド色が同じ対応を参照するので、この値を変えると一つの場面ではなく九つの場面のトークン色が一緒に変わります — 変化の節で7に上げてみるのもこの共通定数です。色の割り当てはトークン種類数と同じ長さの配列で、種類を増やすとエディターに近づく代わり、種類が少なければ本文の中でコードがくっきり目立ちます。どちらが正しいかはブログの本文のトーンが決めることで、正解のある数ではありません。実戦の記事の数十行のコードでも同じ規則がそのまま回ります — 種類数と規則の順序さえ保てば行数は関係ありません。
04押すとアイコンが変わるコピー状態ボタン
コピーされたことを色だけで知らせると、色覚によっては見えません。このボタンは通常・コピー中・完了の三状態を持ち、クリックの瞬間にコピーアイコンの経路をチェックへ変え、完了の文が一緒に出ます。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 491줄 — 아래 「전체 코드」에서 원문 전체)// CbCopyStateMorph - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbCopyStateMorph.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 462줄 — 아래 「전체 코드」에서 원문 전체)04 · 押すとアイコンが変わるコピー状態ボタン — 計測 累積面積 10.143% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
完了バッジがボタンの下に降りてきて、窓の枠がミント #4cd4a6 で一度染まるまで、四重のフィードバックです。
const k = clamp((t - tc) / COPY_MS, 0, 1);
svg04.setAttribute('d', k < 0.5 ? ICON_COPY : ICON_CHECK);
svg04.setAttribute('stroke-dasharray', f1(k * 24));
}
else if (t < tc + COPY_MS + DONE_MS) {
st04 = 'done';
svg04.setAttribute('d', ICON_CHECK);
svg04.setAttribute('stroke-dasharray', '24');
btn04.classList.add('is-done');
live04.style.opacity = '1';
live04.textContent = 'コードをクリップボードにコピーしました';
// 完了バッジがボタンの下へ滑り落ちてくる — 状態切り替えが遠くからでも見える
badge04.style.transform = 'translateY(0) scale(1)';
badge04.style.opacity = '1';
// 完了の瞬間、窓の枠もミントで一度染まる — 状態が窓全体に広がるフィードバック
if (w04) {
w04.el.style.borderColor = '#4cd4a6';
}
コピーボタンはどう信頼させるか — アイコンの変形と完了フィードバックの状態切り替え
完了の文「コードをクリップボードにコピーしました」は role="status" aria-live="polite" で読み上げられ、DONE_MS 560ms 後に自分で消えて待機状態へ戻ります。実際のコピー機能は、ページに載せるとき navigator.clipboard.writeText 一行で足り、ボタンは本物の <button> なのでキーボードでも押せます。
完了を形で知らせるボタンが信頼を得る理由を、もう一度ほどきます。「コピー済み」の文字が表示されて消えるボタンは結果が画面の隅でだけ読めますが、アイコンが裏返るボタンはクリックした指の隣で変わります — 目を動かさなくても結果が確認できることが操作への信頼につながります。状態数を三つに固定したのも計算で、エラー状態を入れるにはクリップボード権限の拒否用の四つ目が必要になります。実戦では権限拒否はまれなので、三つで始めてエラーが観測されたら四つ目を足す順をおすすめします。このデモでボタンを押すと、デモの時間割に関係なく同じ状態機械がすぐ動きます。
05行数を測って高さを決める折りたたみ
コードが長くなると窓ではなくページが食われます。この場面はコードの実際の行数を測り、FOLD_MAX_LINES 14行の高さで切り、展開は全体の行数の高さを目標にした transition で続きます。

<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="実際の行数を測って14行の高さで切り、開くときはscrollHeightを目指し、しきい値未満のコードには折りたたみボタンが現れない場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 431줄 — 아래 「전체 코드」에서 원문 전체)// CbFoldHeightClamp - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbFoldHeightClamp.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 415줄 — 아래 「전체 코드」에서 원문 전체)05 · 行数を測って高さを決める折りたたみ — 計測 累積面積 14.366% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
20行のコードは14行の高さ(84px)で切られ、展開すると 120px まで伸びます。10行の板では行数がしきい値未満なので、折りたたみボタンは最初から現れません。
// 200ms ボタン出現 → 800ms 展開 → 1500ms 再び折りたたみ — 高さは毎フレーム ease で補間される
tgtH05 = t < 800 ? FOLD_MAX_LINES * ROW_PX : (t < 1500 ? total * ROW_PX : FOLD_MAX_LINES * ROW_PX);
// 慣性イージング(lerp 0.18) — クランプ高(14行)とscrollHeight(20行)の間をなめらかに行き来する
curH05 = lerp(curH05, tgtH05, 0.18);
w05.code.style.height = f0(curH05) + 'px';
// 枠も高さの変化だけ一緒に伸びる — 折りたたみ高と窓の高さが一つの体で動く
w05.el.style.height = f0(18 + curH05 + 8) + 'px';
// 下端フェード — 切れた位置を知らせる折りたたみマスク(展開の瞬間に消える)
長いコードはどう畳むか — 行数を測って高さを決める折りたたみ・展開
切れた位置には下へ消えていくフェードマスクが付き、展開の瞬間に消えます — このマスクが折りたたみ状態の顔です。折りたたみボタンはバーの右側の本物の <button> で、aria-expanded で状態を示し、キーボードで操作できます — 実戦のコードにそのまま移すべき部分はこのボタンの属性一式で、デモで人が押しても時間割に関係なく同じクランプ計算を通ります。
長いコードの扱いは二通りあり、この場面は折りたたみを選びました。横スクロールにすると行は保たれますが、画面でコードを読むには手が往復しなければならず、折りたたみは縦に圧縮しながら全体を残します — 切れた14行で内容を目次のように推測させ、展開で全文を開きます。しきい値を決める実務の基準はこうです。最初の画面でコードブロックが本文を押し出してはいけないので、しきい値はビューポート高の半分あたりから始めて12〜16行が無難で、説明の付いた行がしきい値内に収まるようにコードの配置を先にしてからしきい値を合わせるのもこつです — このデモの14もそうやって決めた値です。展開の後のボタンのラベル(「折りたたむ」)まで状態と一緒に変わって完成です。
06増減行の背景幅を計算した diff ブロック
コードレビューで変更の前後を見せるブロックです。行ごとに増減(+·−)マークを付け、追加・削除の背景をコードの全幅ではなく実際の文字幅に合わせて塗り、削除行には取り消し線も加わり、背景の幅がそのまま変化量になります。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 431줄 — 아래 「전체 코드」에서 원문 전체)// CbDiffAddRemoveBg - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbDiffAddRemoveBg.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 418줄 — 아래 「전체 코드」에서 원문 전체)06 · 増減行の背景幅を計算したdiffブロック — 計測 累積面積 4.613% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
before 4行と after 5行が620ms間隔で二回切り替わり、背景は切り替えの後 800ms かけて 0 から文字幅まで伸びます — 行全体に背景を塗ると短い行の変更がどこまでか分からなくなり、画面の半分が色帯になってコードがかえって消えるので、幅を文字数だけに限るのが読みやすさの答えです。
// 背景・取り消し線は文字幅だけを塗る — 切り替えの後 800ms かけて背景が 0 から文字幅まで伸びる
for (let k = 0; k < bg06.length; k += 1) {
bg06[k].style.opacity = '1';
const rowTxt = rows06[k % rows06.length] ? rows06[k % rows06.length].text : '';
bg06[k].style.width = f0(rowTxt.length * 5.4 * clamp((t - t0) / 800, 0, 1)) + 'px';
}
コードブロックが壊れる落とし穴 — 横スクロールと折り返しの衝突・tab-sizeのブラウザ差
このコードブロックUIを作りながら実際にぶつかった七つの場所を、再現方法と修正とともに書きます。
一つ目、white-space: pre なしに pre を置くと改行が崩れます。pre 要素は改行を守るように見えますが、CSS で壊せます — normal にすると連続する空白が一つに潰れ、インデントが消えて、溝の番号とコードがすべてずれます。このデモの .cb-code は white-space: pre で守りました。caniuse 2026-11-17 確認で white-space: pre は全体の 99.99% です — 事実上無限のサポートなので、問題は対応ではなく宣言の漏れです。
二つ目、tab-size のブラウザ既定値はそれぞれ違います。Chrome 8 · Firefox 4 · Safari 8 とまちまちで、タブインデントのコードをそのままにするとブラウザごとにインデント幅が変わり、溝の整列が揺れます。このデモは tab-size: 2 で固定し、最初からスペースインデントを使っています。caniuse 確認で tab-size は全体の 96.4% · Chrome 21+ · Edge 79+ · Firefox 4+ · Safari 21+(2023)です — Safari 20 以下ではタブ幅を固定できないので、スペースインデントが唯一の回避になります。
三つ目、横スクロールと折り返しを同時にオンにすると二重スクロールができます。overflow-x: auto(pre)と white-space: pre-wrap は排他です — wrap をオンにすると長い行が折り畳まれ、溝の番号と行の対応が壊れ、オフにするとコードが窓の外へ流れます。このデモはコードを40字前後に切って両方を避けました。幅の狭い画面で wrap を選ぶなら、溝は各行の最初の断片にだけ付く点を考慮してください。
四つ目、溝の幅をマージンの推定値で固めると100行でずれます。たとえば 40px で固めた溝に3桁の番号が入ると、番号がコードの下に潜ります。桁数を数える 02 の計算 — ch 単位の固定と右揃え — が唯一の安全策です。
五つ目、折りたたみに max-height を使うと transition が切れます。max-height は実際の高さより大きく与えなければならず、大きくするほど開始が遅れて遅延のように見えます。実際の行数を測り、クランプ高と目標の高さを直接計算するのが 05 の方法です。
六つ目、トークンの正規表現の順序を間違えると色が裏返ります。文字列の規則をコメントより先に置くと、コメントの中の「テキスト」が文字列の色で塗られます。コメント→文字列→キーワード→数値の順序が答えで、取った範囲を再検査しないことまでが規則です(03 のデモ)。
七つ目、言語タブの切り替えで高さを先に固定しないと窓が跳ねます。タブごとに行数が違うと、切り替えの瞬間に窓の高さが縮んだり伸びたりします。二つのコードの scrollHeight の大きい方へ先に固定する 08 の計算が答えです。
値を変えてみる違い
三つの変化は、それぞれ定数一つだけ変えた前後をその場面で直接見られます。
| 名前 | 変える値 | 感じ |
|---|---|---|
| 折りたたみ高を下げる | 05 FOLD_MAX_LINES 14 → 8 | 20行のコードが14行ではなく8行(48px)で切られ、目次のように一目で収まります — クランプ高は 84px→48px、展開の目標はそのまま全体の高さです |
| ハイライト色数を増やす | 03 TOKEN_KIND 4 → 7 | キーワード·文字列·数値·コメントに関数·属性·演算子まで色が増え、エディターに近づきます — この定数は共通エンジンの値なので、九つの場面のトークン色が一緒に変わります |
| 溝の桁幅を広げる | 02 GUTTER_CH 3 → 4 | 100行のコードでも番号がコードに届かない、息をする余白ができます — 桁数と無関係に固定される値なので、100行(3桁)で一桁分の余裕が残ります |
三つの変化値はすべてソースの定数ブロックにコメントで書いてあるので、zip を開いて一文字だけ変えれば済みます。九つの場面のソースとreact版をまとめたzipは下の箱から受け取れて、開くときのパスワードは 6n8b8hr6 です。溝・トークン・折りたたみの計算がライブラリなしで何行なのかを、コードで直接確かめられます。
07ポインターを追う行ホバー
説明しながらコードを指す読み合わせに使う場面です。y 座標を行の高さ ROW_H 24px で割って端数を捨てると行インデックスが出て、背景がその行の上端へ移動し、溝の番号まで一緒に濃くなるので、指す行が番号とコードの両方で読めます。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 412줄 — 아래 「전체 코드」에서 원문 전체)// CbRowHoverTrack - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbRowHoverTrack.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 400줄 — 아래 「전체 코드」에서 원문 전체)07 · ポインターを追う行ホバー — 計測 累積面積 20.278% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
ROW_H は商を出す除数なので正確に固定されていなければならず、line-height と行の高さがずれるとポインターが二行の間を指す瞬間に強調が一行遅れます。デモではポインターは y 40→176px をサイン曲線で上下し、人の pointermove も舞台座標への変換の後、同じ商を出します。
// indexMath — floor(y / ROW_H) で行インデックスを計算する(0起点)
idx07 = Math.floor(y07 / ROW_H);
const top = idx07 * ROW_H;
hi07.style.transform = 'translateY(' + f0(top) + 'px)';
ptr07.style.transform = 'translateY(' + f0(y07 - 5) + 'px)';
for (let k = 0; k < nos07.length; k += 1) {
nos07[k].style.color = k === idx07 ? '#17141a' : '';
nos07[k].style.fontWeight = k === idx07 ? '700' : '';
}
08言語タブで切り替わると交差フェードするコード
同じ機能を html·css·js に分けて見せる文書の板です。タブを切り替えると前のコードは上へ抜け、新しいコードが下から上がる逆方向の動きが重なり、窓の高さは三つのコードの scrollHeight の大きい方へ先に固定してあるので、切り替えの途中で窓が跳ねません。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 431줄 — 아래 「전체 코드」에서 원문 전체)// CbLanguageTabCrossfade - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbLanguageTabCrossfade.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 410줄 — 아래 「전체 코드」에서 원문 전체)08 · 言語タブで切り替わると交差フェードするコード — 計測 累積面積 10.799% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
交差の進行率に cubic-ease を乗せて二つのパネルを逆方向へ動かす数行が切り替えをなめらかにし、タブは role="tab" と aria-selected を持つ本物のボタンなので、キーボードでも巡回できます。
// crossfade — 上へ抜けるのと下から上がるのの重なり(なめらかな k)
const e = 1 - Math.pow(1 - k, 3);
for (let j = 0; j < 3; j += 1) {
if (j === li) {
panels08[j].style.opacity = '1';
panels08[j].style.transform = 'translateY(' + f0((1 - e) * h08) + 'px)';
}
else {
panels08[j].style.opacity = k < 0.5 ? f2(1 - e) : '0';
panels08[j].style.transform = 'translateY(' + f0(-e * h08) + 'px)';
09カーソルが点滅し入力を再生する端末混在ブロック
コマンドと結果を一つの窓に見せるチュートリアルの板です。プロンプト·コマンド·カーソル·結果が一つの窓に混ざり、コマンド npm run build は TIME_GAP 90ms 間隔のタイプ再生で一文字ずつ満ち、240ms の停止を経て結果の三行が120ms間隔で続きます。

<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="コマンドが90ミリ秒間隔のタイプ再生で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줄 — 아래 「전체 코드」에서 원문 전체)// 528 공통 — 코드 블록 UI (527 base.scss 계승, 시트 요소를 코드 창·토큰·거터로)
@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;
… (총 519줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #fff7e6;
… (총 611줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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; }
… (총 415줄 — 아래 「전체 코드」에서 원문 전체)// CbTerminalCursorMix - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./CbTerminalCursorMix.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 528 코드 블록 공통 — 무대 좌표·문구 틀·요소 조립·토크나이저 엔진 (527 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); }
… (총 401줄 — 아래 「전체 코드」에서 원문 전체)09 · カーソルが点滅し入力を再生する端末混在ブロック — 計測 累積面積 7.556% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
全体で 150 + 13×90 + 240 + 3×120 = 1,920ms で2秒周期に収まり、カーソルの点滅は 1,060ms 周期で、入力の停止と再開を同時に知らせます。
// タイプ再生 — typed = floor((t-T0)/TIME_GAP) 文字(決定的)
typed09 = clamp(Math.floor((t - T0) / TIME_GAP), 0, CMD.length);
cmd09.textContent = CMD.slice(0, typed09);
const typing = typed09 < CMD.length && t >= T0;
// カーソルは最後の文字の後ろ — caret x = プロンプト幅 + 文字幅
const cx = 24 + typed09 * 5.4;
caret09.style.left = f1(cx) + 'px';
caret09.style.opacity = typing ? '1' : '0';
// 結果 — コマンド完了 + PAUSE の後、一行ずつ
const r0 = T0 + CMD.length * TIME_GAP + PAUSE;
コードブロックUIはどこで使うか — ブログ・ドキュメント・チュートリアルでの使い方
code block css example で検索する場所は、ほとんど三か所に集まります。技術ブログの本文のコード(01·02·03)、製品ドキュメントとAPIドキュメントの例(05·06·08)、CLI チュートリアルとセットアップガイド(09)です。三か所ともこの記事と同じ骨組み — 枠と溝と white-space — の上にあり、要求が増えるほどコピー状態(04)と行ホバー(07)を一層ずつ重ねる順です。
ブログに載せるときの実務の判断を一つ書きます。ハイライトの色数は本文の散文の密度が決めます。本文が短くコードが主の記事ならトークンの色を増やして(変化の7のように)コードがエディターのように読めるようにし、本文が長い記事なら色を減らして(4)散文とコードの対比を立てます。色が多いほど良いのではなく、画面でコードがどこまで読めるかが基準です。
ドキュメント·チュートリアル側では 08 と 09 がよく会います。一つの機能を html コードブロック css·js に分けて見せる文書はタブの切り替えが多く、高さの跳ねが体感的に一番大きい欠陥です。CLI ガイドは読者にコマンドを打たせるより再生して見せるほうが離脱が減ります。markdown で記事を書くブログなら、markdown コードブロック css も結局は同じ要素のスタイリングで — この九つの場面の計算がそのまま当てはまります。
キーボード操作と動きの軽減 — アクセシビリティと reduced-motion
場面の状態切り替えはすべてキーボードで届きます。折りたたみボタンとタブとコピーボタンは本物の <button> なので Tab で移動し Enter·Space で操作でき、タブは aria-selected で、折りたたみは aria-expanded で状態を示します。コピーの結果は「コードをクリップボードにコピーしました」の文が role="status" aria-live="polite" で読み上げられるので、色が見えない読者も完了を文で受け取ります。Space で一時停止、R で最初から、←→ でプリセットを変えます。デモのコードブロックは場面の中のテキストなので lang 属性ではなくファイル名と文で言語を示しますが、実戦のページでは code 要素に lang 属性で言語を書く習慣が同じ役割を果たします。
prefers-reduced-motion がオンになると、変形・タイプ・交差の動きは終わった状態の一枚で描かれます — 入力を受けてもすぐ完了状態を描くので、画面が反応しないことはありません。caniuse 2026-11-17 確認で prefers-reduced-motion は Chrome 74+ · Firefox 63+ · Safari 10.1+ です — 持っていく基本のフォールバックは下のとおりです。
@media (prefers-reduced-motion: reduce) {
.cb-code { transition: none; }
.tcaret { animation: none; }
}
関連記事はブラウザコードエディタUI · 埋め込みコードUIパターン · SVG 線描画アニメーションに続きます。出典: MDN white-space · MDN tab-size · MDN pre · MDN prefers-reduced-motion
コードブロックUIのよくある質問 — CSSだけ・ずれる行番号・自作ハイライト
コードブロック css は CSS だけどこまでできますか
ウィンドウ枠・行番号・折りたたみ高・diff 背景・行ホバーの色と配置は CSS の役目ですが、行数を測る折りたたみ判定、トークンを分けるハイライト、コピー状態機械、タブ切り替えの高さ固定は JavaScript の役目です。この記事の九つの場面で CSS が骨組みを描き JS が計算を乗せる分担が、そのまま実戦の分業です。
行番号がコードとずれるのですが、なぜですか
溝の幅をピクセルの推定値で固めたか、スクロールのとき溝とコードを別々に動かした可能性が高いです。溝の幅を ch 単位で桁数だけ固定し、番号を右揃えにして(02 の場面)、溝と行の組を同じ transform で動かせば直ります。white-space: pre が抜けてインデントが崩れた場合も同じ症状で出ます。
ハイライトの色は自作してもいいですか
はい、この記事の 03 の場面が正規表現四つでトークンを分ける自作の実装です。規則の順序(コメント→文字列→キーワード→数値)さえ守れば、コメントの中の文字列が誤って塗られる事故は起きません。コードの言語が増え、境界が複雑になったときに、検証済みのハイライターを取り入れる順をおすすめします — ライブラリが先ではなく、自分の規則が先です。








