GSAP · 09 기본 스크롤 연결
단계: 스크롤과 수명주기 · 편집 가능한 예제 · 저장 ID: gsap-step-09
목표와 학습 후 역량
- 학습 결과: 진행도의 역할을 설명한다. 입력 사례: 긴 문서와 짧은 문서.
- 산출물: 상단·중간·하단 진행도와 NaN 개수. 수동 연결 처리 근거를 코드와 연결해 설명한다.
선수 지식
8단위 「Context와 복원」의 Context 및 Revert 실습 결과를 준비한다.
핵심 개념과 설명
진행도
scrollTop을 유효 스크롤 길이로 나눈다. 길이가 0일 때는 별도 처리가 필요하다.
수동 연결
scroll 이벤트는 정지 timeline을 직접 제어할 수 있다. 이 경로는 ScrollTrigger 실행이 아니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 기존 gsap-01·02·03은 시작 예제다. 새 단위는 별도 로컬 GSAP 프로젝트에서 작성한다. gsap-02 미리보기는 기본 scroll 이벤트를 사용하며 ScrollTrigger는 외부 프로젝트에서 설치·등록한다. CSP와 iframe 격리는 유지한다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- 별도 실습 프로젝트의 src/day-9.js에 분모 검사 후 paused timeline.progress를 scroll 핸들러에서 갱신한다. 기존 1·14·28단위 예제는 출발점으로만 참고한다.
- 입력 조건: 긴 문서와 짧은 문서. 기준: 두 화면. 기준 조건에서 실행한 뒤 관찰값과 오류를 notes/day-9.md에 남긴다.
- 변경 변수: 문서 길이. 변경값: 반 화면. 같은 입력 경로로 다시 실행한다. 저장할 산출물: 상단·중간·하단 진행도와 NaN 개수. 확인할 가설: 스크롤이 없어도 진행도가 유효하다. 실제 결과와 비교해 일치 여부 및 차이의 원인을 기록한다.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 문서 길이 | 두 화면 | 반 화면 | 스크롤이 없어도 진행도가 유효하다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 필수 산출물: 상단·중간·하단 진행도와 NaN 개수. 기준 및 변경 조건 각각의 결과가 있어 총 2조건을 비교할 수 있고, 입력값과 실행 환경을 함께 기록했다.
- 두 조건의 차이에 관한 설명에 다음 개념을 모두 연결했다: 진행도, 수동 연결. 예상과 다른 항목은 원인 또는 미해결 이유를 1개 이상 적었다.
자가 점검
- 이번 실습에서 진행도 개념은 어느 처리 단계에 영향을 주는가? 입력 사례: 긴 문서와 짧은 문서.
- 변경 변수: 문서 길이. 확인할 가설: 스크롤이 없어도 진행도가 유효하다. 실제 결과가 가설과 일치했는가? 수동 연결 관점에서 근거를 설명하라.
공식 참고
연결된 예제와 실행 범위
Interactive 기본 스크롤 연결 experiment with resource cleanup.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: Context와 복원 · 다음: ScrollTrigger 등록