Univer Bases 简介
Univer Bases 提供一个包含表、字段、记录、公式和多种视图的结构化数据工作区。
Univer Bases 是什么
Univer Bases 是 Univer Office SDK 中的多维表格产品。它专为以记录集合(而非工作表网格)为核心对象的应用而设计,非常适合用于轻量级数据库、内容工作流、审批跟踪器、CRM 风格的表格和内部工具。
Univer Office SDK 包含三个 SDK:Web SDK 提供嵌入式编辑器和无头内容处理能力,Server SDK 提供协同与文件导入导出能力,AI SDK 提供 Agent 工作流能力。
Bases 是一种独立的 Web SDK 单元类型。核心包负责表、字段、记录、视图、公式计算、搜索、命令和协同变更;UI 包负责渲染独立工作台和内置视图。
浏览器兼容性
Web SDK 的编译目标是 Chrome 88,但这并不意味着 Web SDK 能够完全支持所有主流环境。我们会尽力确保 Web SDK 在以下浏览器和 Node.js 环境中能够正常运行:
| Edge | Firefox | Chrome | Safari | Electron |
|---|---|---|---|---|
| >=88 | >=90 | >=88 | >=14.1 | >=12 |
Web SDK 依赖 Intl.Segmenter,如果你的浏览器或运行时环境暂不支持它,请先补充对应的 polyfill。我们推荐使用
@formatjs/intl-segmenter。
如果遇到无法兼容的情况,请先借助对应的 polyfill 来解决,如果仍然无法解决,请提交 issue。
Node.js 兼容性
以下仅适用于在 Node.js 环境中运行 Web SDK 的情况,并不适用于那些基于 Node.js 使用构建工具在浏览器中运行 Web SDK 的情况。
Web SDK 可以在 Node.js 环境中运行,支持的版本为 v18.17.0 及之后的版本。
主要功能
| 功能 | 用途 |
|---|---|
| 字段与附件 | 文本、数字、选择、成员、日期、附件等字段。 |
| 记录、关联与层级 | 批量写入、分页查询、跨表关联和父子记录。 |
| 视图 | 网格、看板、日历、甘特图、画廊,以及筛选、排序、分组和条件着色。 |
| 公式 | 根据字段计算结果,支持显式配置的跨文档引用。 |
| 权限 | Base、表、字段、记录和视图的编辑权限。 |
| 导入导出 | 导入 Excel、CSV、TSV,导出表数据;需要转换后端。 |
| 仪表盘与透视视图 | 汇总表数据,并组合图表、筛选控件、文字和图片。 |
| 评论 | 围绕记录讨论;多人共享需要评论服务。 |
| 协同编辑 | 多人编辑同一份 Base;需要协同服务。 |
| 历史记录 | 查看服务端保存的版本和变化。 |
如何使用这些文档
在屏幕的左侧是文档导航栏。文档页面按从基础到高级的顺序组织,你可以按照这个顺序循序渐进地了解 Web SDK,或者跳到你感兴趣的章节。你还可以在侧边栏的顶部切换 Univer Bases 的文档。
屏幕的右侧是当前页面的大纲。如果你需要快速找到页面,可以使用顶部的搜索栏或搜索快捷键(Ctrl+K 或 Cmd+K)。
我们推荐从 快速开始 出发了解 Web SDK。
前置知识
尽管我们已经尽力使得文档对新手也易于理解,但是我们必须假设你在开始阅读之前已经了解了一些基础知识,以便我们的文档可以专注于 Web SDK。
为了充分利用我们的文档,建议你对 JavaScript 及其生态系统有基本的了解。
如果你有兴趣在 Node.js 上运行 Web SDK,你还应该对 Node.js 有基本的了解。
扩展 Univer Bases
在设计之初,Web SDK 就被设计为高度可扩展的,因此你可以根据自己的需求来定制它。
你觉得这篇文档如何?