Empty state
Empty and error state
One line explaining why it is empty and one action, no big illustration or colored icon circle. In data views the axes, headers and labels stay and only the value cells show a dash.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 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/empty-state --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 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- Quiet empty stateOne line explaining why it is empty and one action, no big illustration or colored icon circle. In data views the axes, headers and labels stay and only the value cells show a dash.
- Error and locked stateA plain message for failure, missing permission or a locked feature with the reason, what to do and a retry or request button.
대신 없애 주는 AI 티
- Orange 'processing' pill with a glow (AC-07)
- Glyph inside a filled circle (AC-11)
- Empty value traces on screen (CPY-02)
- Machine codes on screen (CPY-03)
정보
코드 보기
import * as React from 'react'
import { cn } from './_cn'
// EmptyState. What stands in for missing content: nothing yet (first use), no results for a search or filter,
// a failure, or missing permission. One short heading, one sentence on why and what to do, one action and an
// optional second. No illustration, no icon in a colored circle, no exclamation marks. Left aligned by default so
// it reads like the rest of the screen; `centered` for a whole empty page.
// Errors and permission problems say the reason and a way forward (retry, request access), never just "Oops".
export type EmptyStateKind = 'first-use' | 'no-results' | 'error' | 'no-access'
export interface EmptyStateProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
kind?: EmptyStateKind
title: React.ReactNode
description?: React.ReactNode
action?: React.ReactNode
secondaryAction?: React.ReactNode
centered?: boolean
headingLevel?: 2 | 3 | 4
}
export const EmptyState = React.forwardRef<HTMLDivElement, EmptyStateProps>(
({ kind = 'first-use', title, description, action, secondaryAction, centered = false, headingLevel = 3, className, ...props }, ref) => {
const H = `h${headingLevel}` as 'h2' | 'h3' | 'h4'
return (
<div
ref={ref}
data-empty-kind={kind}
role={kind === 'error' ? 'alert' : undefined}
className={cn('flex flex-col gap-1 py-8', centered ? 'items-center text-center' : 'items-start', className)}
{...props}
>
<H className="text-title font-semibold text-text">{title}</H>
{description && <p className="max-w-prose text-sm text-text-muted">{description}</p>}
{(action || secondaryAction) && (
<div className={cn('mt-3 flex flex-wrap items-center gap-2', centered && 'justify-center')}>
{action}
{secondaryAction}
</div>
)}
</div>
)
},
)
EmptyState.displayName = 'EmptyState'