设计系统

组件

站内所有基础原语、共享组件和通用图标都汇总在这里. 示例是活的, 可以直接点开, 复制导入路径后在新页面复用.

61 个组件文件80 个通用图标Token 驱动可直接复用

颜色与表面

颜色、间距和圆角全部来自 src/styles/tokens.css; 组件不写死主题色.

基础

表面层级

侧栏基座sidebar
页面底色background
卡片card
内嵌块nested
浮层 / 悬停popover

语义色

强调--color-accent
成功--color-green
警告--color-yellow
危险--color-red
橙--color-orange
蓝--color-blue
紫--color-purple
青--color-cyan

通用图标

统一使用 lucide-react, 不做手写 SVG 替代. 点击任意图标复制 import 语句.

80 个
80 / 80

按钮

变体、尺寸和图标统一走 Button; 危险操作使用 destructive 或 destructive-strong.

7 变体 / 4 尺寸
变体
尺寸
图标

表单

Input 和 Label 组合使用; Command 提供搜索框, 列表和条目的完整键盘交互.

3 个
Input / Label
Command
Button
Dialog
Tabs

反馈

加载、空态、错误、临时消息和服务不可用都有统一出口.

5 个
StateBox

正在加载...

暂无数据

Toast / ServiceAlert
服务不可用数据源不可用时显示, 不拦截指针.
AlertDialog

浮层

桌面使用居中 Dialog, 手机使用底部 Drawer; ResponsiveDialog 负责按断点切换.

3 个

不可逆操作使用 AlertDialog; 需要遮罩点击关闭的普通弹窗使用 Dialog 的默认 dismissible.

数据展示

图表按需加载; 统计卡片复用博客侧栏的 BlogStats.

2 个
Chart

正在加载图表...

BlogStats

全部组件

按基础原语、站点共享和功能模块分组; 点击路径右侧图标复制 import 路径.

61 个文件

基础原语 12

  • ButtonButton, buttonVariants

    站点按钮; 7 个变体, 4 个尺寸, 支持 asChild 和图标.

    @/components/ui/button
  • InputInput

    单行输入框; 与 Label 搭配, 内置禁用态和占位符样式.

    @/components/ui/input
  • TextareaTextarea, FloatingTextarea

    多行文本输入框, 支持浮动标签.

    @/components/ui/textarea
  • DropdownMenuDropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem

    支持单选和多选的下拉菜单.

    @/components/ui/dropdown-menu
  • LabelLabel

    Radix 表单标签; 支持 peer 禁用态.

    @/components/ui/label
  • TabsTabs, TabList, Tab, TabPanel

    BoardUI 下划线标签页; 支持前导图标和计数徽章.

    @/components/base/tabs/tabs
  • DialogDialog, DialogTrigger, DialogPortal, DialogClose, DialogOverlay, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription

    Radix 居中对话框; dismissible 控制遮罩关闭, 统一模糊遮罩.

    @/components/ui/dialog
  • ResponsiveDialogDialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle

    桌面 Dialog, 手机底部 Drawer 的自适应封装.

    @/components/ui/responsive-dialog
  • DrawerDrawer, DrawerPortal, DrawerOverlay, DrawerSwipeHandle, DrawerTrigger, DrawerClose, DrawerContent, DrawerHeader, DrawerFooter, DrawerTitle, DrawerDescription

    Base UI 底部抽屉; 拖拽手柄, 下滑关闭, 内容区可滚动.

    @/components/ui/drawer
  • AlertDialogAlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel

    不可逆操作确认框; 无右上角关闭, 动作按钮复用 Button 变体.

    @/components/ui/alert-dialog
  • CommandCommand, CommandInput, CommandList, CommandEmpty, CommandLoading, CommandItem

    cmdk 命令面板原语; 博客搜索复用输入框, 列表和条目结构.

    @/components/ui/command
  • ChartChartContainer, ChartTooltip, ChartTooltipContent, useChart

    Recharts 图表容器与 Tooltip; 使用 ChartConfig 和 CSS 变量着色.

    @/components/ui/chart

站点共享 18

  • ShellShell

    站点骨架: 侧栏, 内容列, 目录抽屉, 移动 dock 和滚动条.

    @/components/Shell
  • SidebarSidebar

    全站导航, 账号, 后端状态, 通知, 主题和备案入口.

    @/components/Sidebar
  • BackendStatusBackendStatus

    后端健康状态圆点; 依赖 BackendStatusProvider.

    @/components/BackendStatus
  • GitHubIconGitHubIcon

    继承当前文字颜色的 GitHub 品牌标记.

    @/components/GitHubIcon
  • NotificationBellNotificationBell

    通知铃铛和站内公告浮层.

    @/components/NotificationBell
  • ToastProviderToastProvider, useToast

    Sonner 堆叠通知; 成功, 警告和错误三种色调.

    @/lib/toast-provider
  • ThemeToggleThemeToggle

    auto / light / dark 外观切换.

    @/components/ThemeToggle
  • BlogLayoutBlogLayout

    博客列表共享布局: 主列, 统计和最近更新.

    @/components/BlogLayout
  • BlogSubnavBlogSubnav

    近期发布, 分类, 标签和归档的页内导航.

    @/components/BlogSubnav
  • BlogSearchBlogSearch

    Pagefind 搜索面板, 键盘导航和结果列表.

    @/components/BlogSearch
  • BlogStatsBlogStats

    文章数, 字数, 分类, 标签, 运行时长和最后活动统计.

    @/components/BlogStats
  • PostCardPostCard

    文章卡片: 封面, 标题, 元信息, 置顶标记和摘要.

    @/components/PostCard
  • RecentUpdatesRecentUpdates

    博客侧栏的最近更新列表.

    @/components/RecentUpdates
  • PaginationPagination

    分页导航; 首末页窗口, 当前页和省略号.

    @/components/Pagination
  • TocRailTocRail

    文章目录; 配合滚动侦测高亮当前标题.

    @/components/TocRail
  • CommentHintCommentHint

    未开放评论区时的 QQ 群提示.

    @/components/CommentHint
  • ServiceAlertServiceAlert

    数据源不可用时的红色轻量胶囊; 不拦截指针.

    @/components/ServiceAlert
  • StateBoxStateBox

    加载, 空数据, 错误三态占位; 支持操作链接和重试.

    @/components/StateBox

