组件
站内所有基础原语、共享组件和通用图标都汇总在这里. 示例是活的, 可以直接点开, 复制导入路径后在新页面复用.
颜色与表面
颜色、间距和圆角全部来自 src/styles/tokens.css; 组件不写死主题色.
表面层级
sidebarbackgroundcardnestedpopover语义色
--color-accent--color-green--color-yellow--color-red--color-orange--color-blue--color-purple--color-cyan通用图标
统一使用 lucide-react, 不做手写 SVG 替代. 点击任意图标复制 import 语句.
按钮
变体、尺寸和图标统一走 Button; 危险操作使用 destructive 或 destructive-strong.
表单
Input 和 Label 组合使用; Command 提供搜索框, 列表和条目的完整键盘交互.
反馈
加载、空态、错误、临时消息和服务不可用都有统一出口.
正在加载...
暂无数据
加载失败
浮层
桌面使用居中 Dialog, 手机使用底部 Drawer; ResponsiveDialog 负责按断点切换.
不可逆操作使用 AlertDialog; 需要遮罩点击关闭的普通弹窗使用 Dialog 的默认 dismissible.
数据展示
图表按需加载; 统计卡片复用博客侧栏的 BlogStats.
正在加载图表...
全部组件
按基础原语、站点共享和功能模块分组; 点击路径右侧图标复制 import 路径.
基础原语 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 个文件; 依赖具体数据或路由的组件只列索引, 可交互示例集中在上方基础区.