Skip to content

组件库

项目通用组件说明。

通用组件列表

所有通用组件位于 src/components/ 目录,采用大驼峰命名:

组件路径说明
NavBarcomponents/NavBar/导航栏,统一标题、返回按钮样式
Iconcomponents/Icon/图标组件,封装 Iconify 图标
Avatarcomponents/Avatar/头像组件,首字母渐变
SearchBarcomponents/SearchBar/搜索栏组件
EmptyStatecomponents/EmptyState/空状态占位组件
GlobalLoadingcomponents/GlobalLoading/全局加载状态
GlobalToastcomponents/GlobalToast/全局提示消息
CustomTabBarcomponents/CustomTabBar/自定义底部 TabBar
ListSkeletoncomponents/ListSkeleton/列表骨架屏
SubmitOverlaycomponents/SubmitOverlay/提交中遮罩层(防重复提交)
LandscapeOverlaycomponents/LandscapeOverlay/横屏提示遮罩
DebugPanelcomponents/DebugPanel/调试日志面板
MockTogglecomponents/MockToggle/Mock 数据开关
TrackDebugcomponents/TrackDebug/埋点调试组件

表单引擎组件

表单引擎相关组件位于 src/plugins/formCreate/components/,共 19 个自定义控件:

组件说明
DeptTreeSelect部门树选择器
UserTreeSelect人员树选择器
AreaTreeSelect地区树选择器
DictSelect字典选择器
FcSelect通用选择器
FcDatePicker日期选择器
FcTimePicker时间选择器
DatePeriodPicker日期区间选择器
DateDoubleTimePicker日期双时间选择器
AttendanceControl考勤控件
UploadFile文件上传
UploadImg单图上传
UploadImgs多图上传
Editor富文本编辑器
BaseTreeSelect基础树选择器
FcCascader级联选择器
OutsideControl外部控件
ProcessInstanceRef流程实例引用
TipsComponent提示组件

组件使用规范

  • 所有组件使用 <script setup lang="ts"> 语法
  • 组件 Props 必须定义 TypeScript 类型
  • 样式统一使用 TailwindCSS + SCSS
  • 路径统一使用 @/ 别名,禁止相对路径

基于 VitePress 构建