マウス 追従 アニメーションで作るスポットライト 9種 — 半径と減衰の計算
スポットライトは円を描くことではなく距離を計算することです — 01番はカーソル座標を%に対応させてradial-gradientの中心を動かし、02番は光源半径から各ピクセルまでの距離をガウス曲線で減衰させ、04番は2〜3個の光源の明るさを1ピクセルに足し合わせます。
02 sl-gaussian-falloff
03 sl-mask-reveal-content
04 sl-multi-light-sum
06 sl-gallery-grid-cell
07 sl-hero-lerp-inertia
08 sl-tap-pulse-touch
09 sl-focus-visible-light
- 01 カーソル座標を%に写して動かす基本のスポットライト
- 02 距離ごとに明るさが変わるガウス減衰
- 03 光が通ると文字を現すマスク反転
- 04 三つの光源の明るさを1ピクセルに足す複数照明
- 05 getImageDataでピクセルが目覚めるcanvasの光
- 06 セルの境界を判定して照らすギャラリーの部分照明
- 07 慣性で遅れて追うヒーローの静かな追従
- 08 タップした場所から広がるタッチ用の波
- 09 キーボードフォーカスを受けた要素を明るくする照明
最小の形は、pointermove が渡すpx座標を二つ、領域の大きさで割って%へ変える二行です — その値を radial-gradient の中心に差し込めば、カーソルのある場所だけが明るくなる舞台ができあがります。残りの七つは、その上に減衰曲線・複数光源の合計・canvasのピクセル処理という計算の層をひとつずつ重ねていきます。スポットライト css の見た目の柔らかさも、光源の重なりの深みも、みなこの二行の座標の上に載っています。
九つの場面の順番は、計算が薄いものから厚いものへと積み上がる向きです。01が座標を%へ写す二行の算術、02がその光の質をガウス曲線で決め、03は同じ文を暗い層と明るい層に重ねて光の当たった側だけを読ませる反転、04は光源複数の寄与を合計します。05はcanvasへ降りてピクセルひとつひとつが独自の位相で目覚め、06はギャラリーの格子のセル単位で照明を割り当て直します。07はヒーロー背景に静かな慣性を、08はマウスのない画面のためのタップの波を、09はキーボードフォーカスを追う照明で締めくくります。
八つの場面が39%前後に揃う理由 — 累積面積が教えるもの
数値は 도구/demo.py が480×300の箱を24枚で撮り、隣り合う二枚の差23個で動きを測った実測です。測定時刻は2026-11-16 01:28〜01:29です。デモの自動再生は、決定的に注入された座標と時刻によるものであって人の手操作ではありません — 測定値を読むときはこの区切りを一緒に覚えておきます。
九つの場面の測定値
| 場面 | 累積面積 | 強度 | 動いたフレーム |
|---|---|---|---|
| 01 %対応の基本追従 | 39.0% | 43.0 | 23/23 |
| 02 ガウス距離減衰 | 39.5% | 40.6 | 23/23 |
| 03 マスク反転の表示 | 9.9% | 91.9 | 23/23 |
| 04 複数光源の合計 | 39.0% | 44.6 | 23/23 |
| 05 canvasの光の粒 | 13.9% | 48.2 | 23/23 |
| 06 ギャラリーの部分照明 | 39.6% | 36.7 | 23/23 |
| 07 ヒーローの慣性追従 | 39.2% | 45.2 | 23/23 |
| 08 タップの波の拡散 | 39.1% | 62.0 | 23/23 |
| 09 キーボードフォーカスの照明 | 2.2% | 120.9 | 23/23 |
累積面積は、どこかのフレームで最初の一枚から変わった画素の割合です。強度はその色差の平均(0〜255)です。八つの場面が39%前後に揃うのは、広い光源が面を拭くように横切る場面の性質のためで、03は現れる文そのものが狭くて9.9%、09は四つのチップの間を行き来する部品型なので2.2%です — 面積が狭い分だけ強度は91.9と120.9で最も高くなっています。九つとも23/23で、空いたフレームなく最後まで動きました。
01カーソル座標を%に写して動かす基本のスポットライト
pointermove の clientX/Y を領域の大きさで割って0〜100%へ変え、CSS変数 --mx・--my として radial-gradient の中心に差し込みます — カーソルがどこにいても中心が正確についてくる、この二行こそスポットライトのすべてです。目盛りの十字と%の表示が、座標の対応をそのまま画面に見せます。スポットライト アニメーション css を初めて貼る場面として最初に選びました。
<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="カーソル座標を%に変えてradial-gradientの中心に差し込む二つの値の計算で、光が正確についてくる場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 351줄 — 아래 「전체 코드」에서 원문 전체)// SlBasicRadialTracking - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlBasicRadialTracking.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 347줄 — 아래 「전체 코드」에서 원문 전체)01 · カーソル座標を%に写して動かす基本のスポットライト — 計測 累積面積 39.046% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
// 01 基本 % 対応 — pointermove の clientX/Y を領域の大きさで割って 0〜100% に変え
// CSS 変数 --mx/--my で radial-gradient の中心に差し込む。二つの値の算術がスポットライトのすべて
const MAP_LERP = 1.0; // 01 は即時対応 (07 が lerp の慣性を担う)
const BASE_R = 64; // 光源半径 px
function applyLight(x, y) {
// 座標 → % 対応 — この二行がこのデモのすべて
const px = clamp(x / 448 * 100, 0, 100);
const py = clamp(y / 156 * 100, 0, 100);
mrx += (px - mrx) * MAP_LERP;
mry += (py - mry) * MAP_LERP;
if (beamEl) {
beamEl.style.setProperty('--mx', f1(mrx) + '%');
beamEl.style.setProperty('--my', f1(mry) + '%');
}
scss側では background: radial-gradient(circle 64px at var(--mx) var(--my), クリーム色の停止点) の一行がこの変数を受け取り、.beam に mix-blend-mode: screen を重ねてインク色の舞台の上にクリーム色の光を足します — 半径64pxをはっきり書いている点が、後の壊れる瞬間の節の主題になります。
02距離ごとに明るさが変わるガウス距離減衰
各ピクセルの明るさを、光源までの距離 d に exp(-(d/FALLOFF_PX)²) のガウス曲線で計算します — 線形の減衰 1-(d-r)/2f と同じ半径でも質が違い、画面の固定プローブ点が二つの曲線の値を毎フレーム数値で見せます。同じ半径でも、減衰幅 FALLOFF_PX の60を変えるだけで懐中電灯と舞台照明の間を行き来できます。プローブ点(232,84)で光源がかすめる瞬間の検算値は gauss 0.83・linear 0.78(d=52px)で、この曲線ひとつが共通の仕組みとなり、04の合計と05の光の粒が同じ gauss() を呼びます。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 367줄 — 아래 「전체 코드」에서 원문 전체)// SlGaussianFalloff - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlGaussianFalloff.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 352줄 — 아래 「전체 코드」에서 원문 전체)02 · 距離ごとに明るさが変わるガウス減衰 — 計測 累積面積 39.458% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
// 02 ガウス距離減衰 — 各ピクセルの明るさ b = exp(-(d/FALLOFF_PX)^2). 線形 (1-d/f) と同じ半径でも質が違う
const FALLOFF_PX = 60; // 変形1: 60 → 160 (光が半径の外へたっぷりとにじむ)
const CORE_R = 26; // 中心の満光半径
const PROBE_XY = { x: 232, y: 84 }; // 固定プローブ点 — 光源経路の中心近く (ポスターの瞬間でも rise/fall の値が生きている)
// ガウス距離減衰 — d の明るさ b = exp(-(d/f)^2). f=FALLOFF_PX
function gauss(d, f) { return Math.exp(-(d * d) / (f * f)); }
// gaussGrad — 光源中心 (cx,cy) · 半径 r(この内側は 1) · 減衰幅 f. 停止点11個でサンプルした
// radial-gradient の文字列. tint は 'r,g,b' (クリーム 255,247,230). maxA は中心のアルファ.
// circle の後に半径を明示する — 省略すると farthest-corner へ広がり最後の停止点のアルファが
// 画面全体に敷かれる(04 poster 実測: 舞台全体が明るくなる原因)
function gaussGrad(cx, cy, r, f, tint, maxA) {
const stops = [];
const total = r + f * 2;
for (let i = 0; i <= 10; i += 1) {
const frac = i / 10;
const d = r + frac * f * 2;
const a = maxA * gauss(d - r, f);
stops.push('rgba(' + tint + ',' + f2(a) + ') ' + f1(clamp(d / total, 0, 1) * 100) + '%');
}
return 'radial-gradient(circle ' + f1(total) + 'px at ' + f1(cx) + 'px ' + f1(cy) + 'px, rgba(' + tint + ',' + f2(maxA) + ') 0px, ' + stops.join(', ') + ')';
}
コメントが伝えるように、circle の後に半径を書かないと farthest-corner へ広がって最後の停止点のアルファが画面全体に敷かれます — 04のポスターで舞台全体が明るくなった原因で、ガウスは近い側がより明るく、尾はより速く消えます。
03光が通ると文字を現すマスク反転
同じ文を暗い層と明るい層の二つに置き、mask-image を光源座標に結び付けます — 明るい層は半径 MASK_R 58px の中だけが見え、暗い層は反転マスクで半径の外を薄く保ちます。光が通った場所は再び閉じますが、暗い層の基本アルファ0.55のおかげで照明がなくても文は読めたままです。30字の文で半径に入る文字は約14字です。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 357줄 — 아래 「전체 코드」에서 원문 전체)// SlMaskRevealContent - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlMaskRevealContent.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 353줄 — 아래 「전체 코드」에서 원문 전체)03 · 光が通ると文字を現すマスク反転 — 計測 累積面積 9.9% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const MASK_R = 58; // マスク半径
const BASE_A = 0.55; // 暗い層の基本アルファ (基本の読みやすさ)
function applyMask(x, y) {
// マスク反転 — 明るい層は半径の中だけ、暗い層は半径の外だけ薄く (反転マスク)
const m = 'radial-gradient(circle ' + MASK_R + 'px at ' + f1(x) + 'px ' + f1(y) + 'px, #000 ' + f0(MASK_R - 18) + 'px, transparent ' + MASK_R + 'px)';
const mi = 'radial-gradient(circle ' + MASK_R + 'px at ' + f1(x) + 'px ' + f1(y) + 'px, transparent ' + f0(MASK_R - 18) + 'px, #000 ' + MASK_R + 'px)';
if (litLayer) {
litLayer.style.webkitMaskImage = m;
litLayer.style.maskImage = m;
}
二つの文字列は、同じ半径の黒いマスクと反転マスクの組です — 黒い側が見える領域で、webkitMaskImage と maskImage を一緒に使う理由は後の対応の節で扱います。
04三つの光源の明るさを1ピクセルに足す複数照明
動く光源ひとつと定位置の光源 LIGHT_COUNT 個の寄与を中央のピクセルで足し、合計が1を超えたらクランプします — s = min(1, Σ b_i) の一行が白飛びを防ぐ算術です。画面は光源ごとに .beam を重ねて screen ブレンドで合計をまね、光が交差する場所の明るさが舞台の奥行きになります — クランプがなければ重なった交点が白く飛びます。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 362줄 — 아래 「전체 코드」에서 원문 전체)// SlMultiLightSum - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlMultiLightSum.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 352줄 — 아래 「전체 코드」에서 원문 전체)04 · 三つの光源の明るさを1ピクセルに足す複数照明 — 計測 累積面積 38.994% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const LIGHT_COUNT = 2; // 変形2: 2 → 3 (交点が増えて舞台に奥行き)
const FIXED = [{ x: 96, y: 108 }, { x: 352, y: 108 }, { x: 224, y: 30 }];
const MUL_R = 28;
const MUL_F = 38;
function applyMulti(x, y) {
// 合計の算術 — 光源ごとの寄与を合わせて 1 でクランプする (sumClamp)
const pts = [{ x: x, y: y }].concat(FIXED.slice(0, LIGHT_COUNT));
// 中央ピクセル(224,78)での合計 — モデル値
let sum = 0;
for (let i = 0; i < pts.length; i += 1) {
const dx = 224 - pts[i].x;
const dy = 78 - pts[i].y;
sum += gauss(Math.max(0, Math.sqrt(dx * dx + dy * dy) - MUL_R), MUL_F) * 0.5;
}
const s = Math.min(1, sum);
光源ごとの寄与は gauss(max(0, d - MUL_R), MUL_F) × 0.5 で、半径の内側は満光・外側は距離減衰です — 画面の三つの .beam がその合計を重ねて見せ、デモの経路で追跡光源が固定光源にかすめるとき、中央ピクセルの合計が上限の1.0へ先に届いてから光が去って再び下がる rise/fall を数値で読めます。
05getImageDataでピクセルが目覚めるcanvasの光
canvasの基の画素を、組み立ての時に getImageData で一度だけ読んで保管し、毎フレームは光源の周りの局所窓(半径120px)だけを塗り直します — putImageData が窓の中の画素を更新します。各ピクセルの明るさは gauss(d-20, 60) にシードハッシュ位相の振動 0.55 + 0.45・sin(t・0.0032 + hash・2π) を掛け、グラデーションと違ってピクセルひとつひとつがそれぞれの時刻に目覚めては眠ります — シードハッシュは、再生し直しても同じ値を返す決定的な関数です。
<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="canvasの各ピクセルがシードハッシュの位相でひとりで目覚めまた眠る、光の粒の雨の場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 396줄 — 아래 「전체 코드」에서 원문 전체)// SlCanvasPixelRain - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlCanvasPixelRain.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 384줄 — 아래 「전체 코드」에서 원문 전체)05 · getImageDataでピクセルが目覚めるcanvasの光 — 計測 累積面積 13.915% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const PX_STEP = 3; // ピクセル格子の間隔 (計算量の上限 — 448/3 x 156/3 の画素)
const WAKE_F = 0.0032; // 光の粒の振動 角速度の倍率
const CANVAS_W = 448;
const CANVAS_H = 156;
let cvEl = null;
let ctx2 = null;
let baseData = null; // 基の画素 (組み立て時に 1 回)
// 頂点のオフセット — シードハッシュ(再生しても同じ値). Math.random は使わない
function seedHash(i, seed) {
const x = Math.sin(i * 12.9898 + seed * 78.233) * 43758.5453;
return x - Math.floor(x);
}
const g = gauss(dist - 20, 60); // 光源の寄与
const h1 = seedHash(gx * 331 + gy, 7); // 基と同じシード — 位相の再現
const wake = 0.55 + 0.45 * Math.sin(t * WAKE_F + h1 * Math.PI * 2); // 光の粒の振動
const b = g * wake;
if (b > 0.06) {
lit += 1;
}
const idx = (gy * CANVAS_W + gx) * 4;
const add = Math.round(b * 250);
d[idx] = clamp(d[idx] + add, 0, 255);
d[idx + 1] = clamp(d[idx + 1] + add - 8, 0, 255);
d[idx + 2] = clamp(d[idx + 2] + add + 16, 0, 255);
上の二つの囲みが、窓の中の画素を塗り直す局所の輪の全部です — 毎フレーム全体を読み直さない理由と局所窓のしくみは、後の壊れる瞬間の節で扱います。
06セルの境界を判定して照らすギャラリーの部分照明
カーソル座標をセルの大きさで割って何番目のセルかを整数で判定し、そのセルと隣のセルすべてに、セル中心までの距離の明るさを割り当てます — cellIndex = floor(x/112), floor(y/78) の割り算ひとつが判定のすべてで、明るさは (1 - d/150)^1.5 の距離比です。光がセルの境界を越えるとき、隣が先に暗くなる順番まで計算に入っています。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 374줄 — 아래 「전체 코드」에서 원문 전체)// SlGalleryGridCell - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlGalleryGridCell.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 366줄 — 아래 「전체 코드」에서 원문 전체)06 · セルの境界を判定して照らすギャラリーの部分照明 — 計測 累積面積 39.638% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const CELL_W = 112;
const CELL_H = 78;
const COLS = 4;
const ROWS = 2;
const RANGE_PX = 150; // 光源の影響半径
const NEAR = 1.5; // 距離比の指数 — (1 - d/RANGE)^1.5
function applyGrid(x, y) {
// セル判定 — 割り算ひとつで整数インデックス
const c = clamp(Math.floor(x / CELL_W), 0, COLS - 1);
const r = clamp(Math.floor(y / CELL_H), 0, ROWS - 1);
指数 NEAR の1.5は、明るさが距離に素直に落ちるのではなく、近い側を保ってから境界の近くで急に消える形にします — 4×2の八つのセルの写真ギャラリーをカーソルが横切るとき、ちょうど一つのますだけが明るく、隣が薄くついてくる理由です。
07慣性で遅れて追うヒーローの静かな追従
光源の座標を毎フレーム、カーソルへ LERP_FACTOR(0.18) の分だけ進めて、カーソルと光の間に時差を置きます — lx += (x - lx) * 0.18 の一行の慣性です。大きなヒーロー背景のパステルの丘の上では、この時差が静かな奥行きになり、カーソルの十字と光の輪を結ぶ時差の線がその間隔をpxで見せます — デモの経路で測ったカーソルと光の間隔は約52pxです。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)// SlHeroLerpInertia - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlHeroLerpInertia.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 362줄 — 아래 「전체 코드」에서 원문 전체)07 · 慣性で遅れて追うヒーローの静かな追従 — 計測 累積面積 39.199% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const LERP_FACTOR = 0.18; // 変形3: 0.18 → 0.06 (ゆったりした重さ)
const HERO_R = 54;
const HERO_F = 80;
function applyHero(x, y, dt) {
// lerp — dt の補正なしの固定係数(フレームの標準). カーソルと光の距離を返す
lx += (x - lx) * LERP_FACTOR;
ly += (y - ly) * LERP_FACTOR;
void dt;
const dist = Math.sqrt((x - lx) * (x - lx) + (y - ly) * (y - ly));
測った間隔をもとに係数を0.06へ下げると、この隙間が三倍ほど広がって、光がだいぶ後ろから追いかけてくる重さが付きます — 逆に1.0へ近づけると、01のように光がカーソルに張り付いて動きます。
08タップした場所から広がるタッチ用の波
タップした座標から始まって、半径が時間に比例して大きくなり、明るさは逆に減っていく波を描きます — r = age × 0.24px/ms と b = 1 - age/900ms の二つの式が拡散のすべてで、寿命 TAP_LIFE_MS の900が過ぎると波は消えます。マウスのないモバイルの画面でも、一度のタッチで照明の存在を知らせる代わりの光源です — 実際の入力は pointerdown ひとつで、マウスのクリック・タッチ・ペンを同じ addPulse() の算術で受けます。

<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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 core.ts 계승)
const W = 480;
const CX0 = 8;
const CW = 432;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
… (총 385줄 — 아래 「전체 코드」에서 원문 전체)// SlTapPulseTouch - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlTapPulseTouch.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 375줄 — 아래 「전체 코드」에서 원문 전체)08 · タップした場所から広がるタッチ用の波 — 計測 累積面積 39.076% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const TAP_LIFE_MS = 900; // 波の寿命
const TAP_SPEED = 0.24; // 半径の成長 px/ms
const TAP_MAX = 3; // 同時の波の上限
const TAP_AT = [300, 900, 1500]; // デモのタップ時刻 (最初の変化 t≥200ms)
const TAP_XY = [{ x: 120, y: 88 }, { x: 300, y: 60 }, { x: 210, y: 110 }];
function addPulse(x, y, t) {
// 新しい波 — 古いものから押し出す (同時の上限)
pulses.push({ x: x, y: y, t0: t });
if (pulses.length > TAP_MAX) {
pulses.shift();
}
}
const age = t - p.t0;
const r = age * TAP_SPEED;
const b = clamp(1 - age / TAP_LIFE_MS, 0, 1);
デモの時刻 TAP_AT に注入される波も、手でタップした波も同じ経路を通ります — 同時の上限 TAP_MAX の3は、配列を押し出す方式(shift)で古い波から消していきます。
09キーボードフォーカスを受けた要素を明るくする照明
Tab キーでフォーカスが移るとき、その要素の中心座標を getBoundingClientRect() で測って、光源をそこへ動かします — focusin のイベントが座標を計算し、光は FOCUS_LERP の0.22でゆっくり追いかけていきます。マウスをまったく使わない人にも、光が次の停留所を知らせる道案内になります — 09は累積面積2.2%の部品型なので面積では最も狭い代わりに、強度の平均は120.9で九つの場面の中で最も鮮やかで、狭い四つのチップの間を行き来する分だけ、変化を小さな面積に集中させた精密さで勝負する場面です。

