QuiTable 组件
概述
- 封装基于
naive-ui的表格,支持列设置、导出、列拖拽(需vuedraggable)、尺寸切换等能力。 - 通过
TableProps提供类型约束与智能提示。
基本用法
常用属性
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
`size` | 'small' | 'medium' | 'large' | — | 表格尺寸 |
`columns` | Array<{ title?: string; key: string; render?: Function; }> | — | 列配置数组,支持设置标题、字段键名、自定义渲染函数等 |
`data` | any[] | — | 静态表格数据;若需异步加载,可配合 fetch 函数使用 |
`show-settings` | boolean | — | 是否显示列设置面板(支持显示/隐藏列);如需拖拽排序,请额外安装 vuedraggable |
`exportable` | boolean | TableExportType | — | 是否启用导出功能;若为对象,可指定导出类型(详见 TableExportType 类型定义) |
默认配置
QuiTable 默认值(来自组件内部逻辑):
基础设置
| 参数 | 默认值 | 说明 |
|---|---|---|
| size | 'medium' | 未传入时使用中等尺寸 |
| striped | true | 默认开启斑马纹(来自主题 table.striped) |
| hidebar | false | 默认显示顶部工具栏 |
列默认项(每列合并)
| 参数 | 默认值 |
|---|---|
| fixed | false |
| ellipsis | { tooltip: true } |
| resizable | true |
| align | 'center' |
表格 Props 默认项
| 参数 | 默认值 |
|---|---|
| remote | true |
| renderCell | v ?? '信息缺失' |
分页默认项
| 参数 | 默认值 |
|---|---|
| page | 1 |
| pageSize | 10 |
| showSizePicker | true |
| showQuickJumper | true |
| pageSizes | [10, 20, 50, 100] |
| prefix | 共 {itemCount} 条 |
说明
- 若需高级用法(如服务端分页、筛选与排序),请在实际项目中结合
fetch、onUpdate等事件进行拓展。 - 更多示例将持续补充到插件文档目录中。