组件Feedback
Skeleton
@mox-hub/ui 组件 · Feedback · canonical
skeleton@mox-hub/uiFeedbackcanonicalsrc/components/skeleton.tsx变体演示skeleton
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| className* | string | — | — |
源码
import { cn } from "../lib/utils"
/* ============================================
Base Skeleton
============================================ */
function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="skeleton"
aria-hidden="true"
className={cn("animate-pulse rounded-md bg-muted", className)}
{...props}
/>
)
}
/* ============================================
Skeleton Text — 单行或多行文本骨架
============================================ */
interface SkeletonTextProps {
lines?: number
className?: string
lastLineWidth?: string
}
function SkeletonText({ lines = 3, className, lastLineWidth = "w-3/4" }: SkeletonTextProps) {
return (
<div data-slot="skeleton-text" className={cn("space-y-2", className)}>
{Array.from({ length: lines }).map((_, i) => (
<Skeleton
key={i}
className={cn("h-3.5", i === lines - 1 ? lastLineWidth : "w-full")}
/>
))}
</div>
)
}
/* ============================================
Skeleton Card — 卡片形骨架
============================================ */
interface SkeletonCardProps {
avatar?: boolean
title?: boolean
description?: boolean
lines?: number
className?: string
}
function SkeletonCard({
avatar,
title = true,
description = true,
lines = 2,
className,
}: SkeletonCardProps) {
return (
<div
data-slot="skeleton-card"
className={cn(
"rounded-xl bg-card p-4 space-y-3 ring-1 ring-border/50 shadow-xs",
className
)}
>
<div className="flex items-center gap-3">
{avatar && (
<Skeleton className="size-10 rounded-full shrink-0" />
)}
<div className="flex-1 space-y-2">
{title && (
<Skeleton
className="h-4 w-1/3"
/>
)}
{description && (
<Skeleton className="h-3 w-1/2" />
)}
</div>
</div>
<div className="space-y-1.5 pt-1">
{Array.from({ length: lines }).map((_, i) => (
<Skeleton
key={i}
className={cn(
"h-3",
i === lines - 1 ? "w-2/3" : "w-full"
)}
/>
))}
</div>
</div>
)
}
/* ============================================
Skeleton Avatar — 圆形头像骨架
============================================ */
interface SkeletonAvatarProps {
size?: "sm" | "md" | "lg"
className?: string
}
const avatarSizeMap = {
sm: "size-8",
md: "size-10",
lg: "size-12",
}
function SkeletonAvatar({ size = "md", className }: SkeletonAvatarProps) {
return (
<Skeleton
className={cn(avatarSizeMap[size], "rounded-full shrink-0", className)}
/>
)
}
/* ============================================
Skeleton List — 列表骨架
============================================ */
interface SkeletonListProps {
count?: number
avatar?: boolean
lines?: number
className?: string
}
function SkeletonList({
count = 5,
avatar = false,
lines = 2,
className,
}: SkeletonListProps) {
return (
<div data-slot="skeleton-list" className={cn("space-y-3", className)}>
{Array.from({ length: count }).map((_, i) => (
<div key={i} className="flex items-center gap-3">
{avatar && <SkeletonAvatar />}
<div className="flex-1">
<SkeletonCard avatar={false} title lines={lines} />
</div>
</div>
))}
</div>
)
}
/* ============================================
Skeleton Table — 表格骨架
============================================ */
interface SkeletonTableProps {
rows?: number
columns?: number
className?: string
}
function SkeletonTable({ rows = 5, columns = 4, className }: SkeletonTableProps) {
return (
<div data-slot="skeleton-table" className={cn("space-y-3", className)}>
{/* Header */}
<div className="flex gap-3 px-1">
{Array.from({ length: columns }).map((_, i) => (
<Skeleton key={i} className="h-4 flex-1" />
))}
</div>
{/* Rows */}
{Array.from({ length: rows }).map((_, i) => (
<div key={i} className="flex gap-3 items-center p-3 rounded-lg border border-border">
{Array.from({ length: columns }).map((_, j) => (
<Skeleton key={j} className="h-4 flex-1" />
))}
</div>
))}
</div>
)
}
/* ============================================
Skeleton Chart — 图表骨架
============================================ */
interface SkeletonChartProps {
className?: string
}
function SkeletonChart({ className }: SkeletonChartProps) {
return (
<div data-slot="skeleton-chart" className={cn("space-y-3", className)}>
<div className="flex items-end gap-2 h-32">
{[65, 80, 45, 90, 60, 75, 55].map((h, i) => (
<Skeleton
key={i}
className="flex-1"
style={{ height: `${h}%` }}
/>
))}
</div>
<div className="flex gap-2 justify-around">
{Array.from({ length: 7 }).map((_, i) => (
<Skeleton key={i} className="h-3 w-4" />
))}
</div>
</div>
)
}
export {
Skeleton,
SkeletonText,
SkeletonCard,
SkeletonAvatar,
SkeletonList,
SkeletonTable,
SkeletonChart,
}
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
骨架屏占位,按真实布局给宽高;避免与 spinner 同时使用。