01드래그 거리에 보간되는 카드 회전
카드를 옆으로 끌면 이동 거리에 비례해 회전각이 부드럽게 보간되며 기울어진다.
쓰임추천 카드 넘기기 화면
SWIPE_VELOCITY_THRESHOLD_PX_MSROTATE_LERP_RATIOEXIT_PCT

<main class="stage">
<div class="dr is-demo" id="dr">
<p class="dr__caption">드래그 거리에 보간되는 카드 회전</p>
<div class="dr__scene" id="drScene">
<div class="dr__card" id="drCard" tabindex="0" role="group" aria-roledescription="스와이프 카드">
<p class="dr__label" id="drLabel">아침 루틴</p>
</div>
<button class="dr__btn dr__btn--nope" id="drNope" type="button" aria-label="싫어요">✕</button>
<button class="dr__btn dr__btn--like" id="drLike" type="button" aria-label="좋아요">♥</button>
</div>
<p class="dr__status" id="drStatus" aria-live="polite">대기 중</p>
</div>
</main>@use "../../../../site/static/demo-tokens" as *;
// 값 하나: 드래그 이동 거리(카드 폭 대비 %) 에 회전각이 lerp 되어 카드가 기울어진다.
// 해제 속도가 SWIPE_VELOCITY_THRESHOLD_PX_MS 를 넘으면 날아가고, 못 넘으면 lerp 로 되돌아온다.
$duration: $dur-base;
$easing: $ease-out;
$color: $subject-blue-deep;
@include stage($stage-paper);
.dr { display: grid; gap: $sp-2; justify-items: center; width: 100%; --tone: 0; }
.dr__caption { margin: 0; font-size: 12px; font-weight: 600; color: $subject-ink; }
.dr__scene {
position: relative;
width: 220px;
height: 190px;
border-radius: $r-card;
background: $subject-cream;
display: grid;
place-items: center;
}
.dr__card {
position: relative;
width: 160px;
height: 180px;
border-radius: $r-card;
background: linear-gradient(160deg, $subject-blue, $subject-sky);
box-shadow: $shadow-raised;
display: grid;
place-items: center;
touch-action: none;
cursor: grab;
will-change: transform;
}
.dr__card:active { cursor: grabbing; }
.dr__card:focus-visible { outline: 2px solid $subject-blue-light; outline-offset: 3px; }
.dr__label {
margin: 0;
font-size: 14px;
font-weight: 700;
color: $stage-paper;
padding: 0 $sp-3;
text-align: center;
}
.dr__btn {
position: absolute;
bottom: $sp-3;
width: 34px;
height: 34px;
border-radius: $r-pill;
border: 0;
background: $stage-paper;
box-shadow: $shadow-press;
font-size: 15px;
line-height: 1;
cursor: pointer;
display: grid;
place-items: center;
}
.dr__btn--nope { left: $sp-3; color: $error; }
.dr__btn--like { right: $sp-3; color: $subject-blue-deep; }
.dr__btn:focus-visible { outline: 2px solid $subject-blue-light; outline-offset: 2px; }
.dr__status { margin: 0; font-size: 11px; color: $subject-ink; font-weight: 600; }
@media (max-width: 340px) {
.dr { gap: $sp-2; }
.dr__scene { width: 150px; height: 108px; }
.dr__card { width: 78px; height: 92px; }
.dr__label { font-size: 10px; padding: 0 $sp-1; }
.dr__btn { width: 22px; height: 22px; font-size: 11px; bottom: $sp-1; }
.dr__btn--nope { left: $sp-1; }
.dr__btn--like { right: $sp-1; }
}
@media (prefers-reduced-motion: reduce) {
.dr__card { transition: none; }
}html, body {
margin: 0;
overflow: hidden;
}
.stage {
box-sizing: border-box;
min-height: 100vh;
display: grid;
place-items: center;
margin: 0;
background: #ffffff;
font-family: -apple-system, "Segoe UI", "Noto Sans KR", sans-serif;
padding: clamp(8px, 4vw, 24px);
}
.dr {
display: grid;
gap: 8px;
justify-items: center;
width: 100%;
--tone: 0;
}
.dr__caption {
margin: 0;
font-size: 12px;
font-weight: 600;
color: #17141a;
}
.dr__scene {
position: relative;
width: 220px;
height: 190px;
border-radius: 16px;
background: #fff7e6;
display: grid;
place-items: center;
}
.dr__card {
position: relative;
width: 160px;
height: 180px;
border-radius: 16px;
background: linear-gradient(160deg, #2f6df6, #6ec8ff);
box-shadow: 0 14px 24px rgba(23, 20, 26, 0.32);
display: grid;
place-items: center;
touch-action: none;
cursor: grab;
will-change: transform;
}
.dr__card:active {
cursor: grabbing;
}
.dr__card:focus-visible {
outline: 2px solid #5b8cf8;
outline-offset: 3px;
}
.dr__label {
margin: 0;
font-size: 14px;
font-weight: 700;
color: #ffffff;
padding: 0 12px;
text-align: center;
}
.dr__btn {
position: absolute;
bottom: 12px;
width: 34px;
height: 34px;
border-radius: 999px;
border: 0;
background: #ffffff;
box-shadow: 0 6px 12px rgba(23, 20, 26, 0.32);
font-size: 15px;
line-height: 1;
cursor: pointer;
display: grid;
place-items: center;
}
.dr__btn--nope {
left: 12px;
color: #c2361a;
}
.dr__btn--like {
right: 12px;
color: #0a4fe8;
}
.dr__btn:focus-visible {
outline: 2px solid #5b8cf8;
outline-offset: 2px;
}
.dr__status {
margin: 0;
font-size: 11px;
color: #17141a;
font-weight: 600;
}
@media (max-width: 340px) {
.dr {
gap: 8px;
}
.dr__scene {
width: 150px;
height: 108px;
}
.dr__card {
width: 78px;
height: 92px;
}
.dr__label {
font-size: 10px;
padding: 0 4px;
}
.dr__btn {
width: 22px;
height: 22px;
font-size: 11px;
bottom: 4px;
}
.dr__btn--nope {
left: 4px;
}
.dr__btn--like {
right: 4px;
}
}
@media (prefers-reduced-motion: reduce) {
.dr__card {
transition: none;
}
}(function () {
"use strict";
// 값 하나: 드래그 이동 거리(카드 폭 대비 %)에 회전각이 lerp 되어 기울어진다.
var ROTATE_LERP_RATIO = 0.55;
var ROTATE_MAX_DEG = 26;
// 변형 3: 01 도 해제 판정을 가진다 — 속도가 이 값을 넘으면 날아가고 못 넘으면 되돌아온다.
var SWIPE_VELOCITY_THRESHOLD_PX_MS = 0.3;
var SETTLE_RATE = 0.24;
var EXIT_PCT = 165;
var CYCLE_S = 2;
var root = document.getElementById("dr");
var card = document.getElementById("drCard");
var label = document.getElementById("drLabel");
var status = document.getElementById("drStatus");
var btnLike = document.getElementById("drLike");
var btnNope = document.getElementById("drNope");
var reduce = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
function seedRand(seed) {
var s = seed >>> 0;
return function () { s = (s * 1664525 + 1013904223) >>> 0; return s / 4294967296; };
}
function clamp(v, lo, hi) { return Math.max(lo, Math.min(hi, v)); }
var CARDS = ["아침 루틴", "저녁 산책", "주말 카페", "홈트 기록", "독서 목록", "여행 메모"];
var rand = seedRand(11);
var idx = Math.floor(rand() * CARDS.length);
var dragging = false;
var startX = 0, lastX = 0, lastT = 0, vx = 0;
var pctX = 0;
var phase = "idle"; // idle | exit | settle
var exitDir = 1, exitPct = 0;
function setCard() { label.textContent = CARDS[idx % CARDS.length]; }
setCard();
function render() {
var rot = clamp(pctX * ROTATE_LERP_RATIO, -ROTATE_MAX_DEG, ROTATE_MAX_DEG);
card.style.transform = "translateX(" + pctX.toFixed(2) + "%) rotate(" + rot.toFixed(2) + "deg)";
root.style.setProperty("--tone", clamp(Math.abs(pctX) / 42, 0, 1).toFixed(2));
}
function nextCard() {
idx += 1; setCard();
pctX = 0; phase = "idle";
card.style.transform = "translateX(0%) rotate(0deg)";
root.style.setProperty("--tone", "0");
status.textContent = "대기 중";
}
function judge(velocity, dir) {
root.classList.remove("is-demo");
var flung = Math.abs(velocity) >= SWIPE_VELOCITY_THRESHOLD_PX_MS;
if (reduce) {
if (flung) { status.textContent = dir > 0 ? "좋아요 처리됨" : "싫어요 처리됨"; nextCard(); }
else { pctX = 0; render(); status.textContent = "제자리로 돌아옴"; phase = "idle"; }
return;
}
if (flung) {
phase = "exit"; exitDir = dir; exitPct = pctX;
status.textContent = dir > 0 ? "좋아요 처리됨" : "싫어요 처리됨";
} else {
phase = "settle";
status.textContent = "제자리로 돌아옴";
}
}
function startDrag(clientX) {
root.classList.remove("is-demo");
dragging = true; phase = "idle";
startX = clientX; lastX = clientX; lastT = performance.now(); vx = 0;
}
function moveDrag(clientX) {
if (!dragging) return;
var rect = card.getBoundingClientRect();
var now = performance.now();
var dt = Math.max(now - lastT, 1);
vx = (clientX - lastX) / dt;
lastX = clientX; lastT = now;
pctX = ((clientX - startX) / rect.width) * 100;
render();
}
function endDrag() {
if (!dragging) return;
dragging = false;
judge(vx, pctX >= 0 ? 1 : -1);
}
card.addEventListener("pointerdown", function (e) { card.setPointerCapture(e.pointerId); startDrag(e.clientX); });
card.addEventListener("pointermove", function (e) { moveDrag(e.clientX); });
card.addEventListener("pointerup", endDrag);
card.addEventListener("pointercancel", endDrag);
function keyVerdict(dir) {
root.classList.remove("is-demo");
pctX = dir * 60;
render();
judge(SWIPE_VELOCITY_THRESHOLD_PX_MS + 0.2, dir);
}
card.addEventListener("keydown", function (e) {
if (e.key === "ArrowRight") { e.preventDefault(); keyVerdict(1); }
else if (e.key === "ArrowLeft") { e.preventDefault(); keyVerdict(-1); }
});
btnLike.addEventListener("click", function () { keyVerdict(1); });
btnNope.addEventListener("click", function () { keyVerdict(-1); });
function step(dt) {
if (phase === "exit") {
exitPct += exitDir * dt * 0.46;
pctX = exitPct;
render();
if (Math.abs(exitPct) > EXIT_PCT) nextCard();
} else if (phase === "settle") {
pctX += (0 - pctX) * SETTLE_RATE;
render();
if (Math.abs(pctX) < 0.3) { pctX = 0; phase = "idle"; render(); }
}
}
// .is-demo 자동 시연: 실제 pointer 없이 pctX·judge() 를 같은 경로로 호출한다.
var start = null, lastNow = 0, prevT = 0, synthPhase = "wait";
function synth(t) {
if (t > 0.5 && t < 0.85 && synthPhase === "wait") synthPhase = "dragLike";
if (synthPhase === "dragLike") {
var p = clamp((t - 0.5) / 0.35, 0, 1);
pctX = p * 46; render();
if (t >= 0.85) { synthPhase = "afterLike"; judge(SWIPE_VELOCITY_THRESHOLD_PX_MS + 0.3, 1); }
}
if (t > 1.25 && t < 1.55 && synthPhase === "afterLike") synthPhase = "dragWeak";
if (synthPhase === "dragWeak") {
var q = clamp((t - 1.25) / 0.3, 0, 1);
pctX = q * 9; render();
if (t >= 1.55) { synthPhase = "done"; judge(0.05, 1); }
}
}
function loop(now) {
if (start === null) { start = now; lastNow = now; lastT = now; }
var dt = Math.min(now - lastNow, 48);
lastNow = now;
var t = ((now - start) / 1000) % CYCLE_S;
if (t < prevT) synthPhase = "wait";
prevT = t;
if (!reduce && root.classList.contains("is-demo")) synth(t);
if (!reduce) step(dt);
requestAnimationFrame(loop);
}
requestAnimationFrame(loop);
})();// DragRotateLerpSwipeCard — vanilla 판(run/422/demo/01-swipe-deck-precision-drag-rotate-lerp/index.html) 의 React 포트.
// 값 하나: 놓는 순간 속도(px/ms) 가 SWIPE_VELOCITY_THRESHOLD_PX_MS 를 넘는지로 스와이프를 판정한다.
// 드래그 중 각도는 카드 폭 대비 이동 비율(pctX)에 ROTATE_LERP_RATIO 를 곱해 정한다.
import { useEffect, useRef, useState } from "react";
import type { PointerEvent as ReactPointerEvent } from "react";
import styles from "./DragRotateLerpSwipeCard.module.scss";
type Box<T> = { current: T };
const SWIPE_VELOCITY_THRESHOLD_PX_MS = 0.3;
const ROTATE_LERP_RATIO = 0.55;
const ROTATE_MAX_DEG = 26;
const SETTLE_RATE = 0.24;
const EXIT_PCT = 165;
const CARD_WIDTH = 160;
const CYCLE_S = 2;
const CARDS = ["아침 루틴", "저녁 산책", "주말 카페", "홈트 기록", "독서 목록", "여행 메모"];
function seedRand(seed: number) {
let s = seed >>> 0;
return function (): number {
s = (s * 1664525 + 1013904223) >>> 0;
return s / 4294967296;
};
}
function clamp(v: number, lo: number, hi: number): number {
return Math.max(lo, Math.min(hi, v));
}
export default function DragRotateLerpSwipeCard() {
const cardRef = useRef<HTMLDivElement | null>(null);
const pctXRef = useRef<number>(0) as Box<number>;
const vxRef = useRef<number>(0) as Box<number>;
const phaseRef = useRef<string>("idle") as Box<string>;
const exitDirRef = useRef<number>(1) as Box<number>;
const draggingRef = useRef<boolean>(false) as Box<boolean>;
const startXRef = useRef<number>(0) as Box<number>;
const lastXRef = useRef<number>(0) as Box<number>;
const lastTRef = useRef<number>(0) as Box<number>;
const idxRef = useRef<number>(Math.floor(seedRand(11)() * CARDS.length)) as Box<number>;
const frameRef = useRef<number>(0) as Box<number>;
const [label, setLabel] = useState(CARDS[idxRef.current % CARDS.length]);
const [status, setStatus] = useState("대기 중");
const [demo, setDemo] = useState(true);
const [reduce, setReduce] = useState(false);
function render(): void {
const card = cardRef.current;
if (!card) return;
const rot = clamp(pctXRef.current * ROTATE_LERP_RATIO, -ROTATE_MAX_DEG, ROTATE_MAX_DEG);
const xPx = (pctXRef.current / 100) * CARD_WIDTH;
card.style.transform = "translateX(" + xPx.toFixed(1) + "px) rotate(" + rot.toFixed(2) + "deg)";
}
function nextCard(): void {
idxRef.current += 1;
setLabel(CARDS[idxRef.current % CARDS.length]);
pctXRef.current = 0; vxRef.current = 0; phaseRef.current = "idle";
render();
setStatus("대기 중");
}
function judge(velocity: number, dir: number): void {
setDemo(false);
const flung = Math.abs(velocity) >= SWIPE_VELOCITY_THRESHOLD_PX_MS;
if (reduce) {
if (flung) { setStatus(dir > 0 ? "좋아요 처리됨" : "싫어요 처리됨"); nextCard(); }
else { pctXRef.current = 0; render(); setStatus("제자리로 돌아옴"); phaseRef.current = "idle"; }
return;
}
if (flung) {
phaseRef.current = "exit"; exitDirRef.current = dir;
setStatus(dir > 0 ? "좋아요 처리됨" : "싫어요 처리됨");
} else {
phaseRef.current = "settle";
setStatus("제자리로 돌아옴");
}
}
function startDrag(clientX: number): void {
setDemo(false);
draggingRef.current = true; phaseRef.current = "idle";
startXRef.current = clientX; lastXRef.current = clientX; lastTRef.current = performance.now(); vxRef.current = 0;
}
function moveDrag(clientX: number): void {
if (!draggingRef.current) return;
const now = performance.now();
const dt = Math.max(now - lastTRef.current, 1);
vxRef.current = (clientX - lastXRef.current) / dt;
lastXRef.current = clientX; lastTRef.current = now;
pctXRef.current = ((clientX - startXRef.current) / CARD_WIDTH) * 100;
render();
}
function endDrag(): void {
if (!draggingRef.current) return;
draggingRef.current = false;
judge(vxRef.current, pctXRef.current >= 0 ? 1 : -1);
}
function onPointerDown(e: ReactPointerEvent<HTMLDivElement>): void {
e.currentTarget.setPointerCapture(e.pointerId);
startDrag(e.clientX);
}
function onPointerMove(e: ReactPointerEvent<HTMLDivElement>): void { moveDrag(e.clientX); }
function onPointerUp(): void { endDrag(); }
function keyVerdict(dir: number): void {
setDemo(false);
pctXRef.current = dir * 40; render();
judge(dir * (SWIPE_VELOCITY_THRESHOLD_PX_MS + 0.2), dir);
}
function onKeyDown(e: any): void {
if (e.key === "ArrowRight") { e.preventDefault(); keyVerdict(1); }
else if (e.key === "ArrowLeft") { e.preventDefault(); keyVerdict(-1); }
}
function step(dt: number): void {
if (phaseRef.current === "exit") {
pctXRef.current += exitDirRef.current * Math.max(Math.abs(vxRef.current) * 100, SWIPE_VELOCITY_THRESHOLD_PX_MS * 140) * (dt / 6);
render();
if (Math.abs(pctXRef.current) > EXIT_PCT) nextCard();
} else if (phaseRef.current === "settle") {
pctXRef.current += (0 - pctXRef.current) * SETTLE_RATE;
render();
if (Math.abs(pctXRef.current) < 0.6) { pctXRef.current = 0; phaseRef.current = "idle"; render(); }
}
}
function synth(t: number, synthPhaseRef: Box<string>): void {
if (t > 0.5 && t < 0.85 && synthPhaseRef.current === "wait") synthPhaseRef.current = "dragLike";
if (synthPhaseRef.current === "dragLike") {
const p = clamp((t - 0.5) / 0.35, 0, 1);
pctXRef.current = p * 70; render();
if (t >= 0.85) { synthPhaseRef.current = "afterLike"; judge(SWIPE_VELOCITY_THRESHOLD_PX_MS + 0.35, 1); }
}
if (t > 1.25 && t < 1.55 && synthPhaseRef.current === "afterLike") synthPhaseRef.current = "dragWeak";
if (synthPhaseRef.current === "dragWeak") {
const q = clamp((t - 1.25) / 0.3, 0, 1);
pctXRef.current = -q * 30; render();
if (t >= 1.55) { synthPhaseRef.current = "done"; judge(0.05, -1); }
}
}
useEffect(() => {
setReduce(window.matchMedia("(prefers-reduced-motion: reduce)").matches);
}, []);
useEffect(() => {
let start = 0, lastNow = 0, prevT = 0;
const synthPhaseRef: Box<string> = { current: "wait" };
function loop(now: number): void {
if (start === 0) { start = now; lastNow = now; }
const dt = Math.min(now - lastNow, 48);
lastNow = now;
const t = ((now - start) / 1000) % CYCLE_S;
if (t < prevT) synthPhaseRef.current = "wait";
prevT = t;
if (!reduce && demo) synth(t, synthPhaseRef);
if (!reduce) step(dt);
frameRef.current = requestAnimationFrame(loop);
}
frameRef.current = requestAnimationFrame(loop);
return () => cancelAnimationFrame(frameRef.current);
}, [reduce, demo]);
return (
<main className={styles.stage}>
<div className={styles.dr}>
<p className={styles.caption}>드래그 비율에 회전을 곱하는 카드</p>
<div className={styles.scene}>
<div
className={styles.card}
ref={cardRef}
tabIndex={0}
role="group"
aria-roledescription="스와이프 카드"
onPointerDown={onPointerDown}
onPointerMove={onPointerMove}
onPointerUp={onPointerUp}
onKeyDown={onKeyDown}
>
<p className={styles.label}>{label}</p>
</div>
<button className={styles.btnNope} type="button" aria-label="싫어요" onClick={() => keyVerdict(-1)}>✕</button>
<button className={styles.btnLike} type="button" aria-label="좋아요" onClick={() => keyVerdict(1)}>♥</button>
</div>
<p className={styles.status} aria-live="polite">{status}</p>
</div>
</main>
);
}01 드래그 거리에 보간되는 카드 회전 — 측정 누적면적 49.342% · 움직인 프레임 6/23GODRICH 원작 · zip 에 SCSS·React 포함 · 카드 스와이프 ui 9가지 — 드래그를 물리 계산으로 다듬기
이 데모가 속한 글
카드 스와이프 ui 9가지 — 드래그를 물리 계산으로 다듬기카드 스와이프 ui 아홉 개를 모아 놓고 봤다. 엄지 끝 속도가 02번 기준을 넘지 못한 순간, 카드는 손을 놓아도 날아가지 않고 03번처럼 스프링으로 튕겨 제자리에 앉는다. 마지막 장까지 넘긴 자리엔 08번 빈 카 이 글의 데모 전부 보기


