Skip to content

通用能力

useRowActions

声明式生成表格操作列。支持平铺按钮、更多下拉、权限码、按行显隐/禁用、图标和删除确认。应在组件 setup 中调用。

useConfirm

统一确认弹窗,默认禁止 Esc 和点击遮罩误关闭;异步确认期间按钮保持 loading,接口失败时弹窗保留以便重试。

ts
const { confirm } = useConfirm()
confirm({
  title: '发布确认',
  content: '确认发布当前版本吗?',
  type: 'warning',
  onConfirm: () => publishApi(id),
})

useBatchOptions

用于批量删除或批量更新。选中项按 batchSize 分批串行请求,显示进度,单批失败不阻断剩余任务,最后汇总成功/失败批次。可通过 batchInterval 控制服务端压力。

useExport

用于分页拉取导出数据并生成文件,适合数据量无法一次返回的列表。后端应返回表头、当前页 rows 和 total;前端按页拉取并汇总。大数据导出更推荐后端异步任务,避免浏览器内存过高和请求超时。

useResultModal

把批量导入、批量更新等接口返回的逐行结果展示为表格,可配置主键、身份字段、列标题和字典渲染。

Search 与 Table

Search 使用配置数组描述输入框、选择器等条件;Table 统一承载列、分页、选择、加载和错误重试。新增页面应优先复用它们,以保持交互一致。

文件工具

src/utils 还提供 CSV、XLSX、ZIP/压缩包解析、文件下载与文件类型判断。处理用户上传文件时要同时在服务端限制文件类型、实际内容、大小、压缩层级和解压总量,防范恶意文件与压缩炸弹。

基于 MIT License 开源