用途:本技能仅用于在消费侧把 @qfei-design/canvas-table 集成进应用或页面,不用于发布或维护该表格库本身,也不支持用 Ant Design Table、Arco Table、TDesign Table 或原生 HTML 表格替代产品表格。
轨道结构:Track A 为非 Make 的本地/虚拟表基础轨道,涉及公开 API、行头操作、可选选择/拖拽/汇总与轻量 canvas 交互;Track C 为 Make schema 驱动列表格基础轨道,涉及共享字段展示注册表、纯值归一化、字段渲染器与仅溢出省略提示;Track B 为编辑增强层,基于 customEdit、受控提交、弹层归属、宿主字段编辑器与回滚,不能替代所选展示基础轨道。每个 Make schema 表都选 Track C 为基础,仅当列非 schema 驱动时才选 Track A;只有明确需要或已存在编辑时才叠加 Track B。
主要能力:schema 字段归一化后生成 IColumn[] 与渲染器;桌面/平板字段表头默认显示 Lucide 类型图标(经 prefixRender);行头默认启用 showSN 序号与悬停展开详情;可写 Make 记录列表默认启用多选并接入 make-app-actions;1.3.1 及以上支持业务行颜色与选择/悬停的显式优先级;支持虚拟加载、大数据快速滚动、分组与单元格编辑。
使用方式:先确认当前项目已安装 @qfei-design/canvas-table,无 package.json 则停止;按锁文件选择包管理器安装,例如 pnpm 用 pnpm add @qfei-design/canvas-table,Make App 用 corepack pnpm add @qfei-design/canvas-table。随后按 package.ai.json 的 readOrder 顺序阅读包内文档,再按主题映射读取对应 references 文件。仅在浏览器/客户端实例化,使用显式宽高的真实 DOM 容器,仅用公开 API,不导入 src 或 dist,卸载时销毁实例,切换对象/实体/schema 时重置滚动与交互状态,不可把原始 meta 直接传入运行时。
限制:分页、排序、分组、单元格编辑均为按需开启;表头排序路由到 make-app-sort,分组路由到 make-app-group,服务路由相关交给 make-app-service;详细字段编辑器行为与陷阱清单见包内 references。部分具体 API 签名与示例未在本资料中提供。