feat(ui): 共享组件补齐——Card 面色分层 + Button link/lg + 4 原子件

- Card 新增 tone(panel/card/soft)/flat/interactive;cardClass 兼容旧字符串签名
- Button 新增 link(coral 文字链) 变体与 lg 尺寸
- 新增原子件 Eyebrow(统一眉题) / StatusDot(状态点·读屏可见) /
  Skeleton(motion-safe 占位) / Meter(进度条·progressbar)
- PageHeader/SectionHeader 用 display/title 字阶 + Eyebrow 眉题
This commit is contained in:
Yaojia Wang
2026-07-11 07:24:08 +02:00
parent fd6551b0ba
commit 83ba47ab8f
9 changed files with 206 additions and 13 deletions

View File

@@ -1,20 +1,29 @@
import type { HTMLAttributes, ReactNode } from "react";
import { cardClass } from "@/lib/ui/variants";
import { cardClass, type CardTone } from "@/lib/ui/variants";
interface CardProps extends HTMLAttributes<HTMLElement> {
children: ReactNode;
as?: "article" | "div" | "section";
tone?: CardTone;
flat?: boolean;
interactive?: boolean;
}
export function Card({
as: Component = "div",
children,
className,
tone,
flat,
interactive,
...props
}: CardProps) {
return (
<Component className={cardClass(className)} {...props}>
<Component
className={cardClass({ tone, flat, interactive, className })}
{...props}
>
{children}
</Component>
);

View File

@@ -0,0 +1,23 @@
import type { ReactNode } from "react";
import { cn } from "@/lib/ui/variants";
interface EyebrowProps {
children: ReactNode;
className?: string;
}
// 眉题/小标签无衬线、eyebrow 字号(含正字距 0.08em)、说明色、大写。
// 统一各页此前 mono/uppercase 互不一致的小标签写法。
export function Eyebrow({ children, className }: EyebrowProps) {
return (
<p
className={cn(
"font-sans text-eyebrow uppercase text-muted-soft",
className,
)}
>
{children}
</p>
);
}

View File

@@ -0,0 +1,45 @@
import { cn } from "@/lib/ui/variants";
export type MeterTone = "accent" | "success" | "warning" | "danger" | "info";
const meterTones: Record<MeterTone, string> = {
accent: "bg-cinnabar",
success: "bg-pass",
warning: "bg-overdue",
danger: "bg-conflict",
info: "bg-info",
};
interface MeterProps {
/** 0..1,超出范围自动夹取。 */
value: number;
tone?: MeterTone;
label?: string;
className?: string;
}
// 进度条:语义色填充,宽度过渡走动效 token对读屏暴露 progressbar。
export function Meter({ value, tone = "accent", label, className }: MeterProps) {
const pct = Math.max(0, Math.min(1, value)) * 100;
return (
<div
className={cn(
"h-1.5 w-full overflow-hidden rounded-full bg-line/60",
className,
)}
role="progressbar"
aria-valuenow={Math.round(pct)}
aria-valuemin={0}
aria-valuemax={100}
aria-label={label}
>
<div
className={cn(
"h-full rounded-full transition-[width] duration-base ease-standard",
meterTones[tone],
)}
style={{ width: `${pct}%` }}
/>
</div>
);
}

View File

@@ -1,5 +1,7 @@
import type { ReactNode } from "react";
import { Eyebrow } from "./Eyebrow";
interface PageHeaderProps {
title: string;
eyebrow?: string;
@@ -16,12 +18,8 @@ export function PageHeader({
return (
<header className="mb-6 flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between">
<div>
{eyebrow ? (
<p className="mb-1 font-mono text-xs uppercase tracking-wide text-ink-soft/70">
{eyebrow}
</p>
) : null}
<h1 className="font-serif text-2xl text-ink">{title}</h1>
{eyebrow ? <Eyebrow className="mb-1.5">{eyebrow}</Eyebrow> : null}
<h1 className="font-serif text-display-sm text-ink">{title}</h1>
{description ? (
<p className="mt-2 max-w-2xl text-sm leading-6 text-ink-soft">
{description}

View File

@@ -2,8 +2,11 @@ import type { ReactNode } from "react";
import { cn } from "@/lib/ui/variants";
import { Eyebrow } from "./Eyebrow";
interface SectionHeaderProps {
title: string;
eyebrow?: string;
description?: ReactNode;
action?: ReactNode;
className?: string;
@@ -11,6 +14,7 @@ interface SectionHeaderProps {
export function SectionHeader({
title,
eyebrow,
description,
action,
className,
@@ -18,7 +22,8 @@ export function SectionHeader({
return (
<div className={cn("flex items-start justify-between gap-4", className)}>
<div className="min-w-0">
<h2 className="font-serif text-base text-ink">{title}</h2>
{eyebrow ? <Eyebrow className="mb-1">{eyebrow}</Eyebrow> : null}
<h2 className="font-serif text-title-md text-ink">{title}</h2>
{description ? (
<p className="mt-1 text-sm leading-6 text-ink-soft">{description}</p>
) : null}

View File

@@ -0,0 +1,18 @@
import { cn } from "@/lib/ui/variants";
interface SkeletonProps {
className?: string;
}
// 加载占位:柔和线条底 + motion-safe 脉冲(尊重 prefers-reduced-motion
export function Skeleton({ className }: SkeletonProps) {
return (
<span
aria-hidden="true"
className={cn(
"block rounded-md bg-line/60 motion-safe:animate-pulse",
className,
)}
/>
);
}

View File

@@ -0,0 +1,41 @@
import { cn } from "@/lib/ui/variants";
export type StatusTone =
| "neutral"
| "accent"
| "success"
| "warning"
| "danger"
| "info";
const dotTones: Record<StatusTone, string> = {
neutral: "bg-ink-soft",
accent: "bg-cinnabar",
success: "bg-pass",
warning: "bg-overdue",
danger: "bg-conflict",
info: "bg-info",
};
interface StatusDotProps {
tone?: StatusTone;
/** 提供 label 时对读屏可见(不单靠颜色传达状态)。 */
label?: string;
className?: string;
}
// 状态点:语义色圆点,配合文案使用;有 label 时暴露给读屏。
export function StatusDot({ tone = "neutral", label, className }: StatusDotProps) {
return (
<span
className={cn(
"inline-block h-2 w-2 shrink-0 rounded-full",
dotTones[tone],
className,
)}
role={label ? "img" : undefined}
aria-label={label}
aria-hidden={label ? undefined : true}
/>
);
}