スマホ hover 対応ガイド — マウスとタップを分ける9場面
スマホ hover の対応では、乗せる効果は@media (hover: hover)の中だけに置き、タッチ画面には押した瞬間の反応を用意します。同じボタンがマウスでは乗せると反応し、タッチでは押さないと反応しない。分岐・押下・残るhover・長押し・スワイプを場面ごとに数字で比べます。
スマホのhoverは、タッチ画面でずれるマウスオーバー効果
01 hv-media
02 hv-active
03 hv-sticky
04 hv-pointer
05 hv-target
06 hv-longpress
07 hv-swipe
08 hv-touchaction
09 hv-focus
- 01 hover分岐 — マウスだけで乗せる効果を有効に
- 02 押下フィードバック — :activeで押した感を出す
- 03 残るhover — タップ後に効果が戻らない問題
- 04 入力の種類を検知 — pointerTypeで分ける
- 05 タッチ対象の大きさ — 24pxと44pxの押し間違い
- 06 長押し — しきい時間と移動の許容
- 07 スワイプ — 距離と速度のしきい値で判定
- 08 ジェスチャーの分担 — touch-actionでスクロールと分ける
- 09 フォーカス表示 — :focus-visibleで入力方式別の枠
hoverはポインターを要素の上に置いたままにするマウスの入力で、指で画面を押すタッチには置いたままの状態がありません。
そのためタッチ画面では :hover の規則が、押した瞬間に入り、指を離したあとも残ることがあります。
01〜04は機器を分けて読む側で、05〜08は指の物理(押し間違い・長押し・スワイプ・方向分け)です。09は、キーボードとタッチを併用する画面のフォーカス表示です。
押した瞬間の反応は、クリックとタッチのフィードバック9種で先に見られます。
タッチ対応9種 — 分岐からフォーカスまで
次の表は、demo.py で書き出した480×300の画面24枚から出した値です。隣り合う枚の差23組を、一組ずつ比べています。
累積面積は、最初の枚から変わった画素が画面に占める割合です。強度は、変わった画素の色差の平均(0〜255)で、変化と見る境目は色チャンネルの差12超です。Chrome の細かいバージョンは記録になく、未確認です。
05〜08の割合と回数は別物で、デモのソースの判定ロジックを node で動かしたモデルのシミュレーションの値です。固定の種の乱数による標本(05は300個・06は200個・07は60個・08は120個)に、接触の広がり(タッチ9px・マウス2px)やドラッグ角度の基準(15度・45度)といった仮定を入れています。実機で測った値ではないので、条件を変えたときの変化幅として読んでください。
| 場面 | 累積面積 | 動いたフレーム | 強度の平均 |
|---|---|---|---|
| 01 hover分岐 | 29.2% | 9/23 | 50.2 |
| 02 押下フィードバック | 30.8% | 10/23 | 48.0 |
| 03 残るhover | 27.9% | 11/23 | 39.1 |
| 04 入力の種類を検知 | 16.4% | 8/23 | 37.7 |
| 05 タッチ対象の大きさ | 18.7% | 21/23 | 21.3 |
| 06 長押し | 34.0% | 22/23 | 77.7 |
| 07 スワイプ | 17.2% | 20/23 | 74.5 |
| 08 ジェスチャーの分担 | 20.8% | 21/23 | 31.7 |
| 09 フォーカス表示 | 22.2% | 22/23 | 52.1 |
動いたフレームが21〜23の05〜09は標本が流れ続ける場面、9〜11の01〜04は時間表のある時刻に状態が切り替わる場面です。
01hover分岐 — マウスだけで乗せる効果を有効に
マウス版のカードは4.2秒の周期で LIFT_PX の10pxだけ上がって下がり、タッチ版のカードは条件の外なので上がりません。
機器2種に条件2つ(HOVER_Q・POINTER_Q)を掛けた4マスのうち、真になる MATCH は2です。スマホ hover 解除をCSS二行で済ませたいときに合い、押したときの反応が別にないボタンには02を足します。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="同じカードにhoverクエリの分岐を掛けたマウス版とタッチ版を並べ、条件がどの機器をどちらへ送るか読む場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 640줄 — 아래 「전체 코드」에서 원문 전체)// HoverBranch - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./HoverBranch.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 608줄 — 아래 「전체 코드」에서 원문 전체)01 · hover分岐 — マウスだけで乗せる効果を有効に — 計測 累積面積 29.216% · 動いたフレーム 9/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
const HOVER_Q = '(hover: hover)';
const POINTER_Q = '(pointer: fine)';
const LIFT_PX = 10;
const LAP_S = 4.2;
const REST_S = 1.0;
const DEV_MOUSE = { hover: true, fine: true };
const DEV_TOUCH = { hover: false, fine: false };
// 機器1台が条件 q(0 は hover クエリ、1 は pointer クエリ)に合うか
function matchQ(d, q) { return q === 0 ? d.hover : d.fine; }
// 機器2種 × 条件2つのうち、真になるマスの数
const MATCH = [DEV_MOUSE, DEV_TOUCH].reduce(function (s, d) { return s + (matchQ(d, 0) ? 1 : 0) + (matchQ(d, 1) ? 1 : 0); }, 0);
02押下フィードバック — :activeで押した感を出す
ボタンは PRESS_SCALE の0.94倍に縮み、離したあと REL_MS の160msで戻ります。反応遅れの候補 ATT_OPTS の40・100・240msでは、押下が半分に届く halfMs が13.7・34.3・82.2msで、三つとも目安線 FEEL_MS の100msより短くなります。
4.0秒の周期の中で TAP_AT の三つの時刻(0.5・1.7・2.9秒)にタップし、方向キーで候補を替えます。乗せる効果のない画面で、押したことを知らせるときに合います。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え、左右の矢印キーで押下の反応時間を変える">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="押下の縮小と戻り時間を変えながら半分に届く時間を目盛りで比べる場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 666줄 — 아래 「전체 코드」에서 원문 전체)// PressFeedback - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./PressFeedback.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 622줄 — 아래 「전체 코드」에서 원문 전체)02 · 押下フィードバック — :activeで押した感を出す — 計測 累積面積 30.751% · 動いたフレーム 10/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
const PRESS_SCALE = 0.94;
const REL_MS = 160;
const ATT_OPTS = [40, 100, 240];
let attIdx = 0;
const TAP_AT = [0.5, 1.7, 2.9];
const TAP_N = TAP_AT.length;
const HOLD_S = 0.3;
const FEEL_MS = 100;
const LAP_S = 4.0;
const REST_S = 0.7;
03残るhover — タップ後に効果が戻らない問題
タッチ版はカードを押した瞬間に乗せる状態が入り、離したあとも戻らないので、カード6枚の列で TAP_SEQ の[1,4,2]の順にタップすると、押したカードは次のタップか RESET_AT の3.5秒の空きタップ RESET まで浮いたままです。
スマホ hover が残る枚数 STUCK_N は分岐なしで3枚、クエリ分岐を掛けると0枚で、残る時間の合計 STUCK_MS は2450msです。押したカードだけ浮き続ける一覧に合い、分岐なしの乗せる効果は、タッチの一覧には使いません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="タップ後に持ち上がったまま残るカードを分岐なしと分岐ありで数える場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 666줄 — 아래 「전체 코드」에서 원문 전체)// StuckHover - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./StuckHover.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 615줄 — 아래 「전체 코드」에서 원문 전체)03 · 残るhover — タップ後に効果が戻らない問題 — 計測 累積面積 27.897% · 動いたフレーム 11/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
// 残るカードの数とその時間の合計(ms)— 指を離したあとも上がっていた時間
const STUCK_N = TAP_SEQ.length;
let stuckSum = 0;
for (let i = 0; i < TAP_SEQ.length; i += 1) {
const end = i + 1 < TAP_SEQ.length ? TAP_AT[i + 1] : RESET_AT;
stuckSum += (end - (TAP_AT[i] + TAP_HOLD)) * 1000;
}
const STUCK_MS = Math.round(stuckSum);
04入力の種類を検知 — pointerTypeで分ける
マウス・タッチ・ペンの入力6回が SEQ の順に一つの要素へ入ると、routeOf が pointerType の文字列ひとつで、mouse はhover、touch はpress、pen はhover+pressへ振り分けます。隣り合う二つの入力で種類が違う SWITCH_N は4回です。
種類別ではmouse 2回・touch 3回・pen 1回です。一つの画面でマウスとタッチを同時に受ける機器を扱うときに合います。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="マウス・タッチ・ペンの入力が交互に来るときpointerTypeで規則を分け、種類の切り替えを数える場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 663줄 — 아래 「전체 코드」에서 원문 전체)// PointerKind - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./PointerKind.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 613줄 — 아래 「전체 코드」에서 원문 전체)04 · 入力の種類を検知 — pointerTypeで分ける — 計測 累積面積 16.366% · 動いたフレーム 8/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
// 種類が切り替わった回数 — 隣り合う二つの入力で種類が違う箇所
let sw = 0;
for (let i = 1; i < SEQ.length; i += 1) {
if (SEQ[i] !== SEQ[i - 1]) {
sw += 1;
}
}
const SWITCH_N = sw;
// 規則の分かれ道 — pointerType の文字列ひとつで決める
function routeOf(pt) {
if (pt === 'mouse') {
return 'hover';
}
if (pt === 'touch') {
return 'press';
}
return 'hover+press';
}
const ROUTE = routeOf(PTYPE[1]);
05タッチ対象の大きさ — 24pxと44pxの押し間違い
間隔 GAP_PX の8pxで並べたボタンの列に、接触の中心を固定の種の標本300個でばらまきます。接触の直径は FINGER_PX の36pxで描き、中心の広がりはタッチ SIGMA_TOUCH を9px、マウス SIGMA_MOUSE を2pxと仮定しました(画面は1.3倍に拡大、計算はpxのまま)。
このデモのモデルでは、24pxのボタンは正しく押せる割合66.3%・隣の押し間違い3.0%・すき間か外れ30.7%、44pxは94.3%・0.3%・5.3%で、マウスはどちらの大きさも100.0%です。小さなアイコンボタンの列の押し間違いを減らすときに合い、間隔8pxの24pxのボタン列は、すき間・外れが30%台になるので使いません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え、左右の矢印キーで強調するボタンの大きさを選ぶ">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="24pxと44pxのボタン列に指の接触中心の標本を散らし、隣の押し間違いの割合を比べる場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 677줄 — 아래 「전체 코드」에서 원문 전체)// TargetSize - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./TargetSize.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 627줄 — 아래 「전체 코드」에서 원문 전체)05 · タッチ対象の大きさ — 24pxと44pxの押し間違い — 計測 累積面積 18.692% · 動いたフレーム 21/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
const SIZES = [24, 44];
let selIdx = 0;
const TARGET_PX = SIZES[0];
const GAP_PX = 8;
// 指の接触の直径の仮定 — 接触の中心がどこに落ちるかが押下を決める
const FINGER_PX = 36;
const SIGMA_TOUCH = 9;
const SIGMA_MOUSE = 2;
const SAMPLES = 300;
const SHOWN = 120;
// 画面では1pxを1.3マスに拡大して描く — 計算はpxのまま
const K = 1.3;
06長押し — しきい時間と移動の許容
押した時間がしきい HOLD_MS に届き、その間に指が MOVE_PX の10px以上動かなければメニューが開きます。タッチ版の指が毎秒 DRIFT_V の26pxで流れると、385ms(CANCEL)で取り消されます。
標本200個は半分が長押ししたい手、半分がスクロールする手で、このデモのモデルでは、500はスクロール中の誤動作0.0%・開かない19.0%、300は13.0%・0.0%です。右クリックのない画面で補助メニューを開くときに合い、しきい時間を300に下げた値は誤動作が増えるので、スクロールの多い一覧には使いません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え、左右の矢印キーでしきい時間を500と300から選ぶ">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="押した時間がしきい値に届き移動が許容内ならメニューが開く判定とスクロール中の誤作動標本を比べる場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 703줄 — 아래 「전체 코드」에서 원문 전체)// LongPress - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./LongPress.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 649줄 — 아래 「전체 코드」에서 원문 전체)06 · 長押し — しきい時間と移動の許容 — 計測 累積面積 33.968% · 動いたフレーム 22/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
// 標本 — 半分は長押ししたい手(押した時間350〜1000ms、ぶれ0〜8px/秒)、半分はスクロールする手(100〜700ms、20〜120px/秒)
const r6 = rng(6);
const DUR = [];
const VEL = [];
const INTENT = [];
for (let i = 0; i < N; i += 1) {
const lp = i % 2 === 0;
INTENT.push(lp);
DUR.push(lp ? 350 + r6() * 650 : 100 + r6() * 600);
VEL.push(lp ? r6() * 8 : 20 + r6() * 100);
}
// 判定 — しきい時間の中で許容を超えて動けば取り消し(CANCEL)、しきい時間の前に離しても開かない
function opens(i, hold) { return DUR[i] >= hold && (VEL[i] * hold) / 1000 <= MOVE_PX; }
07スワイプ — 距離と速度のしきい値で判定
移動距離が SWIPE_PX の40pxに届くか、MIN_PX の12px以上動いたまま速度が VEL の0.3px/ms以上であれば、commit が送りと判定します。標本60個は、マウスが長くて遅いドラッグ、タッチが短くて速いはじきです。
このデモのモデルでは、タッチの送りは95.0%、マウスは96.7%で、タッチの40pxで距離だけを見ると73.3%なので、速度条件が短いはじきを拾います。カードの送りや削除のスワイプに合い、距離のしきい値だけで判定する方式はそのはじきを逃すので使いません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え、左右の矢印キーで距離しきい値を40と80から選ぶ">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="マウス版とタッチ版のドラッグ標本を距離と速度の二つのしきい値で分けて成立率を比べる場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 669줄 — 아래 「전체 코드」에서 원문 전체)// SwipeCommit - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./SwipeCommit.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 626줄 — 아래 「전체 코드」에서 원문 전체)07 · スワイプ — 距離と速度のしきい値で判定 — 計測 累積面積 17.194% · 動いたフレーム 20/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
// 速度のしきい値(px/ms)— 短くてもこの速度以上なら送り、ただし MIN_PX 以上動いたときだけ
const VEL = 0.3;
const MIN_PX = 12;
const N = 60;
const LAP_S = 4.4;
const REST_S = 3.6;
const rs = rng(7);
// 標本 — マウスは長くて遅いドラッグ(30〜170px、0.05〜0.35px/ms)、タッチは短くて速いはじき(14〜100px、0.15〜1.1px/ms)
const MD = [];
const MV = [];
const TD = [];
const TV = [];
for (let i = 0; i < N; i += 1) {
MD.push(30 + rs() * 140);
MV.push(0.05 + rs() * 0.3);
TD.push(14 + rs() * 86);
TV.push(0.15 + rs() * 0.95);
}
function commit(d, v, swipe, useVel) { return d >= swipe || (useVel && v >= VEL && d >= MIN_PX); }
08ジェスチャーの分担 — touch-actionでスクロールと分ける
横にドラッグするスライダーが縦スクロールを奪う状態(TOUCH_ACT の auto)と、方向を分けた状態(pan-y)を並べ、標本120個(70%がスライダーを動かしたい手、30%がページを下げたい手)で、スライダーの意図がスクロールへ流れた割合 HAND_PCT を数えます。
このデモのモデルでは、その割合は auto の38.6%から pan-y の2.3%へ減り、スクロールの意図をスライダーが奪う割合も none の100.0%から pan-y の0.0%へ減ります(角度の基準は仮定です)。横スライダーの中でページが下がらないときは pan-y で整理し、none は縦スクロールまで押さえてしまうので、スライダーには使いません。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="touch-actionがautoのときとpan-yのときでドラッグ方向の標本がスクロールとスライダーに分かれる割合を比べる場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 672줄 — 아래 「전체 코드」에서 원문 전체)// TouchAction - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./TouchAction.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 624줄 — 아래 「전체 코드」에서 원문 전체)08 · ジェスチャーの分担 — touch-actionでスクロールと分ける — 計測 累積面積 20.799% · 動いたフレーム 21/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
const TOUCH_ACT = ['auto', 'pan-y'];
// モデルの仮定 — auto では最初の動きが横軸から STEAL_DEG 以上傾くとスクロールが奪う。pan-y は横が優勢(45度以内)ならスライダーが持つ
const STEAL_DEG = 15;
const AXIS_DEG = 45;
const AXIS = 'x';
const N = 120;
const LAP_S = 4.2;
const REST_S = 3.4;
const r8 = rng(8);
09フォーカス表示 — :focus-visibleで入力方式別の枠
フォーカスが6回移る間(入力の順はキーボード3・マウス2・タッチ1)、:focus は枠を6回とも出し、:focus-visible は ringOn がキーボード入力のときだけ出すので、RING_N は3回です。
キーボードのときだけ出すという判定はこのデモのモデルで、実際のブラウザには、テキスト入力欄のようにマウスで押しても :focus-visible が入る例外があります。入力欄にこの数値は移せません。キーボードとタッチを併用するフォームに合います。

