外观
从模板旧组件迁移
从模板内旧实现迁移到 @kevairy/components 0.1.x。
名称映射
| 旧名称 | 新名称 |
|---|---|
AppStatus | KvStatus |
ArtSearchBar | KvSearchBar |
ArtTableHeader | KvTableToolbar |
ArtTable | KvTable |
AppSearchTable | KvSearchTable |
SearchTablePage | KvSearchTablePage |
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 实现。