二次元图集 2

  • AcgGalleryAcgGallery

    混合横竖屏 feed, 单源失败时保留可用图片并提示.

    @/features/acg/components/AcgGallery
  • AcgSkeletonAcgSkeleton

    图集加载骨架.

    @/features/acg/components/AcgSkeleton

账号与认证 6

  • SecurityPanelSecurityPanel

    密码, 身份验证器, 通行密钥和登录会话管理.

    @/features/auth/SecurityPanel
  • ThirdPartyPanelThirdPartyPanel

    GitHub / Gitee 第三方账号绑定卡片.

    @/features/auth/ThirdPartyPanel
  • OAuthProviderIconOAuthProviderIcon

    第三方登录品牌图标标记.

    @/features/auth/OAuthProviderIcon
  • AdminBasicSettingsPanelAdminBasicSettingsPanel

    管理后台基础设置和客户端 IP 来源选择.

    @/features/auth/AdminBasicSettingsPanel
  • AdminOAuthPanelAdminOAuthPanel

    管理后台第三方登录配置.

    @/features/auth/AdminOAuthPanel
  • AdminRegistrationRateLimitPanelAdminRegistrationRateLimitPanel

    注册速率限制开关与窗口配置.

    @/features/auth/AdminRegistrationRateLimitPanel

文件目录 4

  • ListBrowserListBrowser

    OpenList 文件浏览器: 目录, 搜索, 列表和画廊.

    @/features/list/components/ListBrowser
  • OpenWithDialogOpenWithDialog

    文件打开方式选择原生 dialog.

    @/features/list/components/OpenWithDialog
  • TextPreviewDialogTextPreviewDialog

    文本文件预览原生 dialog.

    @/features/list/components/TextPreviewDialog
  • ViewSwitchViewSwitch

    列表 / 画廊视图切换.

    @/features/list/components/ViewSwitch

探针 6

  • MeterMeter

    节点指标条.

    @/features/monitor/components/Meter
  • MonitorDashMonitorDash

    探针节点总览看板.

    @/features/monitor/components/MonitorDash
  • MonitorSkeletonMonitorSkeleton

    探针加载骨架.

    @/features/monitor/components/MonitorSkeleton
  • NodeCardNodeCard

    单个探针节点卡片.

    @/features/monitor/components/NodeCard
  • NodeDetailDialogNodeDetailDialog

    探针节点详情与历史图表弹窗.

    @/features/monitor/components/NodeDetailDialog
  • SummarySummary

    探针汇总统计.

    @/features/monitor/components/Summary

OAuth / OIDC 3

  • ApplicationFormApplicationForm

    OAuth2 / OIDC 应用创建和编辑表单.

    @/features/oauth/ApplicationForm
  • AuthorizationPanelAuthorizationPanel

    账号授权记录和应用管理面板.

    @/features/oauth/AuthorizationPanel
  • ClientSecretFieldClientSecretField

    客户端密钥展示和复制字段.

    @/features/oauth/ClientSecretField

原理图 2

  • SchematicPreviewSchematicPreview

    Minecraft 原理图, 基岩版 .mcworld 与建筑 JSON 3D 预览.

    @/features/schematic/components/SchematicPreview
  • CommandListDialogCommandListDialog

    原理图命令列表 dialog.

    @/features/schematic/components/CommandListDialog

多接口在线翻译 3

  • TranslateToolTranslateTool

    多服务并行翻译与语种选择.

    @/features/tools/TranslateTool
  • TranslationCardTranslationCard

    单个服务的译文与操作.

    @/features/tools/TranslationCard
  • TranslateSettingsDialogTranslateSettingsDialog

    配置自定义翻译接口.

    @/features/tools/TranslateSettings

服务状态 4

  • StatusBoardStatusBoard

    Kuma 服务状态看板.

    @/features/status/components/StatusBoard
  • StatusSkeletonStatusSkeleton

    状态页加载骨架.

    @/features/status/components/StatusSkeleton
  • LatencyChartLatencyChart

    状态页延迟图表.

    @/features/status/components/LatencyChart
  • UptimeBarsUptimeBars

    服务可用率条.

    @/features/status/components/UptimeBars

工具 1

  • SchematicToolSchematicTool

    原理图, .mcworld 与建筑 JSON 工具页: 拖放, 解析和预览状态.

    @/features/tools/SchematicTool

功能组件共 31 个文件; 依赖具体数据或路由的组件只列索引, 可交互示例集中在上方基础区.