콘텐츠 내 탐색 In-page navigation
콘텐츠 내 탐색은 사용자가 본문의 구조를 훑어보고 원하는 콘텐츠로 빠르게 이동할 수 있도록 하는 탐색 수단이다. 화면을 스크롤 할 때 특정 위치에 고정되어 콘텐츠의 목차 역할을 하는 동시에 사용자가 페이지 내 탐색에서 특정 항목을 클릭하면 연결된 섹션으로 스크롤 된다.
기본
tsx
import { InPageNavigation } from '@krds.ui/react'
export default function InPageNavigationDemo() {
return (
<InPageNavigation
title="이 페이지의 구성"
items={[
{ href: '#overview', label: '개요' },
{ href: '#process', label: '처리 절차' }
]}
/>
)
}InPageNavigation
Props
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
title | string | - | 페이지 제목 |
items | NavigationItem[] | [] | 네비게이션 아이템 목록 |
caption | string | 이 페이지의 구성 | 페이지 구성 설명 텍스트 |
actionText | string | - | 액션 버튼 텍스트 |
onActionClick | (() => void) | - | 액션 버튼 클릭 핸들러 |
infoText | ReactNode | - | 추가 정보 텍스트 (HTML 태그 지원) |
scrollDown | boolean | false | 스크롤 시 상단 위치 조정 여부 |
scrollContainerRef | RefObject<HTMLElement | null> | - | 스크롤 컨테이너 참조 |