📐 Release v0.25.0 #6996

wpxp123456 · 2026-05-30T12:49:22Z

wpxp123456
May 30, 2026
Maintainer

🎊 Univer@v0.25.0

Important

📢 1.0 Release Coming Soon

We are working hard on the official release of Univer 1.0, which will be a major milestone for the project. Stay tuned!

🚧 Work In Progress

The following features are actively under development. Some modules are already available, and the full experience will be delivered gradually in subsequent versions:

Direction	Status	Description
Performance Optimization	🔄 Ongoing	Performance tuning for the core engine and rendering pipeline
Base 功能	🔄 In development	Multi-dimensional table (Base) functionality
Docs Features	🔄 In development	Document editing and reusable editor components
Slides Features	🔄 In development	Development and iteration of slide editing capabilities

📝 Docs Table

Docs Table receives significant enhancements across both Univer and Univer Pro, delivering a more complete table editing experience in documents.

Univer:

Polished table rendering, selection behavior, and contextual menus
Restored document zoom functionality with smoother zoom controls
Added Facade APIs for programmatic table insertion and manipulation
Improved paragraph spacing defaults for modern document layouts
Enhanced clipboard support for tables (copy, paste, and paste-without-formatting)

Univer Pro:

Full table editing capabilities: insert/delete rows and columns, merge/unmerge cells, resize rows/columns, and move tables
Table borders: set border styles, widths, colors, and background fills
Table sorting and header row configuration
Column type configuration support
Horizontal scrollbar support for wide tables
Canvas-based table rendering with drag-to-resize interactions
Comprehensive Facade APIs for table operations

Facade API Example:

const doc = univerAPI.getActiveDocument();

// Insert a 3x4 table at the current cursor position
doc.insertTable(3, 4);

// Insert a table at a specific position
doc.insertTable(3, 4, { startIndex: 10 });

PRs: #6926, #6968

🎨 Docs Ecosystem (Pro)

A suite of new document editing modules is now available in Univer Pro, enabling rich document authoring beyond tables:

Module	Description
Docs Shape	Insert and edit shapes in documents, with shape text editing and floating toolbars
Docs Callout	Insert callout blocks with customizable background colors and an emoji picker
Docs Code Block	Insert code blocks with syntax highlighting and language selection
Docs List	Enhanced list editing with custom bullets, prefix/suffix settings, and start-number configuration
Docs Quote	Insert quote blocks for styled quotations

These modules are integrated with the license plugin and include configuration schemas for customization.

📊 Pivot Table Facade API (Pro)

The pivot table facade API has been enhanced with more comprehensive control:

Added FPivotTable facade class with methods for updating fields, source ranges, collapse states, and value filters
Added pivot-related enums to FEnum for easier programmatic configuration
Added a dedicated pivot table facade example

🌍 Internationalization

Thai Language Support

Univer now supports Thai language text rendering in documents, including proper character shaping and line breaking for Thai scripts.

PR: #6960

New Language Support

This release adds support for 7 new languages across 34 packages, expanding Univer's global reach:

ar-SA Arabic (العربية)
de-DE German (Deutsch)
id-ID Indonesian (Bahasa Indonesia)
it-IT Italian (Italiano)
pl-PL Polish (Polski)
pt-BR Portuguese Brazilian (Português Brasileiro)
zh-HK Chinese Traditional Hong Kong (繁體中文香港)
PR: #6958

⚠️ Breaking Changes

Locale Namespace Restructure

All locale keys have been restructured to use package-name prefixes as namespaces. This is a global change across nearly all packages.

Before	After
`'button.confirm'`	`'find-replace.button.confirm'`
`'permission.filterErr'`	`'sheets-filter-ui.permission.filterErr'`

Each package now owns exactly one namespace that matches its package name. Core and UI layers of the same feature use different namespaces (e.g., sheets-filter and sheets-filter-ui).

If you maintain custom locale overrides or custom packages, update your locale keys accordingly.

As part of this restructure, the following language packages have been added or removed. Update your imports accordingly:

Added:

