📐 Release v0.24.0

[jikkai]

🎊 Univer@v0.24.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
Docs Features	🔄 In development	Development of document editing and reusable editor components
Slides Features	🔄 In development	Development and iteration of slide editing capabilities

---

📐 Outline (Row/Column Grouping)

Outline (row/column grouping) is now officially available in Univer Pro. You can group rows or columns to create collapsible sections, making large spreadsheets easier to navigate and read.

Installation:

If you are using the advanced preset, Outline is already included.

pnpm add @univerjs/preset-sheets-advanced

If you prefer to install the plugins individually:

pnpm add @univerjs-pro/sheets-outline @univerjs-pro/sheets-outline-ui

Register Plugins:

import { UniverSheetsOutlinePlugin } from '@univerjs-pro/sheets-outline';
import { UniverSheetsOutlineUIPlugin } from '@univerjs-pro/sheets-outline-ui';

univer.registerPlugin(UniverSheetsOutlinePlugin);
univer.registerPlugin(UniverSheetsOutlineUIPlugin);

Key Features:

• Group and ungroup rows or columns via the toolbar, right-click context menu, or keyboard shortcuts
• Collapse and expand groups to show or hide detail rows/columns
• Automatic outline updates when rows or columns are inserted, deleted, or moved
• Permission controls for collaborative scenarios
• Full Facade API support for programmatic control
• Support for group import and export functionality

Facade API Example:

const fWorkbook = univerAPI.getActiveWorkbook();
const fWorksheet = fWorkbook.getActiveSheet();

// Group rows 2 to 6
fWorksheet.addRowOutline(1, 5);

// Group columns B to E
fWorksheet.addColumnOutline(1, 4);

// Get all row outlines
const rowOutlines = fWorksheet.getDimensionOutlines(univerAPI.Enum.DimensionOutlineAxis.ROW);

// Collapse the first group
if (rowOutlines[0]) {
  fWorksheet.setDimensionOutlineCollapsed(rowOutlines[0].id, true);
}

// Clear outlines in a range
fWorksheet.clearDimensionOutlines(univerAPI.Enum.DimensionOutlineAxis.ROW, 1, 10);

• PRs: #6914, #6920, #4843, #4851, #4853, #4854, #4847

---

🧩 UI Components

Panel Component

A new Panel component has been added to @univerjs/design and @univerjs/ui, providing a standardized container for sidebar panels.

Sidebar Enhancements

The Sidebar now supports:

• Accessibility improvements: Better keyboard navigation and ARIA attributes

• Resize support: Users can drag to resize the sidebar width

• PR: #6938

---

⚠️ Breaking Changes

Removed Deprecated APIs

The following FWorksheet APIs have been removed. Use the recommended alternatives:

Removed API	Alternative
FWorksheet.onCellDataChange	univerAPI.addEvent(univerAPI.Event.SheetValueChanged, ...)
FWorksheet.onBeforeCellDataChange	univerAPI.addEvent(univerAPI.Event.BeforeSheetEditEnd, ...)
FWorksheet.getLastRows	FWorksheet.getLastRow
FWorksheet.getLastColumns	FWorksheet.getLastColumn

• PR: #6919

Global Zone Service Removed

IGlobalZoneService and related APIs have been removed. Use IUIPartsService with BuiltInUIPart.GLOBAL instead.

• PR: #6930

---

⚡ Performance & Stability

Memory Management (Pro)

Properly managed RxJS subscriptions across collaboration cursors, live-share, pivot tables, and other modules to prevent memory leaks in long-running applications.

• PR: #4864

---

🐛 Bug Fixes

