React Three Fiber · 11 이벤트 전파와 가림
단계: 3D 입력과 UI 상태 · 편집 가능한 예제 · 저장 ID: react-three-fiber-step-11
목표와 학습 후 역량
- 차단 모드에서 뒤 큐브가 선택되지 않는다.
- 허용·차단 각각의 이벤트 순서를 기록한다.
선수 지식
11단위는 10단위 결과물과 실험 기록을 이어 사용합니다.
핵심 개념과 설명
교차 전파
이벤트는 교차한 가까운 객체와 조상으로 전달되고 뒤 객체에도 갈 수 있습니다. DOM의 겹침 모델과 동일하다고 가정하지 않습니다.
전파 차단
stopPropagation은 뒤쪽 교차 객체로 전달되는 동작에도 영향을 줍니다. 선택을 하나로 제한할지 관통시킬지 요구에 맞게 정합니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 React Vite 프로젝트에서 JSX를 사용합니다. React와 @react-three/fiber의 호환 메이저 버전, Three.js 버전과 lockfile을 기록하세요. 이 과정은 WebGL 기반 안정 버전 API를 사용하며 alpha WebGPU API를 혼용하지 않습니다. 프레임 갱신은 useFrame과 ref로 처리합니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- src/OverlapScene.jsx에서 카메라 앞뒤로 겹친 큐브 두 개를 만드세요.
- 각 mesh와 부모 group의 클릭 로그를 기록하세요.
- 앞 큐브에 stopPropagation을 추가해 같은 위치 클릭 결과를 비교하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 전파 정책 | 허용 | 앞 객체에서 차단 | 뒤 객체와 조상 로그의 전달 범위가 달라진다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 차단 모드에서 뒤 큐브가 선택되지 않는다.
- 허용·차단 각각의 이벤트 순서를 기록한다.
자가 점검
- 투명 재질이면 이벤트도 자동으로 통과하나요?
- 부모 group의 핸들러가 받은 object와 eventObject는 어떻게 다른가요?
공식 참고
연결된 예제와 실행 범위
실제 React Three Fiber Canvas 실험입니다. WebGL을 지원하는 브라우저가 필요합니다.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: 포인터 교차와 선택 · 다음: 드래그와 포인터 캡처