Tuffex 组件
塔芙组件库的组件展示中心
Tuffex 组件
组件文档已迁移到统一结构:
TuffDemoWrapper + 独立 Demo 组件。
组件预览
示例即将加载...
组合工作台 Demo
这一组 Demo 用真实后台片段校验组件组合:搜索输入、开关、按钮、状态徽标、进度条与可选择表格会在同一个响应式面板里协同工作。
发布工作台
适合作为 Dashboard / Admin 页面组合组件的基础形态。
示例即将加载...
后台趋势图
复用 DashboardSparklineChart 封装,替代页面内手写 SVG sparkline。
示例即将加载...
运营状态面板
将 StatCard、StatusBadge、ProgressBar 与 Switch 组合成后台首屏状态区。
示例即将加载...
后台恢复状态
将 LoadingState、EmptyState、ErrorState 放进同一个数据容器,覆盖加载/无数据/失败路径。
示例即将加载...
后台任务反馈中心
将 Toast、Tooltip、LoadingOverlay 与 Spinner 组合成后台任务反馈路径。
示例即将加载...
后台筛选工具栏
将 SearchInput、SearchSelect、SearchEmpty 组合成列表筛选与空结果恢复路径。
示例即将加载...
数据运维面板
将 DataTable、Pagination、Skeleton 与 LayoutSkeleton 组合成后台数据区。
示例即将加载...
权限编排面板
将 Tree、TreeSelect、Transfer 与 Timeline 组合成后台授权工作流。
示例即将加载...
发布策略配置
将 Cascader、FlatSelect、SegmentedSlider、Slider 与 TagInput 组合成后台发布配置流。
示例即将加载...
后台导航配置壳层
将 Tabs、DropdownMenu、Popover 与 Drawer 组合成后台设置页骨架。
示例即将加载...
教程路径
- 新手先读《Tuffex 组合界面教程》,掌握“操作区 → 状态区 → 数据区”的页面切法。
- 后台首屏建议从“运营状态面板”模式开始,再按需向下展开表格、趋势图、导航配置和详情抽屉。
- 列表页优先把关键词、范围筛选和无结果恢复设计成同一条路径,复用
TxSearchInput、TxSearchSelect、TxSearchEmpty。 - 数据列表建议使用
TxDataTable承担主体、TxPagination承担页码、TxSkeleton/TxLayoutSkeleton承担等待态。 - 设置页与后台壳层建议使用
TxTabs固定分区,TxDropdownMenu/TxPopover放轻操作与短说明,TxDrawer承载高密度配置。 - 数据区必须同时设计加载、空态和错误恢复路径,优先复用
TxLoadingState、TxEmptyState、TxErrorState。 - 任务反馈路径建议使用
TxToastHost挂载通知、TxTooltip解释动作、TxLoadingOverlay阻断局部刷新、TxSpinner表达行内等待。 - 权限编排路径建议用
TxTree选择权限域、TxTreeSelect选择归属团队、TxTransfer分配资源、TxTimeline展示审计进度。 - 发布配置路径建议用
TxCascader选择发布范围、TxFlatSelect选择包格式与发布模式、TxSegmentedSlider表达风险档位、TxSlider调整灰度比例、TxTagInput记录短标签。 - 组件细节按下方分组查阅;侧边栏仅突出仍需关注的迁移状态,已审阅页面只在状态看板中显示
已确认。 - 后台页优先使用
TxDataTable、TxStatusBadge、TxProgressBar与图表组件组合,避免手写一次性 SVG 或重复状态 UI。
迁移状态看板
开发中:文档仍在完善,示例/API 可能继续调整。AI 迁移:已完成迁移,但仍建议结合源码核对。已审阅:人工审阅完成。
章节总览
| 章节 | 核心范围 | 当前状态 |
|---|---|---|
| 设计模式 | Surface / Motion / 组合样式 | ✅ migrated |
| 设计案例 | 实战页面与复合范式 | ✅ migrated |
| 暗黑模式与主题 | Token、深浅色与主题约束 | ✅ migrated |
| 基础与操作 | Button / Icon / Avatar / Tag | ✅ migrated |
| 表单与输入 | Input / Select / Form / Uploader | ✅ migrated |
| 反馈与状态 | Dialog / Toast / Progress / Empty | ✅ migrated |
| 布局与导航 | Grid / Container / Tabs / Menu | ✅ migrated |
| 数据与列表 | DataTable / Tree / VirtualList | ✅ migrated |
| 内容与媒体 | Chat / Markdown / Image | ✅ migrated |
设计模式
- Foundations 设计基础
- GlassSurface 玻璃拟态
- GradientBorder 渐变边框
- OutlineBorder 描边容器
- CornerOverlay 角标容器
- GradualBlur 渐变模糊
- EdgeFadeMask 边缘渐隐遮罩
- GlowText 扫光
- KeyframeStrokeText 关键帧描边
- TuffLogoStroke Logo 描边
- TextTransformer 文本变换
- Transition 动效
- Stagger 依次进入
- Floating 浮动层
- Fusion 交融
- Avatar Variants 头像变体
设计案例
- Agents 智能体列表
- Chat 消息列表
- ChatComposer 消息输入
- MarkdownView Markdown 渲染
- ImageGallery 图片预览
- GroupBlock 分组块
- Card 卡片
暗黑模式与主题
基础与操作
表单与输入
- Input 输入
- CodeEditor 代码编辑器
- Select 选择器
- FlatRadio 平铺单选
- SearchInput 搜索输入框
- SearchSelect 搜索选择器
- Checkbox 复选框
- Radio 单选框
- Switch 开关
- Slider 滑块
- SegmentedSlider 分段滑块
- DatePicker 日期选择
- Picker 滚轮选择
- Cascader 级联选择
- TagInput 标签输入
- Form 表单
- FileUploader 文件上传
- ImageUploader 图片上传
反馈与状态
- Dialog 弹窗
- Drawer 抽屉
- FlipOverlay 翻转遮罩
- Toast 提示
- Tooltip 提示
- Popover 弹出层
- BaseAnchor 锚点定位
- LoadingState 加载态
- LoadingOverlay 加载遮罩
- Progress 进度
- ProgressBar 进度条
- Spinner 加载
- Empty 空状态
- EmptyState 空态引导
- OfflineState 离线
- PermissionState 权限不足
- SearchEmpty 搜索空态
- Skeleton 骨架屏
- LayoutSkeleton 布局骨架
- NoData 无数据
- NoSelection 未选择
- BlankSlate 空白页
布局与导航
- Grid 栅格
- GridLayout 网格布局
- Flex 弹性布局
- Stack 堆叠
- Container 容器
- Splitter 分割面板
- Scroll 滚动
- AutoSizer 自适应尺寸
- NavBar 导航栏
- TabBar 底部导航
- Tabs 标签页
- DropdownMenu 下拉菜单
- CommandPalette 命令面板
- ContextMenu 右键菜单
数据与列表
- DataTable 数据表格
- Pagination 分页
- Tree 树形
- TreeSelect 树选择器
- SortableList 拖拽排序
- VirtualList 虚拟列表
- Steps 步骤条
- Timeline 时间线
- Transfer 穿梭框