/* ============================================================================= * B05_Profile_UI_Profile_Wheel.ts * 세로 휠 → 가로 이동. 종단 그래프·유토곡선·측점 테이블 세 스크롤러가 같은 문법을 쓴다 * (2026-08-04 사용자 지시). 셋에 똑같이 복사돼 있던 것을 한 벌로 모았다(2026-09-04). * * **부드럽게 이동**(2026-09-04 사용자 지시) — 예전처럼 `scrollLeft`에 곧바로 더하면 휠 * 한 칸(120px)이 통째로 점프해 툭툭 끊긴다. * * 브라우저 기본 `scrollTo({ behavior: "smooth" })`는 쓰지 않는다. 휠을 굴리는 동안 매번 * 애니메이션이 **처음부터 다시 시작**돼 느린 구간만 반복하기 때문이다 — 실측으로 1.6초 * 동안 1,200px 중 17px 만 움직였다(2026-09-04). 대신 목표만 쌓아 두고 프레임마다 남은 * 거리의 일정 비율씩 좁힌다. 목표가 늘어나도 속도가 이어지므로 굴릴수록 뒤처지지 않는다. * * Shift+휠은 브라우저 기본 가로 스크롤이라 건드리지 않는다. * * **끌어서 이동**(2026-09-06 사용자 지시) — 스크롤바를 잡지 않고 그림 위에서 바로 끌어 * 옮긴다. 좌클릭·휠 버튼 둘 다 되며, 여기 한 곳만 고치면 이것을 쓰는 세 곳(종단 그래프· * 유토곡선·측점 테이블)이 함께 얻는다. * ========================================================================== */ /** 프레임마다 남은 거리에서 좁히는 비율. 0.35면 60fps에서 약 0.13초에 도착한다 — * 눈으로는 이어져 보이면서, 멈춘 뒤 세로 눈금이 따라오는 시간도 예전만큼 짧다. */ const EASE = 0.35; /** 이보다 가까우면 도착으로 보고 딱 맞춘다(px). */ const SNAP_PX = 0.5; /** 이만큼 넘게 움직여야 "끌기"로 본다(px). 그 아래는 클릭(측점 선택)으로 흘려보낸다. */ /** 이만큼 움직여야 「끌기」로 본다 — 그 아래는 클릭이다. * 4px 은 손 떨림에도 넘어가 측점을 고르기 어려웠다(2026-09-06 사용자 지적). */ const DRAG_THRESHOLD_PX = 6; /** 끌기를 시작하면 안 되는 조작 부품 — 이 위에서 누른 것은 그 부품의 몫이다. * 구조물 마크는 자기 `pointerdown`에서 전파를 끊으므로 여기 적지 않아도 된다. */ const DRAG_BLOCK_SELECTOR = "button, input, select, textarea, a, .ui-resizer, .b05-profile-edit__btn"; /** EASE의 기준 프레임 간격(ms) — 60Hz 한 칸. */ const BASE_FRAME_MS = 1000 / 60; /** 한 프레임으로 인정하는 최대 간격(ms). 탭이 잠들었다 깨면 간격이 수백 ms라 그대로 * 쓰면 한 번에 목표까지 튄다. */ const MAX_FRAME_MS = 64; export function attachWheelHorizontalScroll(scroller: HTMLElement): void { let target = -1; /** 우리가 마지막으로 써 넣은 값 — 남이 자리를 옮겼는지 가리는 데 쓴다. */ let applied = -1; let frame = 0; /** 직전 프레임 시각 — 좁히는 양을 **흐른 시간**에 맞추는 데 쓴다. */ let lastFrameAt = 0; function stop(): void { if (frame) cancelAnimationFrame(frame); frame = 0; target = -1; applied = -1; lastFrameAt = 0; } function step(now: number): void { frame = 0; // 스크롤바 끌기·스크롤 동기화처럼 다른 경로가 자리를 옮겼으면 이동을 접는다. if (applied >= 0 && Math.abs(scroller.scrollLeft - applied) > 1) return stop(); const limit = scroller.scrollWidth - scroller.clientWidth; const goal = Math.min(limit, Math.max(0, target)); const rest = goal - scroller.scrollLeft; if (Math.abs(rest) <= SNAP_PX) { scroller.scrollLeft = goal; return stop(); } // 프레임당 고정 비율로 좁히면 화면 주사율에 따라 속도가 달라진다 — 120Hz에서는 두 배 // 빨라 툭 끊겨 보이고, 프레임을 한 번 놓치면 그만큼 덜컥 뛴다. 흐른 시간으로 환산해 // **어느 화면에서나 같은 시간**에 도착하게 한다(2026-09-04). const elapsed = lastFrameAt ? Math.min(MAX_FRAME_MS, now - lastFrameAt) : BASE_FRAME_MS; lastFrameAt = now; const ratio = 1 - Math.pow(1 - EASE, elapsed / BASE_FRAME_MS); scroller.scrollLeft = scroller.scrollLeft + rest * ratio; applied = scroller.scrollLeft; frame = requestAnimationFrame(step); } scroller.addEventListener( "wheel", (event) => { if (event.shiftKey || event.deltaY === 0) return; const limit = scroller.scrollWidth - scroller.clientWidth; if (limit <= 0) return; // 이동 중이면 **직전 목표**에 이어 더한다 — 현재 위치에 더하면 아직 못 간 거리를 // 잃어 굴릴수록 뒤처진다. const from = frame ? target : scroller.scrollLeft; const next = Math.min(limit, Math.max(0, from + event.deltaY)); if (next === from && (next <= 0 || next >= limit)) return; target = next; if (!frame) { applied = scroller.scrollLeft; frame = requestAnimationFrame(step); } event.preventDefault(); }, { passive: false }, ); /* ── 끌어서 이동 ───────────────────────────────────────────────────────── * 좌클릭(0)·휠 버튼(1)으로 잡아 끈다. 문턱을 넘긴 뒤에야 이동으로 보고, 넘긴 경우에만 * 뒤따르는 click을 한 번 삼킨다 — 그래야 "그림을 조금 움직였는데 측점 선택이 풀리는" * 일이 없다. * * ⚠ 포인터 잡기(`setPointerCapture`)는 **문턱을 넘긴 뒤에만** 한다(2026-09-06). * 누르는 즉시 잡으면 뒤따르는 click 의 대상이 측점 `` 가 아니라 스크롤러가 되어, * 측점 클릭이 배경 클릭으로 처리되고 선택이 그 자리에서 풀렸다 — 「측점을 골라도 * 하이라이트가 안 된다」는 증상의 원인. 끌기가 실제로 시작된 뒤에는 잡아 두어야 * 창 밖에서 손을 떼도 이동이 풀리지 않는다. */ let dragId: number | null = null; let dragX = 0; let dragY = 0; let dragLeft = 0; let dragTop = 0; let dragMoved = false; function endDrag(): void { if (dragId === null) return; if (scroller.hasPointerCapture(dragId)) scroller.releasePointerCapture(dragId); dragId = null; scroller.style.cursor = ""; scroller.style.userSelect = ""; // 끈 뒤의 click 한 번만 삼킨다(캡처 단계라 아래 리스너보다 먼저 잡는다). if (dragMoved) { const swallow = (event: MouseEvent): void => { event.stopPropagation(); event.preventDefault(); }; scroller.addEventListener("click", swallow, { capture: true, once: true }); // 클릭이 안 오는 경우(휠 버튼 등)를 대비해 다음 프레임에 걷어낸다. requestAnimationFrame(() => scroller.removeEventListener("click", swallow, { capture: true }), ); } dragMoved = false; } scroller.addEventListener("pointerdown", (event) => { if (dragId !== null || (event.button !== 0 && event.button !== 1)) return; if ((event.target as HTMLElement | null)?.closest(DRAG_BLOCK_SELECTOR)) return; // 끌기가 시작되면 휠 관성 이동은 접는다 — 둘이 같은 scrollLeft를 다투면 튄다. stop(); dragId = event.pointerId; dragX = event.clientX; dragY = event.clientY; dragLeft = scroller.scrollLeft; dragTop = scroller.scrollTop; dragMoved = false; // 여기서는 포인터를 잡지 않는다 — 위 주석 참고(클릭이 측점에 닿아야 한다). // 휠 버튼은 브라우저 자동 스크롤이 뜨므로 막는다. if (event.button === 1) event.preventDefault(); }); scroller.addEventListener("pointermove", (event) => { if (dragId !== event.pointerId) return; const dx = event.clientX - dragX; const dy = event.clientY - dragY; if (!dragMoved && Math.abs(dx) < DRAG_THRESHOLD_PX && Math.abs(dy) < DRAG_THRESHOLD_PX) return; if (!dragMoved) { dragMoved = true; scroller.style.cursor = "grabbing"; // 이제부터 진짜 끌기다 — 창 밖으로 나가도 이어지도록 포인터를 잡는다. scroller.setPointerCapture(event.pointerId); // 끄는 동안 글자가 파랗게 잡히지 않게 한다. 포인터 잡기를 미룬 뒤로 브라우저가 // 기본 글자 선택을 시작했다(2026-09-06 사용자 지적). 이미 잡힌 것도 푼다. scroller.style.userSelect = "none"; window.getSelection()?.removeAllRanges(); } scroller.scrollLeft = dragLeft - dx; scroller.scrollTop = dragTop - dy; event.preventDefault(); }); scroller.addEventListener("pointerup", endDrag); scroller.addEventListener("pointercancel", endDrag); // 잡아 둔 포인터를 잃으면(창 전환 등) 끌기도 함께 끝낸다. scroller.addEventListener("lostpointercapture", endDrag); }