Skip to content

Spec UI配置对齐Airtable Interface能力,补全ListView/Page等声明式功能 #748

Description

@hotlong

问题背景

评估 Airtable Interface 风格的客户列表界面,发现 Spec UI 配置存在与实际业务需求(如截图所示)差距。当前 ListViewSchema/PageSchema 仅部分覆盖,未能满足所有高级可视化、用户定制、操作与布局能力需求。

客户列表 Airtable 配置截图

主要功能差距(Gap Analysis)

  1. Page-level Interface 配置缺失: 需支持 title、levels、filter by、appearance、user actions、advanced(如打印)等声明式页面级配置。
  2. Tabs(标签页)显式配置: 缺少 tabs 排序、图标、默认选中、用户可添加等能力。
  3. User Action 配置不足: 排序、搜索、过滤、行高切换、添加记录入口、按钮开放性需更强声明式支持。
  4. Record Count 显示配置缺失: 底部记录数显示 configurable。
  5. Add Record 入口配置缺失: 添加记录入口(位置、模式、是否通过表单等)需可配置。
  6. Visualizations 白名单缺失: 控制用户可切换的可视化类型列表。

改进建议

  • view.zod.ts 或新增 InterfacePageSchema 补充:
    • userActions 配置对象(sort/search/filter/rowHeight/addRecordForm/buttons)。
    • appearance 配置对象(showDescription, allowedVisualizations)。
    • tabs 数组和 ViewTabSchema,支持多 tab 排序、图标、pin 等。
    • showRecordCount 布尔开关。
    • addRecord 配置对象。
    • allowPrinting 高级功能。
  • 更强的 PageSchema 与 ListViewSchema 配合,支持 Airtable Interface 级细粒度声明式配置。

优先级与后续

  • P0:User Actions、Appearance、Visualizations 支持(与业务交互强相关)
  • P1:Tabs、Add Record、Record Count
  • P2:Printing、高级操作

完成后需补全测试,更新 ROADMAP.md


参考

  • Screenshot(Airtable Interface parity)
  • 源文件:packages/spec/src/ui/view.zod.ts, page.zod.ts

本 Issue 旨在推动 Spec UI Schema 的接口声明能力与实际业务需求对齐,实现与 Airtable Interface 同等交互/配置能力,为 Studio 及业务应用提供更完整 UI 元数据支持。


相关 Roadmap/实现后请运行测试并同步 ROADMAP.md。

Metadata

Metadata

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions