更新日志
如果您正在从旧版本升级 Spreadsheet,请查阅迁移到新版本了解详细信息。
版本 6.0.2
发布于 2026 年 7 月 1 日
修复
- 经历"从 Excel 复制 → 粘贴到 Spreadsheet → 导出/导入"流程后,单元格边框丢失的问题
- 粘贴到最后一行下方的数据无法显示,原因是网格未添加新行来容纳这些数据
版本 6.0
发布于 2026 年 5 月 20 日
重大变更
新版本对 Spreadsheet API 引入了重大变更:部分方法、属性和事件已被标记为废弃。请查阅迁移指南以跟进最新版本。
新功能
- 引入了 React Spreadsheet 封装。相关示例请查看 GitHub 示例仓库
- 引入了
SheetManager模块。这是一个用于管理 Spreadsheet 中工作表的集中式 API,可通过spreadsheet.sheets属性访问,并替代了根 Spreadsheet 实例上所有已废弃的工作表相关方法。 - 通过新的
addFormula()方法支持指定自定义(用户定义)公式 - 支持以科学计数法(指数表示法)显示数字
更新
- 支持调整单元格内容的字体大小:
- 公式引擎中新增了条件聚合函数:
COUNTIF、COUNTIFS、SUMIF、SUMIFS、AVERAGEIF、AVERAGEIFS、MAXIFS、MINIFS - 公式引擎中新增了动态数组函数:
CHOOSECOLS、CHOOSEROWS、DROP、EXPAND、RANDARRAY、SEQUENCE、SORT、SORTBY、TAKE、TEXTSPLIT、TOCOL、TOROW、UNIQUE、WRAPCOLS、WRAPROWS - 为 Spreadsheet 添加了
awaitRedraw()辅助工具,用于检测渲染过程并在组件完成渲染后执行所需代码 - 在类型定义中添加了 JSDoc 注解,可在 IDE 中直接提供内联 API 描述、参数类型和代码示例
修复
- 通过 API 切换活动工作表后焦点丢失的问题
- 转置模式下返回已更改单元格数组的问题
- 粘贴后重新计算依赖公式的问题
- 粘贴操作期间用公式覆盖锁定单元格的问题
- 在锁定单元格中运行数学公式的问题
- 对类似单元格引用、以数字开头或包含特殊字符的工作表名称进行转义的问题
- 当单元格 id 为零(第一个工作表的第一个单元格)时动态数组出现的问题
版本 5.2.9
发布于 2026 年 1 月 8 日
修复
- 在已打开的编辑器中输入时,编辑器下拉筛选现在使用
startsWith而非includes - Excel 单元格边框在导出和导入后现在可以保留
- 防止从外部表格粘贴时字体大小被覆盖
版本 5.2.8
发布于 2025 年 12 月 15 日
修复
- 在公式编辑期间选择其他单元格时焦点丢失的问题
- 键盘导航相关问题
版本 5.2.7
发布于 2025 年 12 月 9 日
修复
- 工作表包含带数据验证列表的单元格时导出到 Excel 失败的问题
- 当单元格初始值为
%时,带数据验证列表的下拉框停止工作的问题 - 在公式栏中设置焦点后
INDEX/MATCH公式失效的问题
版本 5.2.6
发布于 2025 年 11 月 19 日
修复
- 导入包含自动换行单元格的 .xlsx 文件时出现多余 DOM 元素的问题
- 管理列时列上下文菜单中列/行标签显示不正确的问题
- 冻结包含合并单元格的区域时工作表结构损坏的问题
- 改进了含有跨行/跨列单元格的工作表中的键盘导航
版本 5.2.5
发布于 2025 年 10 月 23 日
修复
- 对适合列宽的内容应用"自动换行"选项时行高减小的问题
版本 5.2.4
发布于 2025 年 9 月 24 日
修复
- 添加了对多行单元格的导出/导入支持
版本 5.2.3
发布于 2025 年 9 月 10 日
修复
- 插入 数组时单元格中数字对齐不正确的问题
- 改进了亚洲语言的输入体验
版本 5.2.2
发布于 2025 年 8 月 18 日
更新
- 增强了
setValidation()以支持内置下拉编辑器中的预测筛选 - 添加了对隐藏/冻结列/行、数据验证选择框以及 .xlsx 文件中 Excel 链接的导出/导入支持
修复
- 在冻结列/行中取消合并跨行/跨列单元格的问题
- 应用内置主题的问题
- 中文输入的问题
- MacOS 上日语输入的问题:自动补全确认导致编辑器关闭
- 编译
spreadsheet.d.ts文件的问题
版本 5.2.1
发布于 2025 年 6 月 30 日
更新
- 支持通过上下文菜单在一次操作中删除多个列/行
修复
- 复制/粘贴脚本错误
- 在工作表中选择两行或多行末尾行时删除行出现的错误
- 工具栏自定义时显示警告的问题
- 日期选择器缺少本地化的问题
- 工具栏中垂直滚动条不必要显示的问题
- 修复公式计算的数学错误
版本 5.2
发布于 2025 年 5 月 20 日
重大变更
新版本对列和行的冻结/解冻功能引入了一些变更。请查阅迁移指南以跟进最新版本。
废弃
leftSplit和topSplit配置属性已被移除
新功能
- 编辑单元格:
- 冻结/解冻列/行:
- 支持通过界面冻结/解冻列和行
- 支持通过 API 冻结/解冻列和行
- 新方法:
freezeCols()、unfreezeCols()、freezeRows()、unfreezeRows() - 新 action:
toggleFreeze parse()方法的 sheets 对象新增freeze属性
- 新方法:
- 隐藏/显示列/行:
- 支持通过界面隐藏/显示列和行
- 支持通过 API 隐藏/显示列和行
- 新方法:
hideCols()、showCols()、hideRows()、showRows() - 新 action:
toggleVisibility parse()方法 sheets 对象的 cols 和 rows 配置新增hidden属性
- 新方法:
- 使用公式:
- 文件导入:
- 新增
afterDataLoaded事件,用于指示数据加载到 Spreadsheet 已完成
- 新增
修复
- 排序问题
- 筛选器移动到新列的问题
- 使用 "addSheet" action 阻止添加工作表时出现的错误
- 筛选空白单元格的问题
- 编辑大型跨行/跨列表格的问题
- 在单元格中撤销操作时出现的错误
- 进入/编辑含有 IF 公式的单元格时出现的错误
- 剪切并粘贴链接后出现的脚本错误
- 导出/导入 .xlsx 文件时文本对齐方式更改的问题
- 某些操作后 Spreadsheet 失去焦点的问题
- 性能改进
版本 5.1.8
发布于 2024 年 12 月 10 日
修复
- 导入到框架时本地试用包的问题
版本 5.1.7
发布于 2024 年 11 月 27 日
修复
- 移除了 "item not found" 警告
- 解析优化
- 使用 (Shift)+Tab 快捷键移动到相邻单元格时,已打开的单元格编辑器不再关闭
版本 5.1.6
发布于 2024 年 7 月 25 日
修复
- 插入的行/列在加载时从序列化数据中丢失
- 空日期单元格在日期选择器和时间选择器中显示最后选择的日期
- 数字本地化和单元格中空字符串值的问题
- 编辑单元格时搜索功能无法获得焦点
- 为 Spreadsheet 容器使用
ngIf/ngFor导致组件损坏
版本 5.1.5
发布于 2024 年 2 月 13 日
修复
- 粘贴包含零的单元格会创建空单元格
- 复制后粘贴空单元格抛出错误
- 修复通用格式的
setValue()功能 - 在序列化期间保存工作表 id 并通过
afterAction事件返回 - 修复通过界面使用跨工作表公式
- 修复 Ctrl+F 搜索
版本 5.1.4
发布于 2024 年 1 月 31 日
修复
- 跨行/跨列单元格粘贴不正确的问题
版本 5.1.3
发布于 2024 年 1 月 29 日
修复
- "common" 格式下数字值解析不正确的问题
- Spreadsheet 与 Suite 一起使用时的本地化 i18n 问题
- 加载包含大量跨行/跨列单元格的表格时的性能问题
- 跨行/跨列单元格粘贴不正确的问题
版本 5.1.2
发布于 2024 年 1 月 16 日
修复
- 修复复制和粘贴单元格的问题。从 Excel 复制并粘贴到 Spreadsheet 的含日期单元格显示为字符串
- 修复 "common" 格式中被格式化为数字的数字值问题
- 修复解析数据时修改初始数据集的问题
- 修复跨行/跨列单元格粘贴的问题
版本 5.1.1
发布于 2023 年 12 月 14 日
修复
- 修复
fixColumn()方法忽略选择编辑器箭头图标的问题 - 修复单元格样式优先于区域样式的问题
- 修复复制/粘贴含有已应用样式的单元格内容及撤销功能的问题
- 修复粘贴到不同单元格时链接发生变化的问题
- 修复合并单元格的复制/粘贴问题
- 修复样式序列化的问题
- 修复调用
setSelectedCell()或setFocusedCell()方法时滚动到单元格的问题
版本 5.1
发布 于 2023 年 12 月 7 日
新功能
- 支持新主题:深色、浅色高对比度和深色高对比度
- 扩展了数字、日期、时间和货币格式本地化的支持
- 与 Svelte 框架集成
- 支持为导出的 .xlsx 文件提供自定义名称
- 支持在数据集中保存单元格的"锁定"状态和为单元格指定链接
更新
- 更新了与 React、Angular 和 Vue.js 的集成
- 自动将公式中的小写字母转换为大写
- 公式自动闭合
修复
- 修复对单元格中设置的值应用撤销的问题
- 修复粘贴行数的限制
- 修复编辑行中公式中的空格被替换为
符号的问题 - 修复 Excel 导入中日期类值处理不正确的问题
- 修复单元格块编辑不正确的问题
- 修复筛选期间调用
getExcelDate()时出现的脚本错误 - 修复粘贴单元格内容时将文本值转换为数字的问题
- 修复从列宽已修改的 Excel 文件粘贴数据时不正确的问题
版本 5.0.10
发布于 2023 年 11 月 27 日
修复
- 修复类型问题
版本 5.0.9
发布于 2023 年 10 月 24 日
修复
- 修复 setStyle() 方法调用不正确的问题,该方法在 before/afterSelectionSet 事件之前触发
- 修复内容自动换行不正确的问题
- 修复类型问题
版本 5.0.7
发布于 2023 年 9 月 21 日
修复
- 修复将公式导出到 Excel 的问题
- 修复单击撤销按钮时恢复单元格剪切内容的问题
版本 5.0.6
发布于 2023 年 9 月 18 日
修复
- 修复零值渲染的问题
- 修复应用以字符串值设置的颜色样式的问题
- 修复 XSS 漏洞问题
- 修复在非活动工作表中更改值时修改了活动工作表中值的问题
版本 5.0.5
发布于 2023 年 8 月 10 日
修复
- 修复 XSS 漏洞问题
- 修复包含单元格跨行/跨列的数据粘贴不正确的问题
版本 5.0.4
发布于 2023 年 6 月 5 日
修复
- 修复只读模式下块选择或上下文菜单调用时的错误
- 修复只读模式下显示编辑菜单的问题
- 修复数字四舍五入不正确的问题
- 修复合并单元格后编辑行中公式被其结果替换的问题
版本 5.0.3
发布于 2023 年 4 月 26 日
修复
- 修复计算最后一个要合并的单元格时的不正确行为
- 修复 Excel 导入/导出的问题
- 修复应用数据验证后数据被交换的问题
- 修复将含有":"符号的文本解释为链接的问题
- 修复多行数据加载问题。现在可以在
styles对象中设置multiline: "wrap"属性 - 修复当
multiSheets设置为false时 Spreadsheet 初始化时合并单元格的问题 - 修复双击表头列边框后重置列滚动位置的问题
版本 5.0.2
发布于 2023 年 2 月 14 日
修复
- 修复复制并粘贴单元格值后单元格对齐方式未保存的问题
- 修复排序数据后筛选结果发生变化的问题
- 修复时间选择器中 12 小时格式显示的问题
- 修复单元格自动填充后链接样式被移除的问题
- 现在可以为日期添加多个自定义格式
- 现在即使行/列属于受限的列和行,也可以删除
版本 5.0.1
发布于 2023 年 1 月 19 日
修复
- 修复在带货币格式的单元格中输入的值被保存为字符串而非数字的问题
- 修复清除先前搜索单元格选中状态的问题
- 修复将数据解析到电子表格后数据显示的问题
- 修复删除列后网格重绘的问题
- 修复空值排序的问题
- 修复使用下拉列表时数字值验证的问题
- 修复含字母数字值的单元格自动填充
- 改进了数字格式掩码的处理
- 现在所有单元格中的数字值默认右对齐