React Three Fiber · 12 드래그와 포인터 캡처
단계: 3D 입력과 UI 상태 · 편집 가능한 예제 · 저장 ID: react-three-fiber-step-12
목표와 학습 후 역량
- 객체 밖에서 놓아도 dragging 상태가 false다.
- 드래그 중 매 이벤트 React setState를 사용하지 않는다.
선수 지식
12단위는 11단위 결과물과 실험 기록을 이어 사용합니다.
핵심 개념과 설명
포인터 캡처
캡처는 포인터가 객체 밖으로 움직여도 드래그를 이어 가는 데 사용합니다. R3F 캡처는 교차 목록 처리와 함께 동작하므로 DOM과 차이를 확인합니다.
좌표 평면
화면 이동량을 그대로 월드 위치에 더하면 카메라에 따라 속도가 달라집니다. 정한 평면과 ray의 교차로 이동 좌표를 구합니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 React Vite 프로젝트에서 JSX를 사용합니다. React와 @react-three/fiber의 호환 메이저 버전, Three.js 버전과 lockfile을 기록하세요. 이 과정은 WebGL 기반 안정 버전 API를 사용하며 alpha WebGPU API를 혼용하지 않습니다. 프레임 갱신은 useFrame과 ref로 처리합니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- src/DraggableBox.jsx에서 pointerdown에 pointerId를 캡처하세요.
- pointermove에서 ray와 z=0 평면의 교차를 ref 위치에 적용하세요.
- pointerup·취소에서 캡처를 해제하고 객체 밖 이동도 시험하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 캡처 | 없음 | 있음 | 객체 경계를 벗어나도 드래그 종료를 처리할 수 있다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 객체 밖에서 놓아도 dragging 상태가 false다.
- 드래그 중 매 이벤트 React setState를 사용하지 않는다.
자가 점검
- 드래그 평면을 카메라에 수직으로 두면 어떤 차이가 있나요?
- 캡처만으로 다른 객체 이벤트가 모두 차단되나요?
공식 참고
연결된 예제와 실행 범위
실제 React Three Fiber Canvas 실험입니다. WebGL을 지원하는 브라우저가 필요합니다.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: 이벤트 전파와 가림 · 다음: UI 상태와 프레임 목표