GODRICH
#css애니메이션#버튼#로딩#전환효과#스크롤#대시보드#실전ui#디자인트렌드

bottom sheet ui 바텀 시트 9종 — 스냅 포인트 계산과 던짐 속도 판정

바텀 시트가 단계에서 멈추는 건 마법이 아니라 거리 계산이다 — 01번은 손을 뗀 지점에서 가장 가까운 스냅 포인트를 찾고, 02번은 던짐 속도가 임계를 넘으면 다음 단계로 통과시킨다. bottom sheet ui 의 본질은 애니메이션이 아니라 이 단계 판정 기계다.

zip 구성과 여는 법

아홉 개의 순서는 시트가 한 번의 드래그에서 겪는 판정 순서다. 01 놓인 높이의 최근접 스냅, 02 던짐 속도 임계, 03 어디를 잡았는지의 드래그 영역, 04 배경 어둡기 보간, 05 내부 스크롤 경계, 06 선택 즉시 닫힘, 07 필터 게이트, 08 축 잠금 삭제 목록, 09 탭 펄스 열기. 앞의 다섯이 판정의 몸통이고 뒤의 넷이 그 판정이 실제 화면에서 만나는 상황들이다. 미리 적는다 — 각 장면의 재생은 결정적 좌표 시퀀스를 판정 함수에 흘려 넣는 주입 시연이다. 사람이 pointerdown·pointermove·pointerup 으로 조작할 때와 같은 핸들러 체인을 타지만, 아래 측정값·gif·포스터의 움직임은 전부 주입 시연의 결과이지 손 조작 실측이 아니다.

바텀 시트 9종 — 3단 스냅·던짐 판정·핸들 드래그 영역·백드랍 보간·내부 스크롤 경계·옵션 시트·필터 시트·스와이프 삭제 목록·탭 펄스로 열기

아홉 장면을 렌더해서 잰 값은 아래 표로 모은다. 숫자는 도구/demo.py 가 480×300 안쪽 상자를 2초 24장 찍고 이웃한 두 장의 차 23개로 잰 렌더 실측이며 측정 시각은 2026-11-17 04:28 이다. 누적면적은 첫 프레임과 한 번이라도 달라진 픽셀의 비율, 강도는 그 픽셀의 평균 색 차(0~255), 움직인 프레임은 변화가 있던 장의 개수다.

항목 장면 누적면적 강도 움직인 프레임
01 3단 최근접 스냅 30.4% 76.4 23/23
02 던짐 속도 판정 30.6% 76.6 23/23
03 핸들 드래그 영역 31.7% 81.8 23/23
04 백드랍 보간 36.1% 65.6 23/23
05 내부 스크롤 경계 37.7% 95.3 23/23
06 옵션 선택 닫힘 37.4% 121.5 23/23
07 필터 게이트 33.5% 123.6 23/23
08 축 잠금 삭제 목록 4.6% 117.6 23/23
09 탭 펄스 열기 37.4% 87.1 23/23

여덟 장면이 누적면적 30% 를 넘겼다 — 스냅 이동이 시트만 움직이는 게 아니라 단계 비율을 받는 백드랍까지 함께 어둡게 만들기 때문이다. 08 이 4.6% 로 작은 건 정상이다. 행 하나가 가로로 120px 미끄러지는 것이 장면의 전부인 컴포넌트형이라 면적 대신 첫 8px 의 축 잠금 판정이라는 정교함 한 겹으로 잰다. 이 수치는 캡처 상자 안에서 잰 화면 변화량일 뿐 실제 페이지의 성능 지표는 아니다.

손가락을 떼면 시트는 어디로 가나 — 스냅 포인트까지의 거리를 재어 가장 가까운 단계를 정하는 판정과 동점 규칙

bottom sheet ui design 의 첫 단추는 스냅 지점을 몇 개로 두느냐다. 이 데모는 닫힘 0px · 반 196px · 전체 392px 의 세 지점이고, 판정은 식 하나다 — 놓인 높이 h 에 대해 각 지점까지의 거리 |h − p| 를 재 가장 작은 지점으로 이동한다. 120px 에서 손을 떼면 반까지 76px · 전체까지 272px 이라 반으로 떨어지는 식이다.

