IntersectionObserver로 스크롤 목차를 만들 때, 콜백의 마지막 항목이 지금 읽는 절이라는 보장은 없다. 이 API는 요소의 교차 상태 변화를 알려 준다. 목차에서 어느 절을 현재 위치로 표시할지는 따로 정해야 한다. 고정 헤더 아래에 읽기 기준선을 두고 그 선을 지난 마지막 제목을 고르는 방법을 검토해 보자.
현재 절을 고르는 규칙부터 정하기
아래는 구현 결과가 아닌 설계 예다. 본문은 위에서 아래로 읽고 제목도 그 순서로 배치돼 있다고 가정한다. 고정 헤더에 가리지 않는 위치에 기준선을 둔다. 문서 순서대로 제목을 살펴보며 그 선에 닿았거나 선보다 위로 올라간 제목 중 마지막 것을 현재 절로 선택한다. 아직 아무 제목도 선을 지나지 않았다면 첫 절을 표시하는 정책으로 정한다.
| 가정한 화면 상태 | 기준선 규칙의 선택 | 알림만으로 정해지지 않는 것 |
|---|---|---|
| A절 제목은 기준선 위, B절 제목은 기준선 아래에 있다. | A절 | B절이 화면에 들어왔다는 사실만으로 현재 절을 B로 바꿀지 |
| B절 제목이 기준선에 닿았다. | B절 | 화면 진입과 읽기 위치 전환을 같은 시점으로 볼지 |
| 위로 돌아가 B절 제목이 기준선 아래로 내려왔다. A절 제목은 위에 있다. | A절 | 마지막으로 받은 항목 대신 현재 배치에서 무엇을 고를지 |
여기서는 화면에 조금 보이는 다음 절보다 기준선을 지난 절을 우선한다. 화면 중앙에 가장 가까운 제목을 고르거나 가장 넓게 보이는 절을 고르는 방식도 가능하다. 어느 규칙이든 ‘현재 절’의 의미가 달라진다. 먼저 원하는 표시를 정해야 콜백이 돌아왔다는 사실과 목차가 맞게 골랐다는 사실을 나눠 확인할 수 있다.
알림의 시간순과 제목의 문서 순서
MDN에 따르면 콜백은 임계값을 넘은 사건마다 항목을 받으며, 여러 대상의 항목이 한꺼번에 올 수 있다. 같은 대상이 짧은 시간에 여러 임계값을 넘은 항목도 함께 받을 수 있다. 항목은 발생 시간에 따라 큐로 전달되고, 정확히 시간순으로 다루려면 IntersectionObserverEntry.time을 쓰는 편이 좋다고 설명한다.[1] 여기서 순서는 사건의 시간순이다. 문서에서 제목이 놓인 순서나 독자가 읽는 순서와 같은 뜻은 아니다.
time으로 항목을 정렬해도 읽기 규칙은 생기지 않는다. 가장 최근에 교차 상태가 바뀐 요소를 알 수 있을 뿐이다. MDN은 각 항목이 특정 순간의 정보를 담으며 스크롤 방향처럼 시간에 걸친 정보가 필요하면 이전 항목을 보관해 직접 계산할 수 있다고 설명한다.[1] 또한 모든 미세한 위치 변화를 알리는 대신 설정한 임계값을 넘을 때 통지한다. 기준선으로 현재 절을 고르고 싶다면 제목이 그 선을 지나는 변화를 필요한 때 감지하는지도 별도로 확인해야 한다.
예를 들어 ‘화면에 보이는 제목만 후보로 둔다’고 바꾸면 긴 절을 읽는 동안 제목이 화면 밖으로 사라졌을 때의 정책이 필요해진다. 위 기준선 방식은 그 절의 제목이 이미 위로 지나갔어도 다음 제목이 선에 닿기 전까지 현재 절로 남긴다. 이는 IntersectionObserver가 자동으로 보장하는 동작이 아니라 이 글에서 택한 선택 규칙이다.
강조 표시와 링크 동작을 나눠 확인하기
현재 절을 정했다면 목차의 시각적 강조와 aria-current="location"이 같은 링크를 가리키도록 맞출 수 있다. MDN은 관련 요소 집합 안에서 현재 항목 하나만 aria-current로 표시하라고 설명한다.[2] 데스크톱 목차와 모바일 목차가 독립된 집합이라면 각 목차 안에서 하나씩 확인한다. 문서 전체에서 무조건 하나만 남기라는 뜻으로 확대하지 않는다.
목차 링크는 해당 제목을 가리키는 보통의 href="#..." 링크로 두고, 스크롤에 따라 강조를 갱신하는 일과 링크를 눌러 이동하는 일을 나눠 검토하는 편이 좋다. 강조를 바꾸기 위해 매번 URL을 덮어쓰는 설계를 택한다면 뒤로 가기와 기존 앵커 주소가 어떻게 달라지는지도 확인할 항목이 된다. 색이 맞게 바뀌는 장면 하나로 탐색 동작까지 통과시키지 않는다.
검증 장면은 선택한 규칙에서 나온다. 아래로 읽기와 위로 돌아가기, 앵커로 중간 절 열기, 마지막 절이 짧아 제목이 기준선까지 올라오지 못하는 경우를 살펴볼 수 있다. 마지막 경우는 본문 끝에 도착하면 마지막 절을 표시할지 별도 정책이 필요하다. 고정 헤더 높이가 달라지거나 이미지가 늦게 나타나 제목 위치가 바뀌는 상황도 확인 대상이다.
이 글은 공개 문서를 근거로 한 목차 설계 해설이다. 특정 사이트의 오류를 재현하거나 수정 효과를 측정한 결과는 아니다. 구현을 검토할 때 먼저 적어 볼 것은 ‘어떤 콜백을 쓸까’보다 ‘이 화면에서는 어느 절이 선택돼야 할까’다. 위 표의 기대 선택을 실제 화면과 대조하면 알림 수신과 읽기 위치 판정을 따로 점검할 수 있다.