Page toc
Tabs, segmented control and disclosure
Plain anchor links to the sections of a long page with one hairline rail; the section in view gets full ink and aria-current, never a colored bar.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.
git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이
src/components/taster에 들어갑니다.node ../taster/packages/engine/cli.mjs add blocks/page-toc --from https://taster-six.vercel.app --dir src/components/taster부품은 Tailwind 클래스로 그리고, Taster 프리셋이 그 클래스를 토큰에 연결합니다. Tailwind CSS 를 설치하고,
tokens.css를 앱 루트에서 한 번 불러온 뒤, 앱 루트에 이 설정을 둡니다. 프리셋이 없으면 빌드는 되어도 부품이 스타일 없이 나옵니다.// tailwind.config.cjs module.exports = { presets: [require('./src/components/taster/tailwind-preset.cjs')], content: ['./index.html', './src/**/*.{ts,tsx}'], };Tailwind v3 는 이 파일을 그대로 읽습니다. v4 는 Tailwind 를 불러오는
src/의 스타일시트 맨 위에 이 두 줄을 넣습니다.@import "tailwindcss"; @config "../tailwind.config.cjs";tokens.css는:root에--bg,--text,--border,--accent를 정의합니다. 내 앱의 스타일시트가 같은 이름을 뒤에서 다시 정의하면 그쪽 색이 이깁니다. 새 Vite 앱의 스타터 CSS 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- On this pagePlain anchor links to the sections of a long page with one hairline rail; the section in view gets full ink and aria-current, never a colored bar.
대신 없애 주는 AI 티
- Thick colored accent bar on one edge of a card (AC-10)
- All-caps label with wide letter spacing (AC-01)
정보
코드 보기
'use client'
import * as React from 'react'
import { cn } from './_cn'
// PageToc. "On this page" links for a long document or settings page. Plain anchor links (they work without
// script and keep the browser's own scroll and focus), plus a scroll spy that marks the section in view with
// aria-current="location", full ink and medium weight. One hairline rail on the left, no colored bar.
// Headings need ids that match the items. `offset` is the height of any sticky header above the content.
export interface TocItem {
id: string
label: string
/** 2 indents the item under the previous level 1 item. */
level?: 1 | 2
}
export interface PageTocProps extends React.HTMLAttributes<HTMLElement> {
items: TocItem[]
title?: string
/** Controlled active id. Leave undefined to let the scroll spy decide. */
activeId?: string
offset?: number
}
export function PageToc({ items, title = 'On this page', activeId, offset = 0, className, ...props }: PageTocProps) {
const [spy, setSpy] = React.useState<string | undefined>(items[0]?.id)
const current = activeId ?? spy
const headingId = React.useId()
React.useEffect(() => {
if (activeId !== undefined || typeof IntersectionObserver === 'undefined') return
const els = items.map((i) => document.getElementById(i.id)).filter((e): e is HTMLElement => Boolean(e))
if (!els.length) return
const visible = new Map<string, boolean>()
const io = new IntersectionObserver(
(entries) => {
for (const e of entries) visible.set(e.target.id, e.isIntersecting)
const first = items.find((i) => visible.get(i.id))
if (first) setSpy(first.id)
},
{ rootMargin: `-${offset}px 0px -55% 0px`, threshold: 0 },
)
els.forEach((el) => io.observe(el))
return () => io.disconnect()
}, [items, activeId, offset])
return (
<nav aria-labelledby={headingId} className={cn('min-w-0 text-sm', className)} {...props}>
<div id={headingId} className="mb-2 text-label font-medium text-text-subtle">
{title}
</div>
<ul className="flex flex-col border-l border-border">
{items.map((i) => {
const on = i.id === current
return (
<li key={i.id}>
<a
href={`#${i.id}`}
aria-current={on ? 'location' : undefined}
onClick={() => {
if (activeId === undefined) setSpy(i.id)
}}
className={cn(
'flex min-h-11 items-center rounded-sm py-1 pr-2 outline-none desk:min-h-8',
'transition-colors duration-press focus-visible:ring-2 focus-visible:ring-ring',
i.level === 2 ? 'pl-8' : 'pl-4',
on ? 'font-medium text-text' : 'text-text-muted hover:text-text',
)}
>
{i.label}
</a>
</li>
)
})}
</ul>
</nav>
)
}