外观
搜索表格
模板在 /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% 高度。