🎉 Release v0.21.0

[wpxp123456]

🎊 Univer@v0.21.0

🚧 Important Note

Your feedback is crucial! Please submit issues and suggestions to help us shape the future of Univer.

🚀 Getting Started

If you're eager to explore Univer, check out our getting started documentation.
Dive into the world of collaborative document, spreadsheet, and presentation editing powered by Univer!

📊 Univer Sheets

💔 Breaking Changes

• Refactor and fix issues related to permission control APIs, with the following changes: refactor(permission): refactor and fix some permission API-related issues #6804
  • Remove the FPermission class and all its creation methods.
  • Remove all APIs that listen for permission changes.
  • Adjust FPermission.setPermissionDialogVisible to FWorkbookPermission.setPermissionDialogVisible.
  • Remove setPoint and getPoint related methods from FRangePermission.
  • Add setPoint and getPoint related methods to FRangeProtectionRule.
  • The setPoint method is used to update the permission point, which will synchronize the server status in collaborative editing scenarios:
    • false: This permission point requires at least the owner role.
    • true: This permission point requires at least the editor role.
  • When creating a protected range rule, remove the allowEdit field from the options parameter, and use the allowUsers field to determine whether it is "only me" or "specified users" who can edit.
• Refactor and improve the user experience and accessibility of the collaboration status component in the upper right corner of the collaborative document, with the following changes:
  • The component no longer displays text labels, only icons, to reduce visual interference.
  • Show detailed status tips on mouse hover.
  • Add correct ARIA attributes (role, aria-live, aria-label).
  • Make the offline status clickable and support keyboard input (Enter / Space).
  • Add a spinning animation for status synchronization.

🐛 Bug Fixes and Optimizations

• Fix the issue of IRepeatLastActionService not registered on mobile. fix(mobile): fix dependency not registered #6806
• Fix some API operations that were not blocked by permission control. fix(permission): fix some API operations that were not blocked by permission control #6815
• Fix some known issues with shapes.

🌐 Univer Server

• Fix the issue of conditional formatting anomalies after importing some low-version Excel files.

📢 Join the Conversation

We welcome your input and insights as we embark on this exciting journey. Connect with us on:

• GitHub Discussions
• 👾 Discord

📝 Changelog

Full changelog (2026-04-18)

Bug Fixes

• aligan: update (#6798) (f5db141)
• formula: optimize the logic of inverted index (#6818) (79d2c30)
• mobile: fix dependency not registered (#6806) (2a010b6)
• permission: fix some API operations that were not blocked by permission control (#6815) (3d6f418)
• protocol: correct method name from IUpdateCollaborator to UpdateCollaborator (#6817) (3479e20)

Features

• protocol: add protocol package (#6816) (0da09ac)

---

This discussion was created from the release 🎉 Release v0.21.0.

[wpxp123456]

🎊 Univer@v0.21.0

🚧 重要提示

Univer Sheets 的各项功能正趋于稳定，我们正在计划 release 1.0。如果你有任何建议，欢迎在issues 提交，帮助我们塑造 Univer 的未来。

🚀 快速开始

如果您希望了解 Univer，请查看我们的入门文档。
深入探索由 Univer 提供支持的协作文档、电子表格和演示文稿编辑的世界！

📊 Univer Sheets

💔 破坏性更新

• 重构并修复权限控制 API 相关问题，主要变更如下：refactor(permission): refactor and fix some permission API-related issues #6804
  • 移除 FPermission 类及其所有创建方法。
  • 移除所有监听权限变更的 API。
  • 将 FPermission.setPermissionDialogVisible 调整为 FWorkbookPermission.setPermissionDialogVisible。
  • 从 FRangePermission 中移除 setPoint 和 getPoint 相关方法。
  • 在 FRangeProtectionRule 中新增 setPoint 和 getPoint 相关方法。
  • setPoint 用于更新权限点位，在协同编辑场景下会同步更新服务端状态：
    • false：该权限点至少需要 owner 角色。
    • true：该权限点至少需要 editor 角色。
  • 创建保护范围规则时，移除 allowEdit 字段，以 allowUsers 字段来确定是 “仅我可以编辑” 还是 “指定用户编辑”。
• 重构协同文档右上角状态组件，优化用户体验与无障碍支持：
  • 移除文本标签，仅保留图标，减少视觉干扰。
  • 鼠标悬停时显示详细状态提示。
  • 添加正确的 ARIA 属性（role、aria-live、aria-label）。
  • 离线状态支持点击及键盘操作（Enter / Space）。
  • 为状态同步添加旋转动画。

🐛 改进与优化

• 修复移动端报 IRepeatLastActionService 未注册的问题。fix(mobile): fix dependency not registered #6806
• 修复部分 API 操作未被权限控制拦截的问题。fix(permission): fix some API operations that were not blocked by permission control #6815
• 修复若干形状相关问题。

🌐 Univer Server

• 修复部分低版本 Excel 文件导入后条件格式异常的问题。

📢 加入讨论

我们欢迎您的参与和见解，一起踏上这个激动人心的旅程。请通过以下方式与我们联系：

• GitHub Discussions
• 👾 Discord

📝 更新日志

完整的更新日志 (2026-04-18)