<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="Tabキーでフォーカスされた要素の中心を測って光がそこへ移る、キーボードの道案内の場面"></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줄 — 아래 「전체 코드」에서 원문 전체)// 524 공통 — 스포트라이트 효과 (523 base.scss 계승, 카드→광원 팔레트로)
@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-ink);
$panel: mix($subject-cream, $subject-ink, 10%);
$dim: mix($subject-cream, $subject-ink, 76%);
// 파스텔 액센트 — vivid 토큰 대신 (BD26)
$stroke-blue: #d5daea;
$stroke-rose: #ebd6db;
$stroke-mint: #8fd8bd;
$stroke-lilac: #c9b8f2;
… (총 371줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #17141a;
… (총 464줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function cx(s) { return s; }
function main(root) {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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; }
… (총 381줄 — 아래 「전체 코드」에서 원문 전체)// SlFocusVisibleLight - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SlFocusVisibleLight.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
// ── 524 스포트라이트 공통 — 무대 좌표·문구 틀·요소 조립·광원 오버레이 (523 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); }
… (총 372줄 — 아래 「전체 코드」에서 원문 전체)09 · キーボードフォーカスを受けた要素を明るくする照明 — 計測 累積面積 2.209% · 動いたフレーム 23/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
コードで見るところ
const FOCUS_LERP = 0.22;
const FOCUS_AT = [350, 850, 1350, 1850]; // デモのフォーカス時刻
const ITEMS = ['最初の段落', 'ギャラリー', '引用', '問い合わせボタン'];
// 実際の入力経路 — focusin (Tab·Shift+Tab·クリックのフォーカスすべて). getBoundingClientRect で中心を測る
sceneEl.addEventListener('focusin', function (ev) {
const t9 = ev.target;
const i = chips.indexOf(t9);
if (i < 0) {
return;
}
focusIdx = i;
const r = t9.getBoundingClientRect();
const k = (rootEl.clientWidth / W) || 1;
const rr = sceneEl.getBoundingClientRect();
tx = clamp((r.left + r.width / 2 - rr.left) / k - 8, 0, 448);
チップは <button> のタブインデックス0で、実際のキーボードの経路を通り、:focus-visible にミント色の2pxの輪が付きます — フォーカスが移るときに矢印ではなく文で知らせること(role=status の polite)までが、この場面のアクセシビリティの分担です。
九つの項目がどこに使える画面か
スポットライトが最もよく合うのは、画面が暗くて内容の広い場所です。ダークモードのダッシュボード(01・02)はカーソルの周りだけを明るくして残りの情報を暗闇へ置くので、視線が絞り込まれます。写真のギャラリー(06)はセル単位の照明で次に見る写真を促し、案内のツアー(09)はフォーカスを移しながら次の段階を照らします。
ヒーローの背景(07)のような広い面積には慣性を重ねます — 光がカーソルに張り付いていると飾りになりますが、一拍遅れて追えば背景に奥行きが生まれます。マウスのないモバイルのランディング(08)はタップの波で照明の存在をまず知らせ、鍵がかかったような演出が要るイベントのページ(03)はマスク反転で、文は光が通って初めて完全に読めるようにします。逆に、本文の段落が並ぶ長い読み物の後ろには付けません — 照明が読む速度より遅く動くと、視線が文字を離れます。
スポットライトが壊れる瞬間 — 半径の省略・観測点の死角・撮る間隔
この記事を作りながら、壊れる場所を六つ直接確かめました。条件と直し方を一緒に書きます。
一つ目は、radial-gradient の半径の省略です。circle at x y とだけ書くと、グラデーションの箱の最も遠い隅まで半径が取られる farthest-corner が既定になり、最後の停止点のアルファが画面全体へ続きます。この記事を作るとき、04のポスターがこの原因で舞台全体の明るい画面になった実測の失敗がありました 共通の関数が circle <半径>px at の形で半径を明示するように直しました。貼り付けた部品が不自然に広くにじむときは、半径の指定から確かめます。
二つ目は、観測点が光源の経路の外にあると値が0に張り付くことです。02のプローブ点は二度移して今の(232,84)に落ち着きました — 最初(392,34)に置いたとき、光源の経路がプローブに近づかず rise/fall の値が丸ごと0で死にました。距離減衰を画面の数値で見せる場面では、観測点は必ず光源の通る道の中に置きます。
三つ目は、短い時間の窓が撮る間隔を飛び越えることです。08のデモのタップを最初は t ∈ [TAP_AT, TAP_AT+60) の条件で足しましたが、24枚の撮影のフレーム間隔(約83ms)が60msの窓を丸ごと飛び越えて、ポスターに波が一つも残りませんでした。「時刻が過ぎていたら周期ごとに必ず足す」へ判定を変えて解決しました — 時間の窓の条件は、画面の周期より長く取ります。
四つ目は、毎フレームの全体走査がcanvasを止めることです。05を getImageData で毎フレーム448×156の全体を読み直すようにすると、ヘッドレスの描画で rAF が止まることがあります。だから基の画素は組み立ての時に一度だけ読んで、毎フレームは光源の周りの半径120pxの局所窓だけ putImageData で塗り直します — 計算量が光源の位置にだけ結び付きます。
五つ目は、デモの座標が瞬間移動するとフレームが抜けるように見えることです。注入する経路 route() は sin 曲線で毎フレーム続くように作りました — 座標がフレームの間で跳ぶと、撮る間隔の折り返しの劣化で光源が一瞬消えるフレームが生まれます。自動再生を付けるなら、座標は必ず時刻の連続な関数から取り出します。
減衰幅と光源の数と追従の係数を変えるとどこが変わるか
三つの変形は、それぞれ定数をひとつだけ変えた前後を場面で直接見られます。
| 名前 | 変えた値 | 感触 |
|---|---|---|
| 減衰幅を広げる | 02 FALLOFF_PX 60 → 160 | ガウスの尾が2.7倍長くなって光が半径の外へ一段とにじみ、舞台照明のようにゆとりが出ます — d=160での減衰値は0.37(60のとき0.06) |
| 光源を三つに | 04 LIGHT_COUNT 2 → 3 | 固定の光源がひとつ多く点いて交点が増え、舞台に奥行きが生まれます。クランプがなければ重なった場所が白く飛びます |
| 追従を重く | 07 LERP_FACTOR 0.18 → 0.06 | 毎フレーム6%だけ近づくのでカーソルと光の間隔が約52pxからおおむね三倍に広がり、ゆったりした重さが付きます |
三つの値は互いの領域を侵しません — 減衰幅は光の質を、光源の数は重なりの深さを、lerp の係数は追従の重さを、それぞれ動かします。九つの場面のソースとreact版をまとめたzipは下の箱から受け取れます。解凍のパスワードは gha43jmf です。%への対応・ガウスの減衰・光の合計がライブラリなしでそれぞれ何行なのかを、コードで直接確かめられます。
ブラウザの対応とアクセシビリティ — 照明は強調であって情報ではない
どのブラウザから使えるか
caniuse を2026-11-16に直接確認した値です。
| 機能 | Chrome | Firefox | Safari | Edge |
|---|---|---|---|---|
CSS radial-gradient・CSS変数 |
26+ / 49+ | 一部 / 31+ | 一部 / 9.1+ | 12以降 |
CSS mask-image (03) |
120+ 全面(4〜119 -webkit-) | 53+ | 15.4+ | 120+ |
canvas getImageData (05) |
4+ | 2+ | 4+ | 12+ |
:focus-visible (09) |
86+ | 85+ | 15.4+ | 86+ |
prefers-reduced-motion |
74+ | 63+ | 10.1+ | 79+ |
脚注: マスクは標準の属性だけで見るなら2024以降のブラウザーが基準で、それより前は -webkit-mask-image の併記で覆えます — だから03は二つの属性を一緒に使います。Safari系は mask-image と :focus-visible の全面対応が15.4で一緒に届いたので、マスクの表示とフォーカスの照明は同じ更新の時期を基準にすれば十分です。getImageData は事実上すべてのブラウザーが対応しているので、05の計算の基盤が最も安全です。JavaScriptが切れた環境では .beam の重なりがないだけで、暗い層の文字(アルファ0.55)・ギャラリーのセル・チップがすべて基本の読みやすさで残ります。
動きを減らす設定では
九つの場面すべてで、動きを減らす設定のブロックがアニメーションを切り、共通の仕組みが中央に固定した光を一枚だけ描きます — 画面には「動きを減らす設定 ・ 中央に固定した光を一枚」の文が残ります。このとき残る一枚は、最初の場面が中央(224,66)に置くその光と場所が同じです — デモの最初のフレームを、減らす設定の利用者の静止画がそのまま受け継ぐので、どの経路から入っても舞台の形はひとつです。09のフォーカスの照明は、減らす設定がオンでも focusin が起きた瞬間にすぐその要素を照らします(ループを介さない直接の更新)。読者のコードへ移す数行は下のとおりです。
.beam { background: radial-gradient(circle 64px at var(--mx) var(--my), rgba(255,247,230,0.5) 0px, rgba(255,247,230,0) 120px); }
@media (prefers-reduced-motion: reduce) {
.beam { animation: none !important; }
}
自動デモとキーボード
九つの場面の自動再生は、決定的に注入された座標と時刻によるデモです — 人の pointermove・pointerdown・Tab は同じ applyLight・addPulse・focusin のハンドラーを通るので、算術は同じです。一時停止は <button> で aria-pressed を使い、Space・Enter が一時停止、R が最初からです。フォーカスの照明は、減らす設定がオンの画面でも静止画からすぐチップへ移ります — 動きを減らす設定と、次の停留所を明るくする案内を、ひとつの画面で一緒に保つ設計です。09のチップは Tab・Shift+Tab の実際のキーボードの経路を通り、フォーカスが移るときだけ文(role=status の polite)で知らせます — 毎フレーム読み上げられないように、場面の状態の行は aria-live を切ってあります。
関連する記事は、マウス追従の一般のマウスについて回る効果 9種と、カーソルの飾りのまとめマウスのエフェクト 9種、距離の減衰をボタンに載せたmagnetic button hover effect 9種に分けて書きました。
出典: MDN radial-gradient ・ MDN getImageData ・ MDN :focus-visible ・ MDN prefers-reduced-motion
スポットライト効果を作りながらよくある質問 — CSSだけ・読めない文字・光源を増やす
css だけでマウス 追従 アニメーション の スポットライトは作れますか
作れます。光の中心を固定に置いて :hover でいくつかの場所を切り替える方法なら、CSS変数と radial-gradient の宣言だけで十分です。ただしカーソルに絶えず追わせるには、座標を%へ変える二行のスクリプトが要ります — この記事の01がその最小の形で、その二行があれば残りの場面をすべてその上に重ねられます。
スポットライトのせいで文字が読めなくなるときはどうすればいいですか
暗い側を真っ黒にしないことです。この記事の03は暗い層に基本のアルファ0.55を残して、光がなくても文が読えるようにし、文やチップのような情報は照明の階層の外に置きます。照明が消えても画面が情報を失わないかを、暗い側の明度差で確かめるのが順番です。パステルの配色では、暗い側をより暗く、明るい側をより明るくして、明度差から先に確保します。
光源を複数置くにはどうすればいいですか
光源ごとの寄与を計算して足し、1で切り捨てます。この記事の04が s = min(1, Σ b_i) の一行で行う算術です — クランプがなければ光源が重なる交点が白く飛びます。固定の光源は座標の配列に置いて、動く光源だけをカーソルに結べば、画面の screen ブレンドが合計を自然に引き受けます。