<main class="stage">
<div class="ez is-demo" id="ez">
<div class="ez__pad" data-role="pad" tabindex="0" role="application" aria-label="デモの舞台 — SpaceかEnterで一時停止、Rで最初から、Tでタッチモードの切り替え">
<canvas class="ez__canvas" data-role="canvas" width="480" height="300" role="img" aria-label="キーボード・マウス・タッチでフォーカスが移るとき:focusと:focus-visibleの枠の回数を比べる場面"></canvas>
</div>
<p class="ez__status" data-role="status" aria-live="off">場面の準備</p>
<div class="ez__ctrl">
<button class="ez__pause" data-role="pause" type="button" aria-pressed="false">一時停止</button>
<button class="ez__pause" data-role="sim" type="button" aria-pressed="false">タッチモード</button>
</div>
<p class="ez__done" data-role="done" role="status" aria-live="polite"></p>
</div>
… (총 13줄 — 아래 「전체 코드」에서 원문 전체)@use "../../../../site/static/demo-tokens" as *;
@include stage($stage-paper);
.ez {
position: relative;
width: min(92vw, calc(160vh - 12.8vw));
aspect-ratio: 480 / 300;
margin: 0 auto;
border-radius: $r-card;
overflow: hidden;
box-shadow: $shadow-raised;
background: $subject-ink;
… (총 122줄 — 아래 「전체 코드」에서 원문 전체)html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
… (총 134줄 — 아래 「전체 코드」에서 원문 전체)(function () {
const rootEl = document.getElementById("ez");
if (!rootEl) return;
main(rootEl);
function main(root) {
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
const TAU = Math.PI * 2;
function clamp(v, lo, hi) { return v < lo ? lo : (v > hi ? hi : v); }
function lerp(a, b, k) { return a + (b - a) * k; }
// 파스텔 팔레트 — 바탕은 짙은 자두색, 상자는 연한 색, 글자는 연한 색 또는 짙은 잉크
… (총 665줄 — 아래 「전체 코드」에서 원문 전체)// FocusRing - 같은 항목 vanilla index.html 의 React 판. 같은 계산을 useEffect 안에서 돌린다
import { useEffect, useRef } from "react";
import styles from "./FocusRing.module.scss";
const cx = (s: string): string => s.split(" ").map((n) => styles[n] ?? n).join(" ");
function main(root: HTMLElement): () => void {
type RGB = [number, number, number];
type Fn = (p: number) => number;
// 무대 좌표 — 캔버스 안 계산은 늘 480×300. 화면에 보이는 크기와 상관없다
const W = 480;
const H = 300;
… (총 617줄 — 아래 「전체 코드」에서 원문 전체)09 · フォーカス表示 — :focus-visibleで入力方式別の枠 — 計測 累積面積 22.228% · 動いたフレーム 22/23GODRICH オリジナル · SCSS と React は zip に同梱 · パスワードを見る
// 枠の透明度が呼吸するように上下する速さ — 毎秒1回
const FOCUS_VIS = ':focus-visible';
// 規則ごとに枠が入るか — :focus は入力の種類を問わず、:focus-visible はキーボードのときだけ(このデモのモデル)
function ringOn(rule, kind) { return rule === 0 ? true : kind === 0; }
function ringCount(rule) {
let n = 0;
for (let i = 0; i < EV_KIND.length; i += 1) {
if (ringOn(rule, EV_KIND[i])) {
n += 1;
}
}
return n;
}
const RING_N = ringCount(1);
const RING_ALL = ringCount(0);
マウスとタッチのどちらを基準に作るか?
基本は、タッチ画面を先に整えてから、マウスに乗せる効果を足す順番です。押した感(02)は両方に要り、乗せる効果はクエリ分岐(01)の中にだけ置きます。
| 画面の入力 | 先にそろえるもの | 足すもの | 根拠の節 |
|---|---|---|---|
| タッチだけ | 押した感・対象の大きさ | 長押し・ジェスチャーの分担 | 02・05・06・08 |
| マウスだけ | 押した感 | 乗せる効果 | 02・01 |
| 両方(タッチ付きのノートPC) | 入力の種類の検知 | クエリ分岐・フォーカス表示 | 04・01・09 |
(hover: hover) は、基本の入力が乗せられるかを問う値で、補助でマウスをつないだタッチ機器では false が返ることがあります。その機器にもマウス向けの反応を出すには、04のpointerType検知をJSで足します。
ジェスチャーの実際の手の動きは、スマホのタッチジェスチャー9種で見られます。
動きを減らす設定と重なる部分は、prefers-reduced-motion 対応ガイドで扱っています。
入力ひとつがCSSとJSに届く順番 — 動作の流れ
指が触れるとイベントが二つの層で上がります
CSSはメディアクエリの値で画面全体を先に分け、JSは pointer イベントが届くたびに pointerType の値で一回ずつ分けます。長押しとスワイプは、イベントの時刻と座標だけで判定します(06・07)。
ライブラリなしで実際の画面に付ける方法
三つのブロックで足ります
@media (hover: hover) and (pointer: fine) のブロックに乗せる効果を置き、外側に共通の押した感を置きます。スライダーには pan-y を使い、長押しとスワイプは pointerdown の時刻と座標から pointermove で距離と速度を計算します。
タッチで壊れる落とし穴 — 残るhoverと重なるジェスチャー
残るhoverは、指を離したあとにも残ります
03の場面では、分岐なしで置くとタップしたカード3枚が浮いたまま残ります。その場所に02の押した感を置けば、押した瞬間の反応は残ります。
touch-action none はスクロールを止めてしまいます
08の場面の none 版は、スクロール意図の標本のどれもスライダーが奪い、ページが下がらなくなります。none はお絵かきのような面にだけ狭く使います。
しきい値の変更は、反対側の誤りを増やします
HOLD_MS を500から300に下げると開かない問題は消えますが、スクロール中に誤って開く問題が出ます。スワイプの距離を40pxから80pxに上げると、長くて遅いマウスのドラッグが届かず、マウスの送りが大きく減ります。
値を変えて見た差
HOLD_MS・TARGET_PX・SWIPE_PX を一つずつ変えた結果です。
| 名前 | 変えた値 | 見え方 |
|---|---|---|
| 長押しの時間を変えて | 06 HOLD_MS 500 → 300 | スクロール中にメニューが誤って開く割合は0.0%から13.0%へ増え、長押しなのに開かない割合は19.0%から0.0%へ減ります |
| タッチ対象の大きさを変えて | 05 TARGET_PX 24 → 44 | 正しく押せる割合は66.3%から94.3%へ上がり、隣の押し間違いは3.0%から0.3%、すき間・外れは30.7%から5.3%へ減ります |
| スワイプの距離しきい値を変えて | 07 SWIPE_PX 40 → 80 | タッチの送りは95.0%から93.3%へ少し、マウスは96.7%から71.7%へ大きく減ります |
九つの場面のマークアップ・スタイル・スクリプトと react 版をまとめた zip は下の枠から受け取れます。圧縮を解く暗号は 7thjut9u です。
ブラウザ対応 — hoverとpointerクエリの対応範囲
デモはキャンバスに描くので、この表とは関係なく動きます。表は、自分の画面に移すときの最小バージョンを、MDNのブラウザ互換データ(mdn/browser-compat-data)から読んだ値です。
| 機能 | Chrome | Safari | Firefox | Edge |
|---|---|---|---|---|
@media (hover) 特性 |
38 | 9 | 64 | 12 |
@media (pointer) 特性 |
41 | 9 | 64 | 12 |
@media (any-hover) 特性 |
41 | 9 | 64 | 16 |
:focus-visible セレクター |
86 | 15.4 | 85 | Chromeの値に準拠 |
touch-action プロパティ |
36 | 13 | 52 | 12 |
PointerEvent(pointerType 含む) |
55 | 13 | 59 | 12 |
数字は対応が始まったバージョンです。Edgeの「Chromeの値に準拠」は、別のバージョンがなくミラー表示だけだったため、数字を書いていません。
出典: MDN hover · MDN pointer
出典: MDN touch-action · MDN PointerEvent
元データは browser-compat-data の css/at-rules/media.json・css/selectors/focus-visible.json・css/properties/touch-action.json・api/PointerEvent.json です。
どの行を見て使うか
いちばん遅いマスは、:focus-visible の Safari 15.4 です。それ未満の訪問者まで受けたいときは、:focus を基本の枠にして :focus-visible で上書きします。
タッチのアクセシビリティ — 貼れるCSSと代わりの入力
次は、読む人がそのまま貼って使えるCSSで、乗せる分岐・押した感・フォーカスの枠・最小の対象サイズを一つのブロックにまとめた例です。デモのソースではありません。.card は、自分の画面の要素のセレクターに置き換えてください。
@media (hover: hover) and (pointer: fine) {
.card:hover { transform: translateY(-4px); }
}
.card { min-height: 44px; min-width: 44px; }
.card:active { transform: scale(0.94); }
.card:focus-visible { outline: 2px solid #5b8def; outline-offset: 2px; }
対象サイズの基準は、WCAGの二つの達成基準に書かれています。24×24のCSSピクセルが最小(AA)、44×44が強化(AAA)です。
出典: WCAG 2.5.8 Target Size (Minimum)
出典: WCAG 2.5.5 Target Size (Enhanced)
05の場面の44pxの比較は、この値から来ています。
タッチモードのスイッチと自動デモ
九つの場面は時間表だけで動く自動デモで、操作しなくても最後まで再生されます。タッチモードのスイッチをTキーかボタンで入れると、html の data-input 属性が mouse と touch に切り替わり、ボタンの高さが大きくなって乗せる効果が切れます。
エミュレーションで測った値は未信頼です
Chrome のコンテキストにタッチとモバイルの設定を入れて開くと、matchMedia は (hover: none) と (pointer: coarse) がどちらも true を返しました。これはエミュレーション値で、実機では未確認です。
読み上げと一時停止
状態行は aria-live="off" なので、デモの最中には読まれず、role="status" の段落がモードの変わったときだけ読み上げます。
一時停止はSpace・Enter・P、最初からはRで、タブが隠れるとループが止まります。点滅は毎秒3回以下で、09の枠の脈動が毎秒1回でいちばん速くなっています。
タッチ操作のFAQ — hoverは消すべきか・どう知るか
スマホのhoverは消したほうがいいですか
消すのではなく、マウスの画面に絞ります。@media (hover: hover) の中に規則を移すと、タッチ画面で残るカードが0枚になり(03)、その場所には02の押した感を置きます。
タッチ機器かどうかはどう知りますか
CSSは @media (hover: none) や (pointer: coarse) の値で画面全体を分け、JSは pointerType で入力を一回ずつ分けます。タッチ付きのノートPCのように両方が混じる機器には、04が合います。
css スマホ hover はどう付けますか
押した感は :active、フォーカスの枠は :focus-visible、スライダーの方向分けは touch-action で付けます。css hover スマホ 無効にしたい部分は、上の貼れるCSSの分岐ブロックにまとまっているので、そのまま貼れます。
入力の種類の規則は、pointerTypeのドキュメントにあります。









