蒸気
背景エフェクト ／ 動く素材トップ
湯気が上昇しながら広がり、上ほど薄れて消える。
試して調整する#
判断#
向く場面: 温泉・カフェ。立ちのぼる湯気。
避ける場面: 長文の背面や、写真そのものを主役にする画面。
つまみは元の実装が持っている項目そのままです。実際に文字を重ねた状態で速さと密度を詰めます。
組み込み条件#
依存: 素のCanvas 2D。外部ライブラリは要らない。
負荷: 1画面に1つ。画面外・非表示タブ・動きを減らす設定で止まる。
再利用: コピーした単一HTMLがそのまま動く。
単一HTMLをコピーする#
下のコードだけで実物サンプルと同じ画面が動きます。調整欄を動かすと、値を反映したコードへ更新されます。
<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="robots" content="noindex,follow">
<title>蒸気 実物サンプル</title>
<style>
:root {
color-scheme: light dark;
--ink-light:#1a2421; --mut-light:#5a6a72; --signal-light:#2a7ab8; --bg-light:#f4f8fb;
--ink-dark:#f4f8fb; --mut-dark:#a8bac7; --signal-dark:#48b8ff; --bg-dark:#07111f;
}
* { box-sizing:border-box; }
html,body { margin:0; min-height:100%; }
body { font-family:"Hiragino Sans","Yu Gothic UI",system-ui,sans-serif; transition:background .3s,color .3s; }
html[data-demo-theme="light"], html[data-demo-theme="light"] body {
background:var(--bg-light); color:var(--ink-light); --ink:var(--ink-light); --mut:var(--mut-light); --signal:var(--signal-light); }
html[data-demo-theme="dark"], html[data-demo-theme="dark"] body {
background:var(--bg-dark); color:var(--ink-dark); --ink:var(--ink-dark); --mut:var(--mut-dark); --signal:var(--signal-dark); }
@media (prefers-color-scheme:light) {
html:not([data-demo-theme]), html:not([data-demo-theme]) body {
background:var(--bg-light); color:var(--ink-light); --ink:var(--ink-light); --mut:var(--mut-light); --signal:var(--signal-light); } }
@media (prefers-color-scheme:dark) {
html:not([data-demo-theme]), html:not([data-demo-theme]) body {
background:var(--bg-dark); color:var(--ink-dark); --ink:var(--ink-dark); --mut:var(--mut-dark); --signal:var(--signal-dark); } }
.sample { position:relative; min-height:100dvh; overflow:hidden; isolation:isolate; display:grid; align-items:end; }
.effect { position:absolute; inset:0; z-index:0; }
.effect canvas { display:block; width:100%; height:100%; touch-action:manipulation; }
.copy { position:relative; z-index:1; width:min(42rem,100%); padding:clamp(2rem,7vw,6rem); }
.label { margin:0 0 1rem; color:var(--signal); font:600 .72rem/1.4 ui-monospace,Consolas,monospace; letter-spacing:.16em; }
h1 { margin:0; max-width:14ch; font-size:clamp(2rem,5.5vw,4.5rem); line-height:1.05; letter-spacing:-.04em; }
.lead { margin:1.5rem 0 0; max-width:36rem; color:var(--mut); font-size:clamp(.95rem,1.4vw,1.1rem); line-height:1.85; }
.readout { position:absolute; inset:1.5rem 1.5rem auto auto; margin:0; color:var(--mut); font:500 .68rem/1.6 ui-monospace,Consolas,monospace; letter-spacing:.1em; writing-mode:vertical-rl; z-index:2; }
.theme-toggle { position:absolute; inset:1.5rem auto auto 1.5rem; z-index:2; display:flex; gap:.25rem; }
.theme-toggle button {
min-block-size:36px; padding-inline:.75rem; font:600 .72rem/1 ui-monospace,Consolas,monospace;
letter-spacing:.08em; border:1px solid var(--mut); background:transparent; color:var(--ink); cursor:pointer; border-radius:4px; }
.theme-toggle button[aria-pressed="true"] { background:var(--signal); color:var(--bg-dark); border-color:var(--signal); }
@media (max-width:640px) { .copy{padding:2rem 1.25rem 3rem}.readout{display:none} }
.bare .copy, .bare .readout, .bare .theme-toggle { display:none; }
</style>
</head>
<body>
<script id="effect-config" type="application/json">{"steam-alpha":1.0,"steam-count":18,"steam-hue":210,"steam-theme":0}</script>
<script>if (/[?&]bare=1/.test(location.search)) document.documentElement.classList.add('bare');
if (/[?&]tap=1/.test(location.search)) { addEventListener('load', function () {
setTimeout(function () { [[0.5,0.5],[0.3,0.6],[0.7,0.4]].forEach(function (p, i) {
setTimeout(function () { document.dispatchEvent(new MouseEvent('click',
{clientX: innerWidth * p[0], clientY: innerHeight * p[1], bubbles: true})); }, i * 220);
}); }, 300); }); }</script>
<script>(function(){var m=location.hash.match(/[#&]cfg=([^&]*)/);if(!m)return;
try{JSON.parse(decodeURIComponent(m[1]));document.getElementById('effect-config').textContent=decodeURIComponent(m[1]);}catch(e){}})();</script>
<script>(function(){
var root=document.documentElement, cfgNode=document.getElementById('effect-config');
var themeKeys=["steam-theme"];
function syncTheme(t){
root.setAttribute('data-demo-theme',t);
document.querySelectorAll('.theme-toggle button').forEach(function(b){
b.setAttribute('aria-pressed',b.dataset.theme===t?'true':'false');});
if(!themeKeys.length)return;
try{var cfg=JSON.parse(cfgNode.textContent||'{}');
themeKeys.forEach(function(k){cfg[k]=t==='dark'?0:1;});
cfgNode.textContent=JSON.stringify(cfg);}catch(e){}
}
var fixed=null;
if(fixed){syncTheme(fixed);}else{var q=location.search.match(/[?&]theme=(light|dark)/); if(q) syncTheme(q[1]);}
addEventListener('DOMContentLoaded',function(){
document.querySelectorAll('.theme-toggle button').forEach(function(b){
b.addEventListener('click',function(){syncTheme(b.dataset.theme);});});});})();</script>
<main class="sample">
<div class="theme-toggle" aria-label="配色切替">
<button type="button" data-theme="light" aria-pressed="false">LIGHT</button>
<button type="button" data-theme="dark" aria-pressed="false">DARK</button>
</div>
<div class="effect" aria-hidden="true"><canvas id="effect-canvas"></canvas></div>
<div class="copy">
<p class="label">背景エフェクト</p>
<h1>蒸気</h1>
<p class="lead">湯気が上昇しながら広がり、上ほど薄れて消える。温泉・カフェ。立ちのぼる湯気。</p>
</div>
<p class="readout">単一HTML・動きを減らす設定に対応</p>
</main>
<script>
/* ---- ここから下は AK²Engine の実装をそのまま持ってきたもの ------------- */
/**
* AK²-Engine / effects/steam.js
* ===============================
* スチーム・煙エフェクト（SteamEffect）
*
* 下部から湧き上がる煙が膨張しながら上昇し消えていく。
* radialGradient でふんわりした煙らしい表現を実現。
* 温泉・カフェ・モノクロームアート・ドラマチック系に。
*
* ── CSS 変数による設定 ─────────────────────────────
*
* --steam-count
* 同時に存在できる最大粒子数
* デフォルト: 18
* 推奨範囲: 8（薄煙）〜 35（濃い煙）
* カードプレビュー用: 6〜10
*
* --steam-alpha
* アルファ係数 0〜1
* デフォルト: 1.0（= 最大 0.35 の標準輝度）
* 推奨範囲: 0.5（透明感）〜 1.5（濃い）
*
* --steam-hue
* 煙の色相 0〜360
* デフォルト: 210（青白い蒸気）
* 推奨例: 0（赤みがかった煙）, 60（黄みがかった煙）, 210（蒸気）
*
* --steam-theme
* 背景テーマ切替
* デフォルト: dark（白系の煙・黒背景向け）
* 白背景: light（暖かいグレーの煙・白背景で視認可能）
*
* 使い方:
* AK2.register(new SteamEffect());
*/
class BgEffectSteam {
/** @type {object} コンストラクタオプション（CSS変数より優先） */
#options = {};
/** @param {{{ count?: number, alpha?: number, hue?: number, theme?: string }}} options */
constructor(options = {}) {
this.#options = options;
}
/** @type {number} */
#w = 0;
/** @type {number} */
#h = 0;
/** @type {Array<object>} */
#puffs = [];
/** @type {number} 次の粒子生成タイマー（秒） */
#spawnTimer = 0;
/**
* 最大粒子数 — CSS 変数 --steam-count で上書き可
* デフォルト: 18 | 推奨: 8〜35
* @type {number}
*/
#count = 18;
/**
* アルファ係数 — CSS 変数 --steam-alpha で上書き可
* デフォルト: 1.0 | 推奨: 0.5〜1.5
* @type {number}
*/
#alphaScale = 1.0;
/**
* 色相 — CSS 変数 --steam-hue で上書き可
* デフォルト: 210（青白い蒸気）| 推奨: 0〜360
* @type {number}
*/
#hue = 210;
/**
* テーマ — CSS 変数 --steam-theme で上書き可
* 'dark'（デフォルト）| 'light'（白背景用）
* @type {string}
*/
#theme = 'dark';
// ── AK²Engine インターフェイス ─────────────────
init(canvas, _ctx) {
this.#w = canvas.width;
this.#h = canvas.height;
const style = getComputedStyle(document.documentElement);
const n = parseInt(style.getPropertyValue('--steam-count'));
const a = parseFloat(style.getPropertyValue('--steam-alpha'));
const hue = parseFloat(style.getPropertyValue('--steam-hue'));
const theme = style.getPropertyValue('--steam-theme').trim();
if (n > 0) this.#count = n;
if (!isNaN(a)) this.#alphaScale = a;
if (!isNaN(hue)) this.#hue = hue;
if (theme === 'light') this.#theme = 'light';
// コンストラクタオプションは CSS 変数より優先（セクション個別指定に使用）
if (this.#options.count !== undefined) this.#count = this.#options.count;
if (this.#options.alpha !== undefined) this.#alphaScale = this.#options.alpha;
if (this.#options.hue !== undefined) this.#hue = this.#options.hue;
if (this.#options.theme !== undefined) this.#theme = this.#options.theme;
// 初期状態として画面内に適度に配置
for (let i = 0; i < this.#count; i++) {
this.#puffs.push(this.#createPuff(true));
}
}
onResize(w, h) {
this.#w = w;
this.#h = h;
}
/**
* @param {number} dt - 前フレームからの経過ミリ秒
*/
update(dt) {
const dts = dt / 1000;
// 新しい粒子を補充
this.#spawnTimer -= dts;
if (this.#spawnTimer <= 0 && this.#puffs.length < this.#count) {
this.#puffs.push(this.#createPuff(false));
this.#spawnTimer = 0.4 + Math.random() * 0.6;
}
for (let i = this.#puffs.length - 1; i >= 0; i--) {
const p = this.#puffs[i];
p.life -= dts;
if (p.life <= 0) { this.#puffs.splice(i, 1); continue; }
const progress = 1 - p.life / p.maxLife; // 0（生まれた直後）〜1（消える直前）
// 上昇 + ゆらぎ
p.y -= p.vy * dts;
p.x += Math.sin(p.phase + p.life * 2) * 12 * dts;
// 膨張
p.r = p.baseR * (1 + progress * 2.5);
// アルファ：出現→最大→消滅
const peakT = 0.3;
p.alpha = progress < peakT
? progress / peakT
: 1 - (progress - peakT) / (1 - peakT);
p.alpha *= 0.35 * this.#alphaScale;
}
}
/**
* @param {CanvasRenderingContext2D} ctx
*/
draw(ctx) {
this.#puffs.forEach(p => {
if (p.alpha < 0.005) return;
const g = ctx.createRadialGradient(p.x, p.y, 0, p.x, p.y, p.r);
if (this.#theme === 'light') {
// 白背景用: 暖かいグレーで視認可能な煙
g.addColorStop(0, `hsla(${this.#hue}, 12%, 42%, ${p.alpha})`);
g.addColorStop(0.5, `hsla(${this.#hue}, 8%, 55%, ${p.alpha * 0.5})`);
g.addColorStop(1, `hsla(${this.#hue}, 5%, 65%, 0)`);
} else {
// 暗背景用: 白系の煙
g.addColorStop(0, `hsla(${this.#hue}, 20%, 95%, ${p.alpha})`);
g.addColorStop(0.5, `hsla(${this.#hue}, 15%, 80%, ${p.alpha * 0.5})`);
g.addColorStop(1, `hsla(${this.#hue}, 10%, 60%, 0)`);
}
ctx.beginPath();
ctx.arc(p.x, p.y, p.r, 0, Math.PI * 2);
ctx.fillStyle = g;
ctx.fill();
});
}
// ── 内部処理 ─────────────────────────────────
/**
* @param {boolean} randomY - true なら画面内ランダム位置（初期化用）
*/
#createPuff(randomY = false) {
const maxLife = 3.0 + Math.random() * 2.0;
return {
x: this.#w * (0.1 + Math.random() * 0.8), // 左右10%マージン
y: randomY
? this.#h * (0.3 + Math.random() * 0.7)
: this.#h + 20, // 画面下から出現
r: 0,
baseR: 20 + Math.random() * 30,
vy: 25 + Math.random() * 35, // 上昇速度
phase: Math.random() * Math.PI * 2,
life: randomY ? Math.random() * maxLife : maxLife,
maxLife,
alpha: 0,
};
}
}
// AK²Engine に登録
window.BgEffectSteam = BgEffectSteam;
/* ---- ここまで。以下は、この資料で回すための呼び出し ------------------- */
(function () {
var canvas = document.getElementById('effect-canvas');
var ctx = canvas.getContext('2d');
var cfgNode = document.getElementById('effect-config');
var reduced = matchMedia('(prefers-reduced-motion: reduce)');
var eff = null, raf = 0, last = 0, W = 1, H = 1, active = true;
var VARS = {"steam-alpha": "--steam-alpha", "steam-count": "--steam-count", "steam-hue": "--steam-hue", "steam-theme": "--steam-theme"};
function applyVars(cfg) {
Object.keys(VARS).forEach(function (k) {
if (cfg[k] !== undefined && cfg[k] !== null) {
document.documentElement.style.setProperty(VARS[k], String(cfg[k]));
}
});
}
function measure() {
var box = canvas.getBoundingClientRect();
W = Math.max(1, Math.round(box.width));
H = Math.max(1, Math.round(box.height));
}
function build(cfg) {
applyVars(cfg);
measure();
canvas.width = W; canvas.height = H; /* init は canvas.width を読む */
eff = new BgEffectSteam({});
if (eff.init) eff.init(canvas, ctx);
fit();
}
function fit() {
measure();
var dpr = Math.min(2, window.devicePixelRatio || 1);
canvas.width = Math.round(W * dpr);
canvas.height = Math.round(H * dpr);
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
if (eff && eff.onResize) eff.onResize(W, H);
}
function paint(dt) {
/* 描く直前に実寸を見る。読み込みの順によっては、最初の計測で幅0が返る
（Browser ペインで 1x958 の buffer になった。ResizeObserver だけでは
戻らないことがあるので、毎フレーム安く確かめる） */
var box = canvas.getBoundingClientRect();
if (Math.abs(Math.round(box.width) - W) > 1 || Math.abs(Math.round(box.height) - H) > 1) {
fit();
}
ctx.clearRect(0, 0, W, H);
if (!eff) return;
if (eff.update) eff.update(dt);
if (eff.draw) eff.draw(ctx);
}
function report() {
document.documentElement.dataset.materialActive = String(active);
document.documentElement.dataset.materialRunning = String(raf !== 0);
}
function stop() { if (raf) cancelAnimationFrame(raf); raf = 0; report(); }
function loop(time) {
if (!active || reduced.matches || document.hidden) { stop(); paint(16.67); return; }
var dt = last ? Math.min(60, time - last) : 16.67;
last = time;
paint(dt);
raf = requestAnimationFrame(loop);
report();
}
function start() {
stop(); last = 0;
if (active && !reduced.matches && !document.hidden) raf = requestAnimationFrame(loop);
else paint(16.67);
report();
}
addEventListener('message', function (e) {
var d = e.data || {};
if (d.type === 'material-config') {
cfgNode.textContent = JSON.stringify(d.values || {});
build(d.values || {});
start();
}
if (d.type === 'material-active') { active = d.active === true; start(); }
});
document.addEventListener('visibilitychange', start);
reduced.addEventListener('change', start);
new ResizeObserver(fit).observe(canvas);
addEventListener('pagehide', stop, {once: true});
build(JSON.parse(cfgNode.textContent));
start();
})();
</script>
</body>
</html>
AIエージェントへ渡す場合は、「このHTMLを対象ページのヒーロー背景へ組み込み、文字と主要ボタンを前面に残してください」と添えます。
組み込み時の確認#
prefers-reduced-motion: reduceで静止する- 画面外と非表示タブで描画が止まる
- 背景を止めても文字の階層と構図が成立する
- 文字とのコントラストを実際の配色で測る
- 装飾が主要操作の当たり判定を覆わない