@univerjs/data-validation
@univerjs/docs-thread-comment-ui
@univerjs/sheets-data-validation
@univerjs/sheets-filter
@univerjs/sheets-hyper-link
@univerjs/sheets-table
@univerjs-pro/edit-history-loader

Removed:

@univerjs/sheets-find-replace (Locale files deleted entirely)
@univerjs/sheets-sort (Locale content merged into sheets-sort-ui)

Example:

// Added packages: import their locales if you use them standalone
+ import dataValidationLocale from '@univerjs/data-validation/locale/en-US';
+ import sheetsDataValidationLocale from '@univerjs/sheets-data-validation/locale/en-US';
+ import sheetsFilterLocale from '@univerjs/sheets-filter/locale/en-US';
+ import sheetsHyperLinkLocale from '@univerjs/sheets-hyper-link/locale/en-US';
+ import sheetsTableLocale from '@univerjs/sheets-table/locale/en-US';

// Removed packages: remove their locale imports
- import sheetsSortLocale from '@univerjs/sheets-sort/locale/en-US';

PR: #6948

Removed Deprecated Data Validation APIs

The following deprecated FWorkbook APIs in @univerjs/sheets-data-validation have been removed:

Removed API	Alternative
`FWorkbook.addDataValidation`	Use `FRange.setDataValidation` or commands directly
`FWorkbook.removeDataValidation`	Use `FRange.setDataValidation(null)` or commands directly
`FWorkbook.updateDataValidation`	Use `FRange.setDataValidation` or commands directly
`FWorkbook.getDataValidation`	Use `FWorksheet.getDataValidations`
`FWorkbook.getValidatorStatus`	Use `FWorksheet.getValidatorStatusAsync`

Additionally, list option serialization utilities have been moved from sheets-data-validation to sheets. If you were importing these utilities directly, update your imports.

PRs: #6955, #6949

⚡ Performance & Stability

Memory Leak Fixes

Fixed memory leaks in the before-close service and ribbon service caused by improper RxJS subscription cleanup.

PR: #6991

Frozen Area Ghosting

Fixed ghosting artifacts in frozen areas when scrolling sheets.

PR: #6969

Large Spreadsheet Scrolling Lag Fix

Fixed scrolling lag in large spreadsheets, improving scrolling smoothness.

PR: #6959

Collaboration Image Upload

Fixed pasted base64 images not being uploaded correctly in collaborative document editing.

PR: #6985

🐛 Bug Fixes

