Taster

진단부품톤 고르기
부품 갤러리 / Selectable table

Selectable table

Table and data grid

Sentence-case headers, right-aligned tabular figures, hairline row dividers, no zebra stripes or all-caps headers; header and footer stay fixed while the body scrolls.

내 사이트에서 가져오기

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

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

내 앱에 넣기

  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/selectable-table --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 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.

언제 쓰나요

  • Hairline data tableSentence-case headers, right-aligned tabular figures, hairline row dividers, no zebra stripes or all-caps headers; header and footer stay fixed while the body scrolls.
  • Sortable data gridClick-to-sort headers, column chooser, density option, sticky first column, pagination and row drilldown; state can live in the URL. Decision queues add a verdict, stage progress and a next action per row.

대신 없애 주는 AI 티

  • All-caps label with wide letter spacing (AC-01)
  • Monospace font for interface labels (AC-09)
  • Flat gray card with a hairline border, everywhere (AC-14)
  • Card inside a card (CMP-02)
  • Colored status dot (AC-08)

정보

설치할 패키지
tailwindcss
라이선스
MIT
코드 보기
'use client'

import * as React from 'react'
import { cn } from './_cn'

// SelectableTable. A data table with row selection and a toolbar: a slot on the left for search and filters,
// and once rows are selected, a count with bulk actions and Clear on the right. The header checkbox selects every
// row on the page and shows the mixed state. Selected rows get one surface step, nothing louder. Columns marked
// `hideBelow="sm"` drop out on phones so the table fits instead of scrolling sideways. Figures align right.

export interface SelectableColumn<T> {
  key: string
  header: string
  cell: (row: T) => React.ReactNode
  align?: 'left' | 'right'
  hideBelow?: 'sm' | 'md'
}

export interface SelectableTableProps<T> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
  rows: T[]
  columns: SelectableColumn<T>[]
  getRowId: (row: T) => string
  /** Short name of a row for its checkbox label, for example the file name. */
  getRowLabel: (row: T) => string
  selected: string[]
  onSelectedChange: (ids: string[]) => void
  caption: string
  toolbar?: React.ReactNode
  bulkActions?: (ids: string[]) => React.ReactNode
  emptyState?: React.ReactNode
  selectedLabel?: (n: number) => string
  clearLabel?: string
}

const HIDE = { sm: 'hidden sm:table-cell', md: 'hidden md:table-cell' }

function Check({
  checked,
  mixed,
  onChange,
  label,
}: {
  checked: boolean
  mixed?: boolean
  onChange: (on: boolean) => void
  label: string
}) {
  const ref = React.useRef<HTMLInputElement>(null)
  React.useEffect(() => {
    if (ref.current) ref.current.indeterminate = Boolean(mixed)
  }, [mixed])
  const on = checked || mixed
  return (
    <label className="-m-2 inline-flex size-11 cursor-pointer items-center justify-center desk:size-8">
      <input ref={ref} type="checkbox" checked={checked} onChange={(e) => onChange(e.target.checked)} aria-label={label} className="peer sr-only" />
      <span
        aria-hidden="true"
        className={cn(
          'flex size-4 items-center justify-center rounded-sm border transition-colors duration-press',
          'peer-focus-visible:ring-2 peer-focus-visible:ring-ring',
          on ? 'border-transparent bg-accent text-accent-fg' : 'border-border-input text-transparent',
        )}
      >
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={2.25} strokeLinecap="round" strokeLinejoin="round" className="size-3">
          {mixed ? <path d="M6 12h12" /> : <path d="M5 13l4 4 10-10" />}
        </svg>
      </span>
    </label>
  )
}

export function SelectableTable<T>({
  rows,
  columns,
  getRowId,
  getRowLabel,
  selected,
  onSelectedChange,
  caption,
  toolbar,
  bulkActions,
  emptyState,
  selectedLabel = (n) => `${n} selected`,
  clearLabel = 'Clear',
  className,
  ...props
}: SelectableTableProps<T>) {
  const ids = rows.map(getRowId)
  const chosen = ids.filter((id) => selected.includes(id))
  const all = ids.length > 0 && chosen.length === ids.length
  const some = chosen.length > 0 && !all

  return (
    <div className={cn('flex min-w-0 flex-col gap-3', className)} {...props}>
      {(toolbar || bulkActions) && (
        <div className="flex min-h-11 flex-wrap items-center justify-between gap-2">
          <div className="flex min-w-0 flex-1 basis-64 flex-wrap items-center gap-2">{toolbar}</div>
          {chosen.length > 0 && (
            <div className="flex flex-wrap items-center gap-2">
              <span className="text-sm tabular-nums text-text-muted">{selectedLabel(chosen.length)}</span>
              {bulkActions?.(chosen)}
              <button
                type="button"
                onClick={() => onSelectedChange(selected.filter((id) => !ids.includes(id)))}
                className={cn(
                  'inline-flex h-11 items-center rounded-md px-2 text-sm text-text-muted underline underline-offset-4 outline-none desk:h-9',
                  'transition-colors duration-press hover:text-text focus-visible:ring-2 focus-visible:ring-ring',
                )}
              >
                {clearLabel}
              </button>
            </div>
          )}
        </div>
      )}
      <span className="sr-only" role="status" aria-live="polite">
        {chosen.length ? selectedLabel(chosen.length) : ''}
      </span>
      <div className="min-w-0 border-y border-border">
        <table className="w-full border-collapse text-sm">
          <caption className="sr-only">{caption}</caption>
          <thead>
            <tr className="border-b border-border">
              <th scope="col" className="w-10 py-2 pl-3 pr-1 text-left">
                <Check
                  checked={all}
                  mixed={some}
                  onChange={() => onSelectedChange(all ? selected.filter((id) => !ids.includes(id)) : Array.from(new Set([...selected, ...ids])))}
                  label="Select all rows"
                />
              </th>
              {columns.map((c) => (
                <th
                  key={c.key}
                  scope="col"
                  className={cn(
                    'px-3 py-2 text-label font-medium text-text-muted',
                    c.align === 'right' ? 'text-right' : 'text-left',
                    c.hideBelow && HIDE[c.hideBelow],
                  )}
                >
                  {c.header}
                </th>
              ))}
            </tr>
          </thead>
          <tbody className="divide-y divide-border">
            {rows.length === 0 ? (
              <tr>
                <td colSpan={columns.length + 1} className="px-3 py-6 text-text-muted">
                  {emptyState ?? 'No rows'}
                </td>
              </tr>
            ) : (
              rows.map((r) => {
                const id = getRowId(r)
                const on = selected.includes(id)
                return (
                  <tr key={id} aria-selected={on} className={cn('transition-colors duration-press', on && 'bg-bg-elev')}>
                    <td className="py-1.5 pl-3 pr-1">
                      <Check
                        checked={on}
                        onChange={(v) => onSelectedChange(v ? [...selected, id] : selected.filter((x) => x !== id))}
                        label={`Select ${getRowLabel(r)}`}
                      />
                    </td>
                    {columns.map((c) => (
                      <td
                        key={c.key}
                        className={cn(
                          'px-3 py-2 text-text',
                          c.align === 'right' ? 'text-right tabular-nums' : 'text-left',
                          c.hideBelow && HIDE[c.hideBelow],
                        )}
                      >
                        {c.cell(r)}
                      </td>
                    ))}
                  </tr>
                )
              })
            )}
          </tbody>
        </table>
      </div>
    </div>
  )
}