Skip to content

从模板旧组件迁移 ​

从模板内旧实现迁移到 @kevairy/components 0.1.x。

名称映射 ​

旧名称新名称
AppStatusKvStatus
ArtSearchBarKvSearchBar
ArtTableHeaderKvTableToolbar
ArtTableKvTable
AppSearchTableKvSearchTable
SearchTablePageKvSearchTablePage

1. 修改导入 ​

ts
import { KvSearchTable, usePagedTable } from '@kevairy/components'
import '@kevairy/components/style.css'

只有 composables、类型和参数工具的模块使用轻量入口:

ts
import { type PagedTableRequest, usePagedTable } from '@kevairy/components/core'

删除指向 src/components/core/...、src/components/patterns/...、旧 hooks 和表单工具的相对导入。

2. 显式提供受控状态 ​

旧组件从 Pinia 和模板配置读取外观;新组件要求应用决定状态与持久化方式。

vue
<KvSearchTable
  v-model:search-model="query"
  v-model:column-checks="columnChecks"
  v-model:appearance="appearance"
  row-key="id"
  v-bind="tableState"
/>

row-key 不再隐式假设为 id。外观状态包含 size、stripe、border 和 headerBackground。

3. 适配请求契约 ​

请求函数返回 { records, total },并将 AbortSignal 透传给 HTTP 客户端。不要把后端响应结构写入组件。

ts
const request = async ({ query, current, size, sort, signal }) => {
  const response = await api.list({ ...query, current, size, sort }, { signal })
  return { records: response.items, total: response.totalCount }
}

4. 注入文案和业务插槽 ​

组件不访问应用的 vue-i18n 实例。先在应用侧翻译,再通过 messages 传入。业务按钮使用 toolbar-*、bulk-actions 和列插槽,不修改组件源码。

5. 删除旧实现 ​

确认页面只从 workspace 包导入后,删除旧组件、usePagedTable、参数清洗、响应式 span、表格 Store 和重复测试。仓库中不应保留两份实现。

验收 ​

  • 查询、重置、分页、排序、取消请求、错误恢复和多选通过;
  • 键盘可操作工具栏和列设置;
  • 375px 下只有表格内部横向滚动;
  • 浅色、暗色和 reduced-motion 可用;
  • pnpm test:unit、pnpm typecheck、pnpm build 与 pnpm test:e2e 通过;
  • 组件冒烟项目能解析类型和样式,@kevairy/components/core 不包含 UI 实现。