import { useEffect, useRef, useState, type ReactNode } from "react"; type HeadingItem = { id: string; label: string; }; type DocumentTocProps = { headings: ReadonlyArray; variant: "desktop" | "mobile"; /** * 데스크톱 레일의 아래 칸. 「이 글에서」와 「맥락」은 서로 다른 질문에 답한다 — 앞은 이 글의 * 어디인지, 뒤는 이 조사의 어디인지다. 한 레일에 두되 마디를 갈라 둔다. */ context?: ReactNode; }; export function DocumentToc({ headings, variant, context }: DocumentTocProps) { const [currentId, setCurrentId] = useState(headings[0]?.id ?? ""); const empty = headings.length === 0; const detailsRef = useRef(null); useEffect(() => { /* `IntersectionObserver` 가 없는 환경이 있다 — jsdom 이 그렇고, 오래된 브라우저도 그렇다. 없으면 "지금 읽는 절" 표시만 못 할 뿐 목차 자체는 쓸 수 있으므로, 없다고 문서를 통째로 못 그리게 두지 않는다. 한동안 이 컴포넌트는 픽스처 Case 하나에서만 쓰여 그 환경을 만난 적이 없었다. 모든 Case 가 목차를 받게 되면서 드러났다. */ if (typeof IntersectionObserver === "undefined") return undefined; const elements = headings .map((heading) => document.getElementById(heading.id)) .filter((element): element is HTMLElement => Boolean(element)); const observer = new IntersectionObserver( (entries) => { const visible = entries .filter((entry) => entry.isIntersecting) .sort( (left, right) => left.boundingClientRect.top - right.boundingClientRect.top, ); if (visible[0]) setCurrentId(visible[0].target.id); }, { rootMargin: "-12% 0px -72% 0px", threshold: [0, 1] }, ); elements.forEach((element) => observer.observe(element)); return () => observer.disconnect(); }, [headings]); function select(id: string) { setCurrentId(id); if (detailsRef.current) detailsRef.current.open = false; } /* 제목이 없는 문서에는 목차를 그리지 않는다. 예전에는 이 컴포넌트가 픽스처 문서 하나에서만 쓰여 빈 경우를 만날 일이 없었지만, 이제 모든 Case 가 지나므로 빈 레일이 남을 수 있다. */ if (empty && !(variant === "desktop" && context)) return null; if (variant === "mobile") { const current = headings.find((heading) => heading.id === currentId) ?? headings[0]; return (
목차 · {current?.label}
); } return ( /* 레일은 이제 둘을 담는다 — 이 글의 어디인지(「이 글에서」)와 이 조사의 어디인지(「맥락」). 서로 다른 질문에 답하므로 이름도 따로 준다. 레일 전체의 이름은 그 둘을 아우른다. */ ); }