Taster

진단부품톤 고르기
부품 갤러리 / Page toc

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.

내 사이트에서 가져오기

색을 고르면 아래 부품이 그 색으로 바뀝니다.

실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.

내 앱에 넣기

  1. 아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.

    git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine
  2. 내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이 src/components/taster 에 들어갑니다.

    node ../taster/packages/engine/cli.mjs add blocks/page-toc --from https://taster-six.vercel.app --dir src/components/taster
  3. 부품은 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)

정보

설치할 패키지
tailwindcss
라이선스
MIT
코드 보기
'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>
  )
}