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.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 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/notification-list --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 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- 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)
정보
코드 보기
'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>
)
}