Skip to content

搜索表格 ​

模板在 /examples/search-table 提供完整的搜索表格示例。启动应用后访问该路由,可以验证搜索、重置、分页、排序、多选、列显隐、密度切换、全屏、深色模式和移动端横向表格。

在示例的关键词中输入 error 可以验证错误恢复,输入 slow 可以验证慢请求与请求取消。文档不直接打包模板应用页面,避免文档站与模板运行时形成隐式构建依赖。

接入真实接口时,将请求参数中的 signal 传递给 HTTP 层,继续返回 { records, total }。具体约定见 HTTP 请求契约。

搜索栏和表格卡片的四周内边距、搜索栏与卡片之间的间距、工具栏与表格内容之间的间距默认均为 12px;可通过 KvSearchTable 间距配置 覆盖。

文件结构 ​

列表页直接复用组件库的 KvSearchTablePage,每个页面只需维护自己的配置目录:

text
src/
└── views/examples/search-table/
    ├── index.vue             # 业务配置连接和特殊单元格
    ├── search.config.ts      # 搜索项与状态选项
    ├── table.config.ts       # 表格列配置
    └── service.ts            # 行/查询类型、Mock 数据和分页请求

职责划分如下:

  • KvSearchTablePage(@kevairy/components)内部封装 usePagedTable、列显隐、标准事件和自适应高度;
  • index.vue 只传入配置、请求函数和特殊单元格插槽;
  • search.config.ts 只定义搜索条件,不包含页面布局;
  • table.config.ts 只定义列、格式化和排序能力,不包含单元格 UI;
  • service.ts 是接口适配层。接入真实后端时替换 fetchServicePage,继续返回 { records, total }。

页面接入 ​

普通列表页只需传入标题、行键、搜索项、列配置和请求函数:

vue
<KvSearchTablePage
  title="服务目录"
  row-key="id"
  :search-items="searchItems"
  :columns="serviceTableColumns"
  :request="fetchServicePage"
/>

查询、加载、错误、分页、排序、多选、刷新和列设置都由组件内部管理。特殊单元格通过列插槽实现,批量操作通过 bulk-actions 插槽实现。

工具栏业务按钮直接放入 toolbar-left / toolbar-right 插槽,与内置按钮统一保持 8px 间距,不要额外叠加 margin 或间距容器。包装分组时也须保持组内及组间间距一致,详见 插槽按钮间距规范。

页面模式只负责说明业务文件如何组织。完整的 Props、v-model、Slots 和 Expose 以 KvSearchTablePage API 为准,避免在模板和组件文档中维护两份接口定义。

组件根节点使用模板布局提供的 --art-full-height 作为可用高度。脱离模板布局时会回退为父容器的 100% 高度。