동점이 문제가 된다. 반과 전체의 중간인 294px 에서 손을 떼면 |294−196| = |294−392| = 98px 로 두 거리가 같다. 이때 승자는 비교 연산자 하나가 정한다. 아래 코드는 < 로 비교하므로 배열에서 먼저 검사한 지점이 타이를 유지하고, 스냅 지점 배열 [0, 196, 392] 에서 196 이 392 보다 앞서므로 294 놓기는 반으로 스냅된다. <= 로 고치는 순간 전체가 이기고 판정이 뒤집힌다 — 규칙을 정하지 않은 채로 두면 같은 제스처가 기기마다 다른 단계로 떨어지는 셈이다.

    function nearestSnap(h, pts) {
        let best = pts[0];
        let bestD = Infinity;
        for (let i = 0; i < pts.length; i += 1) {
            const distance = Math.abs(h - pts[i]); // 각 지점까지의 거리
            if (distance < bestD) {
                bestD = distance;
                best = pts[i];
            } // 등호 없음 = 타이면 먼저 온 지점이 유지된다
        }
        return best;
    }

01손 뗀 곳에서 가장 가까운 단계로 멈추는 3단 스냅

294px 와 120px 두 높이에서 손을 떼는 프리셋을 번갈아 보여 준다. 놓기 순간 목적지가 한 번 정해지면 travel 의 ease-out cubic 이 460ms 에 걸쳐 그 지점까지 끌어올린다.

손 뗀 곳에서 가장 가까운 단계로 멈추는 3단 스냅
전체 코드 새 창에서 열기

01 · 손 뗀 곳에서 가장 가까운 단계로 멈추는 3단 스냅 — 측정 누적면적 30.438% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

snapPointsnearestdistance
        else {
            // 놓기 — 최근접 거리 판정으로 스냅 이동(travel). 판정은 놓기 순간 한 번
            h = travel(t, rh, nearestSnap(rh, SNAP_POINTS_PX), RELEASE1_AT, SNAP_MS);
            ph = t < RELEASE1_AT + SNAP_MS ? '스냅 이동' : '도착';
        }
        putSheet(sh01, h);
        setDim(bd01, h, 1.0, 0.44);
        dA01 = Math.abs(h - 196);
        dB01 = Math.abs(h - 392);

세게 던지면 다음 단계까지 통과시키는 속도 임계 — px/ms 놓기 속도를 마지막 네 좌표의 짧은 창으로 재는 계산

거리만으로 정하면 서운한 순간이 있다. 반 바로 위에서 손을 떼 위로 스치듯 튕겼는데 시트가 제자리로 떨어지는 것이다. 02가 그 불만을 풀 판정이다. 놓기 속도 v(px/ms)를 잰 뒤 임계 FLING_MS(0.5px/ms)를 넘었으면 최근접 단계를 무시하고 던진 방향의 다음 단계로 통과시킨다. 위로 던졌으면 더 높은 단계, 아래로 던졌으면 더 낮은 단계 — 방향이 우선순위를 갖는 계산이다.

속도를 재는 법이 절반이다. 마지막 한 좌표와 그 직전의 차만 쓰면 렌더 지터 한 번에 임계가 오작동한다. 실입력 경로는 포인터 히스토리의 마지막 네 지점을 편다 — (b.y − a.y)·2 를 시간차로 나눈 값이 vMs 이고, ×2는 화면 좌표를 시트의 가상 높이로 되돌리는 보정이다. 아래 코드가 그 창 계산과 목적지 판정 전부다.

        const a = hist02[hist02.length - 1];
        const b = hist02[Math.max(0, hist02.length - 4)];
        const dt = Math.max(1, a.t - b.t);
        const vMs = ((b.y - a.y) * 2) / dt; // 위로 끌면 양수(px/ms)
        const threshold = FLING_MS; // threshold — 속도 임계(px/ms)
        let h = 196;
        for (let k = 0; k < hist02.length; k += 1) {
            h = clamp(196 + (hist02[0].y - hist02[k].y) * 2, 0, 392);
        }
        const dest = flingSnap(h, vMs, SNAP_POINTS_PX, FLING_MS);

