用途:这是 @visactor/vtable 的开发助手,面向使用该库进行高性能表格组件开发的场景。可在用户提到 VTable、ListTable、PivotTable、PivotChart、columns/rows/indicators、cellType、style/theme、customRender/customLayout 等内容时提供辅助。
主要能力:创建与配置三种表格类型(ListTable、PivotTable、PivotChart);使用资料所述 13 种单元格类型(如 text、link、image、chart 等);配置样式、主题与自定义渲染(customRender / customLayout JSX);实现选择、hover、编辑、排序、拖拽、滚动等交互;诊断表格不显示、性能、事件、内存泄漏等问题;生成可运行的 TypeScript 示例代码。
使用方式:助手按用户意图关键词路由到 references/knowledge、references/type、references/examples 等知识文档,优先加载 knowledge 再补 type,通常只加载解决当前问题必需的 1-3 个文件;需要可运行 demo 或完整配置时再加载示例。输出须通过脚本生成 HTML,不允许手写 HTML 或仅输出片段;诊断场景用 scripts/generate_diagnosis_html.py,生成/编辑场景用 scripts/generate_demo_html.py,例如:python3 scripts/generate_demo_html.py --spec-file spec.js --output output/demo.html,以及 python3 scripts/generate_diagnosis_html.py --config-file config.js --output output/diagnosis.html。输出须包含脚本命令与文件路径,便于复现。
代码规范:使用 TypeScript,import 来源为 '@visactor/vtable';实例化须指定 container(HTMLElement);列定义使用 ColumnsDefine(ListTable)或 rows/columns/indicators(PivotTable);样式支持静态值与回调函数;事件用 tableInstance.on('event_name', handler);销毁须调用 tableInstance.release();透视表分析需配置 dataConfig 中的 aggregationRules。输入代码需移除 import / export 后再写入 spec.js 或 config.js,且不得创建或覆盖 scripts 下的脚本。
适用场景与限制:适用于表格创建、配置、改造与排错等开发任务;生成示例时应避免同一 container 重复实例化而不 release、在样式回调或 customRender 中做重计算、在事件回调中递归触发布局或重绘。具体收费、价格、平台等信息暂未提供。