• Color Picker (#6912): Fixed hue value normalization for values >= 360 and resolved stale closure issues in event handlers.
• Sheet Drawing (#6929): Fixed image IDs not being passed to the builder correctly.

---

📢 Join the Discussion

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

• GitHub Discussions
• 👾 Discord

---

Full Changelog (2026-05-23)

---

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

[jikkai]

🎊 Univer@v0.24.0

Important

📢 即将发布 1.0 版本

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

🚧 Work In Progress

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

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

---

📐 Outline（行/列分组折叠）

Outline（行/列分组折叠） 功能在 Univer Pro 中正式可用。你可以对行或列进行分组，创建可折叠的章节，让大型表格更易于浏览和阅读。

安装：

如果你使用了 advanced preset，Outline 已内置其中，无需额外安装。

pnpm add @univerjs/preset-sheets-advanced

如果你希望单独安装插件：

pnpm add @univerjs-pro/sheets-outline @univerjs-pro/sheets-outline-ui

注册插件：

import { UniverSheetsOutlinePlugin } from '@univerjs-pro/sheets-outline';
import { UniverSheetsOutlineUIPlugin } from '@univerjs-pro/sheets-outline-ui';

univer.registerPlugin(UniverSheetsOutlinePlugin);
univer.registerPlugin(UniverSheetsOutlineUIPlugin);

核心能力：

• 通过工具栏、右键菜单或快捷键对行/列进行分组和取消分组
• 折叠和展开分组，以显示或隐藏明细行/列
• 插入、删除或移动行/列时自动更新分组结构
• 协作场景下的权限控制
• 完整的 Facade API 支持，便于编程控制
• 分组导入导出功能的支持

Facade API 示例：

const fWorkbook = univerAPI.getActiveWorkbook();
const fWorksheet = fWorkbook.getActiveSheet();

// 对第 2 到 6 行进行分组
fWorksheet.addRowOutline(1, 5);

// 对第 B 到 E 列进行分组
fWorksheet.addColumnOutline(1, 4);

// 获取所有行分组
const rowOutlines = fWorksheet.getDimensionOutlines(univerAPI.Enum.DimensionOutlineAxis.ROW);

// 折叠第一个分组
if (rowOutlines[0]) {
  fWorksheet.setDimensionOutlineCollapsed(rowOutlines[0].id, true);
}

// 清除指定范围内的分组
fWorksheet.clearDimensionOutlines(univerAPI.Enum.DimensionOutlineAxis.ROW, 1, 10);

• PRs: #6914, #6920, #4843, #4851, #4853, #4854, #4847

---

🧩 UI 组件

Panel 组件

@univerjs/design 与 @univerjs/ui 中新增了 Panel 组件，为侧边栏面板提供标准化的容器。

Sidebar 增强

Sidebar 侧边栏现在支持：

• 无障碍改进：更好的键盘导航和 ARIA 属性支持

• 拖拽调整大小：用户可拖拽调整侧边栏宽度

• PR: #6938

---

⚠️ Breaking Changes

移除废弃 API

以下 FWorksheet API 已移除，请使用推荐的替代方案：

已移除 API	替代方案
FWorksheet.onCellDataChange	univerAPI.addEvent(univerAPI.Event.SheetValueChanged, ...)
FWorksheet.onBeforeCellDataChange	univerAPI.addEvent(univerAPI.Event.BeforeSheetEditEnd, ...)
FWorksheet.getLastRows	FWorksheet.getLastRow
FWorksheet.getLastColumns	FWorksheet.getLastColumn

• PR: #6919

移除 Global Zone Service

IGlobalZoneService 及相关 API 已移除。请改用 IUIPartsService 配合 BuiltInUIPart.GLOBAL。

• PR: #6930

---

⚡ 性能与稳定性

内存管理（Pro）

在协作光标、Live Share、数据透视表等模块中正确管理 RxJS 订阅，防止长时间运行场景下的内存泄漏。

• PR: #4864

---

🐛 问题修复

• 取色器（#6912）：修复 hue 值 >= 360 时的归一化问题，并解决事件处理器中的闭包过期问题。
• 表格绘图（#6929）：修复图片 ID 未正确传递给构建器的问题。

---

📢 加入讨论

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

• GitHub Discussions
• 👾 Discord

---

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

[dumsky-piper]

@jikkai waiting for the RTL support :) will it be only in v1.0?