02세게 던지면 다음 단계까지 통과시키는 속도 판정

같은 294px 에서 놓는 두 손놀림을 나란히 보여 준다 — 프리셋 0은 마지막 구간이 가속되는 드래그, 프리셋 1은 끝에서 속도가 죽는 완화 상승이다. 주입 경로의 놓기 순간 속도는 40ms 창 차로 잰다. 프리셋 0의 놓기 속도는 0.24px/ms 로 0.5 임계에 미달해 두 프리셋 모두 최근접 판정으로 반에 떨어지고, 임계를 넘는 던짐이 반을 건너뛰어 전체로 가는 갈림길은 flingSnap 의 방향 분기다(장면 표시 문구의 0.60·0.20px/ms 는 전형값 예시다).

세게 던지면 다음 단계까지 통과시키는 속도 판정
전체 코드 새 창에서 열기

02 · 세게 던지면 다음 단계까지 통과시키는 속도 판정 — 측정 누적면적 30.645% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

FLING_MSvelocitythreshold
    function flingSnap(h, vMs, pts, thr) {
        if (Math.abs(vMs) >= thr) {
            const up = vMs > 0;
            const hi = pts.filter(function (p) { return p > h; });
            const lo = pts.filter(function (p) { return p < h; });
            if (up && hi.length) {
                return hi[0];
            }
            if (!up && lo.length) {
                return lo[lo.length - 1];
            }
        }
        return nearestSnap(h, pts);
    }

드래그하는 동안 시트가 손가락을 그대로 따라가는 이유 — 이동량을 그대로 반영하는 추적 비율과 잡을 수 있는 영역

시트가 손끝에 붙어 다니는 건 추적 비율이 1이기 때문이다. 드래그 중 시트 높이는 h = 시작 높이 + (baseY − 지금 y) × 2 × DRAG_FOLLOW 로 매 pointermove 마다 다시 계산되는데, ×2는 손가락 이동을 가상 높이로 되돌리는 배율이고 DRAG_FOLLOW 1.0은 이동량을 그대로 반영하라는 뜻이다. 이 값을 0.55 로 낮추면 시트가 반 박자 늦게 끌려오는 무게 있는 판이 된다(변형 표 참고).

그런데 시트 전체가 드래그를 받으면 목록이 고장 난다. 잡을 수 있는 영역을 가르는 판정이 필요하다. pointerdown 이 들어왔을 때 시작 대상이 헤더(.sh-head) 안인지 containment 검사 한 번으로 보고, 안이면 소유권이 시트 드래그로, 밖이면 본문 스크롤로 갈린다. 판정은 시작 순간 한 번이고 드래그 도중에 다시 뒤집지 않는다.

03헤더·핸들에서만 잡히는 드래그 영역 판정

같은 손놀림을 다른 자리에서 시작하는 두 프리셋이다. 핸들에서 시작하면 시트가 반과 전체 사이를 오르내리고, 본문에서 시작하면 시트는 그 자리에 붙어 목록 46px 이 스크롤된다.

헤더·핸들에서만 잡히는 드래그 영역 판정
전체 코드 새 창에서 열기

03 · 헤더·핸들에서만 잡히는 드래그 영역 판정 — 측정 누적면적 31.67% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

