code block css 코드 블록 9종 — 창틀·줄번호·하이라이트·접기·복사
코드 블록은 상자가 아니라 계산이다 — 02번은 줄번호의 자릿수를 세야 거터 폭이 맞고, 03번은 토큰의 범위를 정해야 색이 정확히 칠해지며, 05번은 코드의 줄 수를 재야 접힘 높이가 정해진다. 창틀 하나에 자릿수·범위·줄 수의 산술이 한 겹씩 깔려 있다.
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="테두리와 표시줄의 두 겹 창틀에서 라이트 세 점이 같은 반지름으로 놓이고 접힘 그림자가 창의 깊이를 계산하는 장면"></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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
주기 안내에서 창이 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="총 줄 수의 자릿수를 세어 거터 폭을 세 자리로 고정하고 번호를 오른쪽 정렬로 두어 아홉 줄에서 백 줄로 넘어가도 코드 열이 한 픽셀 안 움직이는 장면"></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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
98줄(2자리)·9줄(1자리)·100줄(3자리) 세 판을 지나도 코드 시작 열이 한 픽셀 안 움직이는 게 증거다.
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="토큰을 종류별 범위로 쪼개 네 가지 색을 일대일로 매핑하며 주석 안의 문자열이 주석 색을 유지하는 경계 판정의 장면"></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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
핵심은 정규식의 순서가 곧 우선순위라는 것 — 주석 규칙이 문자열보다 먼저 범위를 잡으면 주석 안의 '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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
완료 배지가 버튼 아래로 내려오고 창 테두리가 민트 #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="실제 줄 수를 재어 열네 줄 높이에서 잘라 두고 펼침은 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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
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) — clamp 높이(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 로 상태를 밝히며 키보드로 조작된다 — 실전 코드에 그대로 옮길 부분은 이 버튼의 속성 셋이고, 데모에서 사람이 눌러도 시연 시각표와 무관하게 같은 clamp 계산을 탄다.
긴 코드를 다루는 방법은 두 갈래고 이 장면은 접기를 골랐다. 가로 스크롤로 두면 줄은 보존되지만 화면에서 코드를 읽으려면 손이 왕복해야 하고, 접기는 세로로 압축하되 전체는 살려 둔다 — 목차처럼 잘린 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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
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 2026-11-17 확인으로 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 는 실제 높이보다 크게 줘야 하고 크게 줄수록 시작이 늦어져 지연처럼 보인다. 실제 줄 수를 재 clamp 높이와 목표 높이를 직접 계산하는 게 05 의 방식이다.
여섯째, 토큰 정규식 순서를 잘못 매기면 색이 뒤집힌다. 문자열 규칙을 주석보다 먼저 두면 주석 안의 '텍스트' 가 문자열 색으로 칠해진다. 주석→문자열→키워드→숫자 순서가 답이고, 잡힌 범위를 다시 검사하지 않는 것까지가 규칙이다(03 시연).
일곱째, 언어 탭 전환에 높이를 미리 고정하지 않으면 창이 뛴다. 탭마다 줄 수가 다르면 전환 순간 창 높이가 줄었다 늘어난다. 두 코드의 scrollHeight 중 큰 쪽으로 미리 고정하는 08 의 계산이 답이다.
값을 바꿔 본 차이
세 변형은 각각 상수 하나만 바꾼 전후를 그 장면에서 직접 볼 수 있다.
| 이름 | 바꾼 값 | 느낌 |
|---|---|---|
| 접힘 높이를 낮춰 | 05 FOLD_MAX_LINES 14 → 8 | 20줄 코드가 14줄이 아니라 8줄(48px)에서 잘려 목차처럼 한눈에 들어온다 — clamp 높이 84px→48px, 펼침 목표는 그대로 전체 높이다 |
| 하이라이트 색 수를 늘려 | 03 TOKEN_KIND 4 → 7 | 키워드·문자열·숫자·주석에 함수·속성·연산자까지 색이 늘어 에디터에 가까워진다 — 이 상수는 공용 엔진 값이라 아홉 장면의 토큰 색이 함께 바뀐다 |
| 거터 자릿수 폭을 넓혀 | 02 GUTTER_CH 3 → 4 | 백 줄짜리 코드에서도 번호가 코드에 닿지 않는 숨 쉬는 여백이 생긴다 — 자릿수와 무관하게 고정되는 값이라 100줄(3자리)에서 한 자리 여유가 남는다 |
세 변형 모두 소스 상수 블록에 주석으로 변형값이 함께 적혀 있어 zip 을 열어 한 글자만 바꾸면 된다. 아홉 장면의 소스와 react 판을 모은 zip 을 아래 상자에서 받을 수 있고, 열 때 쓰는 암호는 6n8b8hr6 이다. 거터·토큰·접힘의 계산이 라이브러리 없이 몇 줄인지 코드에서 직접 확인할 수 있다.
07포인터를 따라가는 행 강조 호버
설명하며 짚어 주는 코드 리딩에 쓰는 장면이다. y 좌표를 행 높이 ROW_H 24px 로 나눠 바닥을 버리면 행 인덱스가 나오는데, 배경이 그 줄의 top 으로 이동하고 거터의 번호까지 같이 진해져 짚는 줄이 번호와 코드에서 동시에 읽힌다.

<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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
교차의 진행률에 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="명령이 90ms 간격의 타이핑 재생으로 한 글자씩 차고 멈춤 뒤 결과가 이어지며 커서의 깜빡임이 멈춤과 재개를 알리는 장면"></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 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기
전체가 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 code block 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 를 만들며 자주 묻는 질문 — FAQ
code block css 는 CSS 만으로 어디까지 되나요
창틀·줄번호·접힘높이·diff 배경·행 호버의 색과 배치는 CSS 몫이지만, 줄 수를 재는 접힘 판정, 토큰을 가르는 하이라이트, 복사 상태 기계, 탭 전환의 높이 고정은 자바스크립트 몫입니다. 이 글의 아홉 장면에서 CSS 가 뼈대를 그리고 JS 가 계산을 얹는 구분이 그대로 실전의 분업입니다.
줄번호가 코드와 어긋나는데 왜 그런가요
거터 폭을 픽셀 추정치로 굳혔거나 스크롤할 때 거터와 코드를 따로 움직였을 가능성이 큽니다. 거터 폭을 ch 단위로 자릿수만큼 고정하고 번호를 오른쪽 정렬한 뒤(02 장면), 거터와 줄 묶음을 같은 transform 으로 움직이면 잡힙니다. white-space: pre 가 빠져 들여쓰기가 무너진 경우도 같은 증상으로 나옵니다.
하이라이트 색은 직접 만들어도 되나요
네, 이 글의 03 장면이 정규식 네 개로 토큰을 가르는 직접 구현입니다. 규칙의 순서(주석→문자열→키워드→숫자)만 지키면 주석 안의 문자열이 잘못 칠해지는 사고가 없습니다. 코드 언어가 많아지고 경계가 복잡해지면 그때 검증된 하이라이터를 가져오는 순서를 권합니다 — 라이브러리가 먼저가 아니라 내 규칙이 먼저입니다.