Find & Replace (#6970): Fixed abnormal scrolling behavior when navigating matches across worksheets.
Formula Facade (#6947): Fixed an issue with the onCalculationResultApplied API in worker threads.
Filter (#6954): Facade commands now register correctly without requiring the UI plugin.
Table (#6964, #6965): Fixed an issue where Table filter rows affected other worksheets.
Table (#6946): Fixed issues related to Table formula references.
Sheet (#6976): Fixed an issue where scrolling a Sheet upward before reaching the boundary triggered scrolling in the outer container.
Sheet (#6957): Fixed an issue where setting custom on empty cells caused borders to disappear in some scenarios.

Thanks to community contributor @IMSupperkaka for their contribution to this release:

Data Validation (#6942): Fixed missing commas in dropdown list options.

📢 Join the Discussion

Have questions, feedback, or ideas? Reach out to us at:

GitHub Discussions
👾 Discord

Full Changelog (2026-05-30)

This discussion was created from the release 📐 Release v0.25.0.

wpxp123456 · 2026-05-30T12:50:47Z

wpxp123456
May 30, 2026
Maintainer Author

🎊 Univer@v0.25.0

Important

📢 即将发布 1.0 版本

我们正全力准备 Univer 1.0 的正式发布，这将是项目的一个重要里程碑。敬请期待！

🚧 Work In Progress

以下功能正在积极开发中，部分模块已可用，完整体验将在后续版本逐步交付：

方向	状态	说明
性能优化	🔄 持续迭代	核心引擎与渲染管线的性能打磨
Base 功能	🔄 开发中	多维表格（Base）功能的开发
Docs 功能	🔄 开发中	文档编辑与可复用编辑器组件的开发
Slides 功能	🔄 开发中	幻灯片编辑能力的开发与迭代

📝 文档表格（Docs Table）

文档表格在 Univer 和 Univer Pro 中均获得重大增强，带来更完整的文档表格编辑体验。

Univer：

优化了表格渲染、选区行为和右键菜单
恢复了文档缩放功能，缩放控制更加顺滑
新增 Facade API，支持编程方式插入和操作表格
优化了现代文档布局的默认段落间距
增强了对表格的剪贴板支持（复制、粘贴、纯文本粘贴）

Univer Pro：

完整的表格编辑能力：插入/删除行列、合并/拆分单元格、调整行列大小、移动表格
表格边框：支持设置边框样式、宽度、颜色和背景填充
表格排序和表头行配置
列类型配置支持
宽表格的水平滚动条支持
基于 Canvas 的渲染，支持拖拽调整大小
全面的表格操作 Facade API

Facade API 示例：

const doc = univerAPI.getActiveDocument();

// 在当前光标位置插入一个 3x4 的表格
doc.insertTable(3, 4);

// 在指定位置插入表格
doc.insertTable(3, 4, { startIndex: 10 });

PRs: #6926, #6968

🎨 文档生态扩展（Pro）

Univer Pro 新增了一系列文档编辑模块，让文档创作能力超越表格：

模块	说明
Docs Shape	在文档中插入和编辑形状，支持形状内文本编辑和浮动工具栏
Docs Callout	插入标注块，支持自定义背景色和表情符号选择器
Docs Code Block	插入代码块，支持语法高亮和语言选择
Docs List	增强的列表编辑，支持自定义项目符号、前缀/后缀设置和起始编号配置
Docs Quote	插入引用块，用于样式化的引用内容

这些模块均已集成 License 插件，并包含配置 Schema 以便自定义。

📊 数据透视表 Facade API 增强（Pro）

数据透视表的 Facade API 得到全面增强：

新增 FPivotTable Facade 类，支持更新字段、数据源范围、折叠状态和价值过滤
在 FEnum 中新增透视表相关枚举，便于编程配置
新增数据透视表 Facade 示例

🌍 国际化

泰语渲染支持

Univer 现在支持文档中的泰语文本渲染，包括泰语文字的正确塑形和换行处理。

PR: #6960

新增语言支持

本版本为 34 个包新增了 7 种语言支持，进一步扩展了 Univer 的全球化覆盖：

ar-SA 阿拉伯语
de-DE 德语
id-ID 印尼语
it-IT 意大利语
pl-PL 波兰语
pt-BR 巴西葡萄牙语
zh-HK 繁体中文（香港）
PR: #6958

⚠️ 破坏性变更

Locale Namespace 重构

所有 locale key 已重构为使用包名前缀作为命名空间。这是一个跨几乎所有包的全局变更。

变更前	变更后
`'button.confirm'`	`'find-replace.button.confirm'`
`'permission.filterErr'`	`'sheets-filter-ui.permission.filterErr'`

每个包现在拥有唯一一个与其包名一致的命名空间。同一功能的核心层和 UI 层使用不同的命名空间（例如 sheets-filter 和 sheets-filter-ui）。

如果你维护了自定义的 locale 覆盖或自定义包，请相应地更新 locale key。

此次重构同时带来了以下语言包的新增与移除，请同步调整导入：

新增：

@univerjs/data-validation
@univerjs/docs-thread-comment-ui
@univerjs/sheets-data-validation
@univerjs/sheets-filter
@univerjs/sheets-hyper-link
@univerjs/sheets-table
@univerjs-pro/edit-history-loader

移除：

@univerjs/sheets-find-replace (Locale 文件已被全部删除)
@univerjs/sheets-sort（Locale 内容合并到 sheets-sort-ui）

示例：

// 新增包：如独立使用需导入其语言包
+ import dataValidationLocale from '@univerjs/data-validation/locale/zh-CN';
+ import sheetsDataValidationLocale from '@univerjs/sheets-data-validation/locale/zh-CN';
+ import sheetsFilterLocale from '@univerjs/sheets-filter/locale/zh-CN';
+ import sheetsHyperLinkLocale from '@univerjs/sheets-hyper-link/locale/zh-CN';
+ import sheetsTableLocale from '@univerjs/sheets-table/locale/zh-CN';

// 移除包：删除对应的语言包导入
- import sheetsSortLocale from '@univerjs/sheets-sort/locale/zh-CN';

PR: #6948

移除废弃的数据验证 API

@univerjs/sheets-data-validation 中以下废弃的 FWorkbook API 已移除：

已移除 API	替代方案
`FWorkbook.addDataValidation`	使用 `FRange.setDataValidation` 或直接使用命令
`FWorkbook.removeDataValidation`	使用 `FRange.setDataValidation(null)` 或直接使用命令
`FWorkbook.updateDataValidation`	使用 `FRange.setDataValidation` 或直接使用命令
`FWorkbook.getDataValidation`	使用 `FWorksheet.getDataValidations`
`FWorkbook.getValidatorStatus`	使用 `FWorksheet.getValidatorStatusAsync`

此外，列表选项序列化工具已从 sheets-data-validation 移动到 sheets。如果你直接引用了这些工具，请更新导入路径。

PRs: #6955, #6949

⚡ 性能与稳定性

内存泄漏修复

修复了 before-close 服务和 ribbon 服务中因 RxJS 订阅未正确清理导致的内存泄漏。

PR: #6991

冻结区域残影修复

修复了滚动表格时冻结区域出现的残影问题。

PR: #6969

大数据量表格滚动卡顿修复

修复了大数据量表格滚动卡顿的问题，提升了滚动流畅度。

PR: #6959

协作图片上传修复

修复了协作文档编辑中粘贴的 base64 图片未能正确上传的问题。

PR: #6985

🐛 问题修复

查找替换（#6970）：修复跨工作表匹配导航时的滚动行为异常。
公式 Facade（#6947）：修复 worker 线程下 onCalculationResultApplied API 的问题。
筛选（#6954）：Facade 命令现在无需 UI 插件即可正确注册。
表格（Table）（#6964、#6965）：修复 Table 筛选行影响其它工作表的问题。
表格（Table）（#6946）：修复 Table 公式引用相关问题。
Sheet（#6976）：修复 Sheet 向上滚动未到边界时触发外部容器滚动的问题。
Sheet（#6957）：修复部分场景下为空单元格设置 custom 后边框消失的问题。

感谢社区贡献者 @IMSupperkaka 对此次版本的贡献：

数据验证（#6942）：修复下拉列表下拉选项中的逗号丢失问题。

📢 加入讨论

有问题或建议？欢迎通过以下渠道找到我们：

GitHub Discussions
👾 Discord

完整的更新日志 (2026-05-30)

0 replies

Navigation Menu

Uh oh!

Uh oh!

📐 Release v0.25.0 #6996

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

Uh oh!

📐 Release v0.25.0 #6996

Uh oh!

wpxp123456 May 30, 2026 Maintainer

🎊 Univer@v0.25.0

🚧 Work In Progress

📝 Docs Table

🎨 Docs Ecosystem (Pro)

📊 Pivot Table Facade API (Pro)

🌍 Internationalization

Thai Language Support

New Language Support

⚠️ Breaking Changes

Locale Namespace Restructure

Removed Deprecated Data Validation APIs

⚡ Performance & Stability

Memory Leak Fixes

Frozen Area Ghosting

Large Spreadsheet Scrolling Lag Fix

Collaboration Image Upload

🐛 Bug Fixes

📢 Join the Discussion

Replies: 1 comment

Uh oh!

wpxp123456 May 30, 2026 Maintainer Author

🎊 Univer@v0.25.0

🚧 Work In Progress

📝 文档表格（Docs Table）

🎨 文档生态扩展（Pro）

📊 数据透视表 Facade API 增强（Pro）

🌍 国际化

泰语渲染支持

新增语言支持

⚠️ 破坏性变更

Locale Namespace 重构

移除废弃的数据验证 API

⚡ 性能与稳定性

内存泄漏修复

冻结区域残影修复

大数据量表格滚动卡顿修复

协作图片上传修复

🐛 问题修复

📢 加入讨论

wpxp123456
May 30, 2026
Maintainer

wpxp123456
May 30, 2026
Maintainer Author