containsdragZoneownership
        const inHead = sh03.head.contains(ev.target);
        owner03 = inHead ? 'sheet' : 'body';
        if (inHead) {
            down03 = true;
            baseY03 = stagePoint(ev).y;
            ev.preventDefault();
        }
    });
    sceneEl.addEventListener('pointermove', function (ev) {
        if (down03 && sh03) {
            const h = clamp(196 + (baseY03 - stagePoint(ev).y) * 2, 0, 392);
            putSheet(sh03, h);

시트 뒤 배경은 왜 단계마다 어두워지나 — 단계 비율을 지수로 구부려 알파에 옮기는 백드랍 보간

모달 배경이 서서히 어두워지는 건 알파가 시트 위치를 따라 실시간으로 계산되기 때문이다. 식은 alpha = (h ÷ 392)^DIM_CURVE × 0.44 다. 높이를 최대로 나눈 비율 0~1 을 지수 DIM_CURVE 로 구부린 뒤 최대 알파 0.44 에 곱한다. 지수 1.0은 비율 그대로의 차분한 어둡기고, 1.8로 올리면 조금만 올라도 급하게 어두워진다. h=148 을 검산하면 ratio 0.378 · 지수 1.0의 알파 0.166 · 지수 1.8의 알파 0.077 — 같은 높이에서 두 배 가까이 어둡기가 갈린다.

보간이 단계색이 아니라 연속색이라는 점이 디자인의 절반이다. 스냅 지점에서만 알파를 바꾸면 드래그 중 배경이 계단처럼 뛰는데, setDim 은 매 프레임 ratio를 다시 계산하므로 드래그 중에도 닫힘 0.00 에서 전체 0.44 까지 단계 없이 이어진다.

04단계 비율만큼 어두워지는 백드랍 보간

반(196)을 중심으로 46~346px 를 오르내리는 진동을 시트에 주고, 첫 프리셋은 지수 1.0 · 두 번째 프리셋은 1.8로 백드랍을 다시 칠한다. 같은 움직임에 배경 어둡기의 성격이 어떻게 바뀌는지가 이 장면의 전부다.

단계 비율만큼 어두워지는 백드랍 보간
전체 코드 새 창에서 열기

04 · 단계 비율만큼 어두워지는 백드랍 보간 — 측정 누적면적 36.067% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

DIM_CURVEalphainterp
    function setDim(bd, h, curve, maxA) {
        if (!bd) {
            return;
        }
        const ratio = clamp(h / 392, 0, 1);
        const interp = Math.pow(ratio, curve); // 보간값 — ratio^DIM_CURVE
        const alpha = interp * maxA;
        bd.style.opacity = f2(alpha);
    }

시트 안에 스크롤이 있으면 왜 드래그와 싸우나 — 위 끝 판정과 touch-action 이 만드는 경계와 함정

시트 안에 스크롤 목록이 있으면 시트 드래그와 목록 스크롤이 같은 손가락을 두고 싸운다. 05의 경계 판정은 첫 방향에서 한 번만 한다. 손가락이 처음 4px 넘게 움직였을 때 위로 끄는 중이면 본문 스크롤, 아래로 끄는 중이고 본문이 최상단(scrollTop === 0)이면 시트 드래그로 handover 한다. 한 번 정해진 모드는 손을 뗄 때까지 바뀌지 않는다.

05위 끝에서만 드래그로 넘어오는 내부 스크롤 경계

위 끝에서만 드래그로 넘어오는 내부 스크롤 경계
전체 코드 새 창에서 열기

05 · 위 끝에서만 드래그로 넘어오는 내부 스크롤 경계 — 측정 누적면적 37.705% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

scrollTophandovertouch-action
        if (mode05 === null) {
            // 첫 방향에서 판정 — 본문이 최상단이 아니면 무조건 본문. 최상단 + 아래로 끌기만 시트
            if (dy < -4) {
                mode05 = (sc05.scrollTop === 0) ? 'sheet' : 'body';
            }
            else if (dy > 4) {
                mode05 = 'body';
            }
        }
        if (mode05 === 'sheet') {
            const h = clamp(196 + dy * 2, 0, 392);
            putSheet(sh05, h);
            setDim(bd05, h, 1.0, 0.44);
        }

이 판정이 살아 있으려면 CSS 의 touch-action 나눠주기가 짝이어야 한다. 시트 본문은 pan-y 로 브라우저의 세로 팬을 살려 두고, 드래그 판정만 JS 로 가져온다. 두 프리셋은 그 경계의 양쪽이다 — 목록이 최상단일 때는 아래로 끄는 손이 시트를 끌어 내려 닫힘까지 가고, 목록 중간일 때는 같은 손놀림이 60px 의 목록 스크롤로 끝난다.

항목을 고르면 바로 닫히는 옵션 시트와 조건이 갖춰져야 닫히는 필터 시트

옵션 시트의 계약은 「선택 = 닫힘」이다. 항목을 고르면 이전 선택의 체크가 사라지고 새 항목으로 옮겨진 뒤 340ms(AUTOCLOSE_MS) 머무르고, 그다음 travel 로 닫힘 단계까지 420ms 에 내려간다. 여기서 함정은 스냅 엔진을 재사용하는 순간 생긴다 — 목적지를 nearestSnap 에 맡기면 닫힘이 아니라 「가까운 단계」로 가버려 선택과 닫힘이 두 동작으로 깨진다. 그래서 판정을 거치지 않고 state06 을 close 로 바꿔 닫힘으로 직행한다.

06선택 즉시 체크가 옮겨지고 닫히는 옵션 시트

선택 후 머묾과 닫힘이 한 동작으로 이어지는 상태 전환이다. 체크 이동 160ms · 머묾 340ms · 닫힘 420ms 의 세 구간이 한 주기 안에 압축되어 있다.

선택 즉시 체크가 옮겨지고 닫히는 옵션 시트
전체 코드 새 창에서 열기

06 · 선택 즉시 체크가 옮겨지고 닫히는 옵션 시트 — 측정 누적면적 37.363% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

checkedautoClosestate
        else if (t < pickAt + 160 + AUTOCLOSE_MS) {
            h = 196;
            ph = '자동 닫힘';
            state06 = autoClose ? 'close' : 'pick';
        }
        else {
            h = travel(t, 196, 0, pickAt + 160 + AUTOCLOSE_MS, CLOSE_MS);
            ph = t < pickAt + 160 + AUTOCLOSE_MS + CLOSE_MS ? '자동 닫힘' : '닫힘';
        }
        putSheet(sh06, h);
        setDim(bd06, h, 1.0, 0.44);

필터 시트는 반대 계약이다 — 최소 선택 수(1개)와 가격 범위의 순서(min ≤ max)를 매 입력마다 applyGate 로 재검사하고, 둘 다 참일 때만 적용 버튼이 살아나고 조건이 갖춰지지 않은 동안은 닫힘이 막혀 시트가 붙어 있다.

07조건이 갖춰져야 적용 버튼이 사는 필터 시트

위반(선택 0 · 900 > 200)에서 수리(선택 채움 · 100 ≤ 200)로 가는 흐름을 보여 주고, 버튼은 aria-disabled 로 상태를 알린다.

조건이 갖춰져야 적용 버튼이 사는 필터 시트
전체 코드 새 창에서 열기

07 · 조건이 갖춰져야 적용 버튼이 사는 필터 시트 — 측정 누적면적 33.546% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

applyGateminSelectenabled
    function applyGate07() {
        const chipOn = chips07.filter(function (c) { return c.getAttribute('aria-pressed') === 'true'; }).length;
        const ok = chipOn >= MIN_SELECT;
        if (btn07) {
            btn07.setAttribute('aria-disabled', ok ? 'false' : 'true');
            btn07.className = cx(ok ? 'applybtn is-enabled' : 'applybtn');
        }
        return ok;
    }

시트 안 목록에서 가로·세로 제스처가 갈라지는 지점

시트 안 목록에서 가로 스와이프 삭제와 세로 시트 드래그가 공존하려면 어느 쪽인지 빨리 정해야 한다. 첫 8px(AXIS_LOCK_PX) 이동의 가로·세로 비율로 축을 한 번 잠근다. |dx|가 |dy|보다 크면 x 축 — 항목이 삭제 존으로 미끄러지고, 반대면 y 축 — 시트가 드래그된다. 한 번 잠긴 축은 pointerup 까지 불변이다.

08가로·세로 제스처 우선순위를 가르는 삭제 목록 내장

프리셋 0은 첫 8px 가로 이동 뒤 120px(DEL_W)까지 cubic ease-out 으로 미끄러진 뒤 사라지는 행을, 프리셋 1은 같은 시작을 세로로 잠가 시트가 반에서 전체로 오르는 모습을 보여 준다.

가로·세로 제스처 우선순위를 가르는 삭제 목록 내장
전체 코드 새 창에서 열기

08 · 가로·세로 제스처 우선순위를 가르는 삭제 목록 내장 — 측정 누적면적 4.619% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

axisLockpriorityswipeDelete
    function axisLock(dx, dy) {
        if (Math.abs(dx) < AXIS_LOCK_PX && Math.abs(dy) < AXIS_LOCK_PX) {
            return null;
        }
        return Math.abs(dx) > Math.abs(dy) ? 'x' : 'y';
    }
    const priority = 'x>delete,y>sheet'; // priority — 가로 삭제·세로 시트 우선순위
    function swipeDelete(w) {
        if (del08) {
            del08.style.opacity = w > 40 ? '1' : '0';
        }
    }

드래그 없는 경로도 필요하다. 하단 탭을 누르면 260ms(PULSE_MS)의 펄스 링(scale 0.4→2.0)이 번지고 시트는 같은 스냅 도착 계산으로 반 단계까지 올라와 머문 뒤 닫힌다.

09탭 한 번의 펄스로 열리는 터치 밖 경로

드래그 판정 없이도 travel 의 도착 계산이 그대로 쓰이므로 버튼·키보드·드래그가 모두 같은 단계 계산에 도달한다. 탭 눌림과 펄스·상승·머묾·닫힘이 한 주기로 이어진다.

탭 한 번의 펄스로 열리는 터치 밖 경로
전체 코드 새 창에서 열기

09 · 탭 한 번의 펄스로 열리는 터치 밖 경로 — 측정 누적면적 37.403% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

pulsenoDragPathreuse
                const k = clamp((now - tabT09) / RISE_MS, 0, 1);
                putSheet(sh09, 196 * (1 - Math.pow(1 - k, 3)));
                setDim(bd09, 196 * (1 - Math.pow(1 - k, 3)), 1.0, 0.44);
                if (ring09) {
                    const pk = clamp((now - tabT09) / PULSE_MS, 0, 1);
                    ring09.style.opacity = pk < 1 ? f2(1 - pk) : '0';
                    ring09.style.transform = 'scale(' + f2(0.4 + pk * 1.6) + ')';
                }

이런 화면에 바텀 시트를 붙인다

bottom sheet html css js 로 검색해 들어온 사람이 결국 만드는 화면은 네 군데로 모인다. 지도·상세를 반 화면으로 들어 올리는 지도 앱 하단 패널(01·03), 필터·정렬을 닫지 않고 고르는 목록 도구(05·07), 항목을 고르면 바로 닫히는 간단 선택(06), 목록에서 밀어 지우는 관리 화면(08)이다. 넷 다 이 글의 판정 함수 위에 있고, 요구가 늘어날수록 속도 임계(02)와 축 잠금(08)을 한 겹씩 얹는 순서다.

실무 판단 하나를 적는다. 스냅 지점은 디자인 감이 아니라 콘텐츠 높이에서 정한다. 목록 5줄이 반 단계에 다 들어간다면 반과 전체의 구분이 무의미해지므로, 반 단계의 실높이를 목록 첫 줄 몇 개가 실제로 차는 px 로 계산한 뒤 그 값(이 데모의 196px 같은)을 스냅 배열에 넣는 편이 낫다. 백드랍 최대 알파(0.44)도 시트 뒤 내용이 읽을 수 있을 만큼만 올려야 한다 — 옵션 시트처럼 뒤가 완전히 가려져야 하는 경우에만 1에 가깝게 올린다.

어디서 깨지는가 — touch-action · 동점 규칙 · 속도 창 · pointercancel · 닫힘 왕복 · 안전 영역

만들면서 실제로 넘어진 여섯을 적는다 — 재현 방법과 수리까지.

첫째, 시트 전체에 touch-action: none 을 두면 내부 스크롤이 죽는다. 이 데모의 .ez__pad 는 pan-y 로 세로 팬을 브라우저에 남기고 드래그 판정만 JS 로 가져오고, .sh-head 만 none 으로 두어 머리 안에서는 스크롤을 끊는다 — 03의 containment 판정과 짝이다. 시트 전체를 none 으로 둔 순간 05의 목록 스크롤이 이벤트 도달 전에 브라우저에 삼켜진다. caniuse 에서 2026-11-17 에 직접 확인한 touch-action 지원은 전역 94.65%(partial 0.05% 포함)로 Chrome 36+ · Edge 12+ · Firefox 52+ · iOS Safari 13+ 이고 데스크톱 Safari는 미지원이라 그쪽은 preventDefault 폴백으로 간다.

둘째, 동점 규칙을 정하지 않으면 판정이 뒤집힌다(01 시연). 294px 놓기는 |294−196| = |294−392| = 98px 의 타이인데, < 로 비교하면 배열에서 먼저 검사한 반(196)이 유지되고 <= 로 쓰면 전체(392)가 이긴다. 어느 쪽이든 규칙은 한 번 적어 두어야 같은 제스처가 매번 같은 단계로 떨어진다.

셋째, 놓기 속도는 마지막 한 좌표의 차가 아니라 짧은 창의 차다(02 시연). 실입력 경로는 히스토리 마지막 4 포인트로 vMs 를 잰다 — 직전 1 프레임만 쓰면 렌더 지터로 0.5px/ms 임계가 오작동한다. 반대로 창을 너무 길게 잡으면 빠른 던짐이 평균에 묻혀 미달로 판정된다.

넷째, pointercancel 을 놓기 판정에서 빼면 시트가 어중간 높이로 얼어 붙는다. 손가락이 화면 밖으로 나가거나 시스템 제스처가 가로채면 pointerup 이 오지 않으므로, 이 데모의 01·02·03·05·08 전부 pointercancel 리스너를 둬 놓기와 같은 정리 경로를 태운다.

다섯째, 선택 즉시 닫힘에 최근접 왕복을 넣으면 한 동작이 두 동작으로 깨진다(06 시연). 목적지를 nearestSnap 에 맡기면 닫힘이 아니라 가까운 단계로 가버려 옵션 시트의 계약이 깨진다 — 닫힘은 판정 없이 travel 직행으로 보낸다.

여섯째, 하단 안전 영역을 무시하면 홈바에 핸들이 가려진다. 실서비스 시트는 padding-bottom: env(safe-area-inset-bottom) 이 필요하다. 이 데모는 데스크톱 렌더라 적용하지 않았고 실제 기기에서는 필수다. 시트 최대 높이를 dvh 로 두면 모바일 주소창 접힘에도 반 단계가 밀리지 않는다 — caniuse 2026-11-17 확인으로 dvh 는 전역 96.07% · Chrome 108+ · Safari 15.4+ 이고 그 아래는 vh 폴백을 둔다.

값을 바꿔 본 차이는 세 상수로 끝난다.

이름 바꾼 값 느낌
따라가는 비율 낮추기 01 DRAG_FOLLOW 1.0 → 0.55 이동량의 55% 만 반영해 시트가 손가락보다 반 박자 늦게 끌려온다 — 손끝에 붙어 다니는 종이에서 무게 있는 판으로 바뀐다
던짐 임계 올리기 02 FLING_MS 0.5 → 1.2 살짝 튕긴 정도로는 단계가 넘어가지 않아 손가락 위치를 존중하는 느슨한 시트가 되고, 낮추면 스치기만 해도 다음 단계로 넘어간다
백드랍 어둡기 가파르게 04 DIM_CURVE 1.0 → 1.8 h=148 의 알파는 0.17 에서 0.077 로 절반 이하로 내려간다 — 낮은 구간에서 조금만 올라도 급하게 어두워 시트가 주인공이 된다

아홉 장면 소스와 react 판을 묶은 zip 은 아래 상자에서 받는다 — 열 때의 암호는 njaks48e 이고, 스냅 판정·속도 창·보간·축 잠금이 라이브러리 없이 몇 줄인지 코드에서 바로 셈할 수 있다.

키보드만으로도 바텀 시트를 쓸 수 있나 — 탭 펄스 열기와 reduced-motion 접근성 경로

09가 답이다. 하단 탭은 role=button 의 aria-pressed 로 눌림을 알리고, click(Enter·Space 포함)이 드래그와 같은 travel 도착 계산을 탄다. 06의 옵션은 role=radio + aria-checked 로 선택을 알리고, 07의 칩은 role=button + aria-pressed · 적용 버튼은 aria-disabled 로 살아 있음을 알린다. 장면은 role=img 와 aria-label 에 핵심 문구를 담고, 상태 줄은 aria-live 를 꺼 두었다가 완료 문장만 role=status 로 바꿔 읽는다 — 매 프레임 높이 숫자를 읽으면 낭독이 혼잡해지기 때문이다.

움직임 줄이기에서는 스냅 이동이 즉시 전환으로 바뀐다. 각 장면은 prefers-reduced-motion 을 읽어 루프를 돌리지 않고 완료 상태 한 장(frame(1e9) 1회)을 그리고 단계는 문장으로 알린다. CSS 쪽은 .ez * { animation: none !important; transition: none !important } 로 시계·펄스를 끈다. caniuse 2026-11-17 확인으로 prefers-reduced-motion 은 Chrome 74+ · Firefox 63+ · Safari 10.1+, Pointer Events 는 전역 97.57% 로 사실상 전 브라우저다. 키보드 초점가둠(role=dialog · Tab 가두리 · Esc 닫기 · 열었던 자리로 초점 복귀)은 실서비스에 시트를 붙일 때 필요한 요령이고, 이 데모의 아홉 장면은 각 판정 계산의 시연이라 그 요령은 본문에서 구분해 적어 둔다.

여기까지 온 코드에 아래 두 줄이 기본이다.

@media (prefers-reduced-motion: reduce) {
  .sheet { transition: none; }
}

관련 글은 CSS 모달 팝업 애니메이션 · CSS 사이드바 드로어 슬라이드 · 모바일 터치 제스처 에 이어져 있다. 출처: MDN Pointer events · MDN touch-action · MDN dialog role · caniuse dvh

바텀 시트를 붙이기 전에 자주 묻는 것 — 모달과의 차이·내부 스크롤·홈바 안전 영역·던짐 감지

모달과 바텀시트 디자인은 뭐가 다른가요

모달은 가운데 떠서 주의를 빼앗고 닫을 때까지 다른 일을 막는다. 바텀 시트는 아래에서 올라와 단계에 머물러 뒤 내용과 함께 일한다 — 반 단계에서는 뒤 목록이 보이고, 닫힘 단계는 그냥 없는 것과 같다. 그래서 바텀 시트의 백드랍은 모달의 불투명한 가림막이 아니라 알파 보간(04)으로 단계에 비례한 어둡기를 쓴다.

목록이 최상단이 아닐 때 아래로 끌면 어떻게 되나요

목록이 스크롤된다. 05의 handover 판정은 scrollTop === 0 이고 아래로 끄는 경우에만 제스처를 시트에 넘기고, 그 밖에는 전부 본문 스크롤에 둔다. 판정을 첫 방향에서 한 번만 하므로 목록 끝에 닿은 뒤로도 같은 손놀림이 시트로 튀지 않는다.

아이폰 홈바에 핸들이 가려지면 어떻게 하나요

padding-bottom: env(safe-area-inset-bottom) 을 시트에 준다. 시트 최대 높이도 dvh 로 두면 주소창이 접힐 때 반 단계가 밀리지 않고, 15.4 미만 사파리는 vh 폴백으로 같은 자리에 둔다.

압축 비밀번호를 입력하세요

비밀번호는 이 글 본문 안에 있습니다. 읽다 보면 나옵니다.