Taster

진단부품톤 고르기
부품 갤러리 / Notification list

Notification list

Toast and alert

A neutral surface with a one pixel border; color appears only on a small title or icon slot, never a tinted full-width banner. Toasts carry one follow-up action, pause on hover and can offer undo.

내 사이트에서 가져오기

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

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

내 앱에 넣기

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

언제 쓰나요

  • Callout and toastA neutral surface with a one pixel border; color appears only on a small title or icon slot, never a tinted full-width banner. Toasts carry one follow-up action, pause on hover and can offer undo.

대신 없애 주는 AI 티

  • Tinted notice band (AC-06)
  • Thick colored accent bar on one edge of a card (AC-10)
  • Rainbow of tinted boxes (COL-06)

정보

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

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

// NotificationList. The body of a notification center: newest first, unread items in medium weight with a small
// neutral dot and the word "Unread" for screen readers, time on the right, "Mark all as read" in the header.
// Put it in a Popover or a Drawer; on its own it is a plain list. No colored icon per type, no badges on every row.

export interface NotificationItem {
  id: string
  title: string
  body?: string
  /** Display time, for example "5 min ago". */
  time: string
  /** Machine time for the <time> element. */
  datetime?: string
  unread?: boolean
}

export interface NotificationListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
  items: NotificationItem[]
  onSelect?: (id: string) => void
  onMarkAllRead?: () => void
  heading?: string
  markAllLabel?: string
  emptyLabel?: string
  unreadLabel?: string
}

export function NotificationList({
  items,
  onSelect,
  onMarkAllRead,
  heading = 'Notifications',
  markAllLabel = 'Mark all as read',
  emptyLabel = 'Nothing new. Updates about your work show up here.',
  unreadLabel = 'Unread',
  className,
  ...props
}: NotificationListProps) {
  const unread = items.filter((i) => i.unread).length
  const headingId = React.useId()
  return (
    <div className={cn('flex min-w-0 flex-col', className)} {...props}>
      <div className="flex min-h-11 items-center justify-between gap-3 border-b border-border pb-1">
        <div id={headingId} className="text-sm font-medium text-text">
          {heading}
          {unread > 0 && <span className="ml-1.5 tabular-nums text-text-subtle">{unread}</span>}
        </div>
        {onMarkAllRead && unread > 0 && (
          <button
            type="button"
            onClick={onMarkAllRead}
            className={cn(
              'inline-flex h-11 items-center rounded-md px-2 text-label text-text-muted outline-none desk:h-8',
              'transition-colors duration-press hover:text-text focus-visible:ring-2 focus-visible:ring-ring',
            )}
          >
            {markAllLabel}
          </button>
        )}
      </div>
      {items.length === 0 ? (
        <p className="py-6 text-sm text-text-muted">{emptyLabel}</p>
      ) : (
        <ul aria-labelledby={headingId} className="divide-y divide-border">
          {items.map((n) => {
            const content = (
              <>
                <span aria-hidden="true" className={cn('mt-2 size-1.5 shrink-0 rounded-full', n.unread ? 'bg-text' : 'bg-transparent')} />
                <span className="flex min-w-0 flex-1 flex-col gap-0.5">
                  <span className={cn('text-sm', n.unread ? 'font-medium text-text' : 'text-text-muted')}>
                    {n.unread && <span className="sr-only">{unreadLabel}: </span>}
                    {n.title}
                  </span>
                  {n.body && <span className="text-label text-text-muted">{n.body}</span>}
                </span>
                <time dateTime={n.datetime} className="shrink-0 pt-0.5 text-label tabular-nums text-text-subtle">
                  {n.time}
                </time>
              </>
            )
            const cls = 'flex w-full items-start gap-3 px-1 py-3 text-left'
            return (
              <li key={n.id}>
                {onSelect ? (
                  <button
                    type="button"
                    onClick={() => onSelect(n.id)}
                    className={cn(
                      cls,
                      'min-h-11 rounded-md outline-none transition-colors duration-press hover:bg-bg-elev focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring',
                    )}
                  >
                    {content}
                  </button>
                ) : (
                  <div className={cls}>{content}</div>
                )}
              </li>
            )
          })}
        </ul>
      )}
    </div>
  )
}