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 环境中能够正常运行:

EdgeFirefoxChromeSafariElectron
>=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 就被设计为高度可扩展的,因此你可以根据自己的需求来定制它。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.