跳到主要内容

更新日志

如果您正在从旧版本升级 Spreadsheet，请查阅迁移到新版本了解详细信息。

版本 6.0.4​

发布于 2026 年 11 月 2 日

新功能​

更新​

  • 键盘导航（请查阅快捷键列表）：
    • 焦点保持在活动单元格上，Tab 和 Shift + Tab 可分别从工作表的最后一个和第一个单元格移出，Ctrl + F6 在菜单、工具栏、工作表和工作表标签之间移动焦点
    • 工具栏、菜单栏和工作表标签均为单一 Tab 停靠点，可使用方向键在其中导航
    • 新增快捷键，例如用于上下文菜单的 Shift + F10，以及用于显示隐藏行和列的 Ctrl (Cmd) + Shift + 9 / Ctrl (Cmd) + Shift + 0
    • 工具栏的颜色和边框弹出窗口在打开时获得焦点，并可通过 Esc 和 Tab 关闭
  • 方向键在第一个和最后一个可见行和列处停止，而不是跳到对侧边缘；在边缘处按方向键会将选中的区域缩小为活动单元格
  • 使用输入法编辑器（IME）输入的文本会显示在活动单元格中，并通过 startEdit() 方法开始编辑，因此会触发 beforeEditStart 和 afterEditStart 事件
  • setFocusedCell() 方法将键盘焦点移动到单元格
  • 单元格中的链接呈现为在新标签页中打开的真实链接，Alt (Option) + Enter 可打开活动单元格的链接
  • 只读模式保留键盘导航、选择、复制和搜索，屏幕阅读器会播报被拒绝的编辑。要关闭选择，请使用 selection: false 选项
  • 通过合并单元格删除行或列时，会删除该合并单元格的所有行或列
  • spreadsheet 语言包中新增界面和屏幕阅读器字符串，并支持内置组件的翻译
  • 用于键盘焦点的 --dhx-spreadsheet-focus-color 变量，以及浅色主题中对比度更高的公式引用颜色

修复​

  • 删除合并单元格之前的行或列时，合并单元格被丢弃而不是被移动的问题。现在只剩一个单元格的合并单元格会变成普通单元格并保留其值
  • 通过合并单元格删除行或列时只删除合并区域中的一行（列）的问题
  • 删除行和列的上下文菜单标签未显示将被删除的合并单元格的所有行或列的问题
  • 行覆盖整个筛选范围时未被删除的问题
  • 删除冻结的行或列时冻结区域没有缩小的问题
  • 拖动的单元格不包含普通数字时自动填充抛出错误的问题
  • 当第一行或最后一行（列）被隐藏时，按 Home、End、Ctrl (Cmd) + Home、Ctrl (Cmd) + End 和 Ctrl (Cmd) + 方向键 页面卡死的问题
  • 将单元格复制到 Excel、从 Excel 粘贴或在 Spreadsheet 内部粘贴时字体大小丢失的问题
  • 无效值提示框出现在远离无效单元格的位置或未显示的问题
  • 使用方向键后，列表编辑器中 Esc 和 Tab 不起作用的问题
  • 搜索先高亮第二个匹配项，且在编辑或切换工作表后未刷新结果的问题
  • 在不支持 WebAssembly 的浏览器中导入或导出时出现脚本错误的问题
  • destructor() 之后遗留文档监听器和内部组件的问题
  • 搜索栏关闭后键盘焦点丢失的问题
  • 已关闭的上下文菜单再次打开的问题
  • 键盘导航时活动单元格滚动到距视口边缘差一个单元格的问题
  • 含无效引用的公式显示残缺或重复的 #REF! 错误，而不是单个 #REF! 的问题

React Spreadsheet​

React Spreadsheet 包含上述所有 Spreadsheet 更新和修复。以下是仅针对 React 封装的变更。

更新​

修复​

  • 因仅初始化属性变化而重新创建 Spreadsheet 后，事件回调和 onStateChange 不触发的问题
  • 卸载时未移除封装组件的事件处理程序的问题
  • 挂载时 loadUrl 的数据被加载两次，以及 Spreadsheet 重新创建后再次覆盖保留数据的问题

版本 6.0.3​

发布于 2026 年 8 月 24 日

修复​

  • 单元格为空时 serialize() 方法丢失自定义列宽和行高的问题
  • 选中的单元格重新进入可视区域时 Chrome 中滚动"跳动"的问题
  • 从 Excel 文件导入数据后部分公式丢失的问题
  • Excel 导出和导入过程中单元格"锁定"状态丢失的问题

版本 6.0.2​

发布于 2026 年 7 月 1 日

修复​

  • 经历"从 Excel 复制 → 粘贴到 Spreadsheet → 导出/导入"流程后，单元格边框丢失的问题
  • 粘贴到最后一行下方的数据无法显示，原因是网格未添加新行来容纳这些数据

版本 6.0​

发布于 2026 年 5 月 20 日

博客中的版本回顾

重大变更​

新版本对 Spreadsheet API 引入了重大变更：部分方法、属性和事件已被标记为废弃。请查阅迁移指南以跟进最新版本。

新功能​

更新​

  • 支持调整单元格内容的字体大小：
  • 公式引擎中新增了条件聚合函数：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 配置属性已被移除

新功能​

修复​

  • 排序问题
  • 筛选器移动到新列的问题
  • 使用 "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 日

博客中的版本回顾

新功能​

更新​

修复​

  • 修复对单元格中设置的值应用撤销的问题
  • 修复粘贴行数的限制
  • 修复编辑行中公式中的空格被替换为   符号的问题
  • 修复 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 日

修复​

  • 修复在带货币格式的单元格中输入的值被保存为字符串而非数字的问题
  • 修复清除先前搜索单元格选中状态的问题
  • 修复将数据解析到电子表格后数据显示的问题
  • 修复删除列后网格重绘的问题
  • 修复空值排序的问题
  • 修复使用下拉列表时数字值验证的问题
  • 修复含字母数字值的单元格自动填充
  • 改进了数字格式掩码的处理
  • 现在所有单元格中的数字值默认右对齐

版本 5.0​

发布于 2022 年 11 月 21 日

博客中的版本回顾

重大变更​

新版本对 toolbarBlocks 属性引入了一些变更。请查阅迁移文章以跟进最新版本。

新功能​

更新​

  • 扩展的本地化选项列表
  • 扩展的快捷键组合列表：
    • 用于数据搜索
      • Ctrl (Cmd) + F
      • Ctrl (Cmd) + G
      • Ctrl (Cmd) + Shift + G
    • 用于选择整列/整行
      • Ctrl (Cmd) + Space
      • Shift + Space
    • 用于将单元格内容左对齐/右对齐/居中对齐
      • Ctrl (Cmd) + Shift + L
      • Ctrl (Cmd) + Shift + R
      • Ctrl (Cmd) + Shift + E
    • 用于为单元格内容添加删除线
      • Alt + Shift + 5 (Cmd + Shift + X)
    • 用于添加新工作表和在工作表之间切换
      • Shift + F11
      • Alt + Arrow Up/ Arrow Down
    • 用于在单元格中插入超链接
      • Ctrl (Cmd) + K

版本 4.3​

发布于 2022 年 5 月 23 日

博客中的版本回顾

重大变更​

版本 4.3 没有引入重大变更，但引入了一种处理电子表格中执行的 actions 的新方式。详情请查阅迁移文章。

新功能​

更新​

  • parse() 方法已更新。单元格对象新增 editor 属性

版本 4.2​

发布于 2021 年 11 月 29 日

博客中的版本回顾

新功能​

更新​

修复​

  • CTRL-X 快捷键问题
  • 在隐藏编辑栏的电子表格中编辑单元格时出现脚本错误的问题

版本 4.1.3​

发布于 2021 年 8 月 31 日

博客中的版本回顾

修复​

  • 修复删除行/列后撤销操作恢复时的不正确行为
  • 修复数字格式对象中"mask"属性的不正确工作
  • 修复从 Excel 粘贴数据到电子表格时选区顶部空单元格/行被截断的问题
  • 修复绝对公式引用的单元格未被标记的问题
  • 修复"afterSelectionSet"事件在选择一个单元格区域后触发两次的问题
  • 修复 TypeScript 定义问题
  • 修复"text"数字格式的问题

版本 4.1.2​

发布于 2021 年 6 月 3 日

博客中的版本回顾

修复​

  • 修复同时对多列应用自动填充时包含数学函数的单元格自动填充不正确的问题
  • 修复使用"Ctrl + 单击"后再次单击同一单元格时，选中单元格未取消选中的问题
  • 修复使用键盘导航选择公式后将数学公式应用于单元格的问题
  • 修复使用"Ctrl + 单击"选择单元格时锁定/解锁单元格的问题
  • 修复"serialize()"方法导致"0"值未被序列化的问题
  • 修复单击表头列边框后列宽自动调整的问题
  • 修复编辑行中零值显示的问题
  • 修复编辑长内容单元格的问题
  • 修复将电子表格导出到 Excel 文件的问题
  • 修复包含大量列的电子表格中水平滚动条不正确行为和列显示的问题
  • 修复在空电子表格中使用键盘导航后出现的脚本错误

版本 4.1.1​

发布于 2021 年 4 月 14 日

博客中的版本回顾

修复​

  • 修复 TypeScript 定义问题
  • 修复绝对引用问题
  • 修复使用".xlsx"扩展名文件加载数据时出现的问题
  • 修复从 Excel 文件复制的数据粘贴不正确的问题
  • 修复对浮点数求和时返回错误结果的问题

版本 4.1​

发布于 2021 年 3 月 24 日

博客中的版本回顾

新功能​

更新​

版本 4.0.5​

发布于 2021 年 2 月 3 日

修复​

  • 修复性能问题
  • 修复用户在单元格中撤销最后一个操作时出现的脚本错误
  • 修复调用析构函数后抛出的脚本错误
  • 修复将单元格区域的值插入单个单元格时被截断的问题
  • 修复单元格剪切后再次粘贴时单元格格式识别的问题

版本 4.0.4​

发布于 2021 年 1 月 12 日

修复​

  • 修复处理超过 2 个数字时"SUM"函数的不正确工作
  • 修复调用"destructor()"后初始化电子表格的问题
  • 修复类型问题

版本 4.0.3​

发布于 2020 年 12 月 28 日

修复​

  • 修复在数据集中为单元格值设置格式的问题
  • 修复将电子表格附加到布局时出现的错误
  • 修复计算结果后无法编辑单元格公式的问题
  • 修复 setFocusedCell() 方法的不正确工作
  • 修复使用公式时焦点的不正确行为
  • 修复使用"ctrl"键选择单元格区域的问题
  • 修复通过"ctrl+点击"向含有公式的单元格添加单元格区域的问题
  • 修复数学函数的不正确工作
  • 修复通过弹出框和鼠标点击选择 SUM() 公式的问题

版本 4.0.2​

发布于 2020 年 12 月 21 日

修复​

  • 修复在页面上创建 2 个或更多电子表格对象时键盘导航的不正确行为
  • 修复 types.d.ts 文件抛出错误的问题
  • 修复复制和粘贴单元格区域的问题

版本 4.0.1​

发布于 2020 年 12 月 2 日

修复​

  • 将鼠标悬停在工具栏的撤销/重做按钮上时工具提示显示不正确
  • 在导入大于电子表格大小的数据后删除最后一列时出现的问题
  • setSelectedCell() 方法的问题，导致选中单元格的公式未在公式栏中显示
  • TypeScript 定义生成不正确
  • 单元格内容对齐的视觉问题
  • 空单元格或零值单元格序列化的问题

版本 4.0​

发布于 2020 年 10 月 19 日

新功能​

修复​

  • 修复对单元格区域应用背景色时颜色选择器的不正确工作
  • 修复导入 Excel 文件时数字解析不正确的问题
  • 修复从 Google 或 Excel 表格复制的所有数据被插入电子表格单个单元格的问题
  • 修复 editLine:false 属性的不正确工作，该属性导致编辑操作在控制台中以错误结束
  • 修复 AfterValueChange 事件被调用两次的问题

版本 3.1.4​

发布于 2019 年 9 月 19 日

修复​

  • 样式修复

版本 3.1.3​

发布于 2019 年 9 月 19 日

修复​

  • Spreadsheet 附加到 Layout 时单元格获取焦点的问题

版本 3.1.2​

发布于 2019 年 3 月 25 日

修复​

  • Excel 导出中文本样式的问题
  • 右对齐文本下划线的问题

版本 3.1.1​

发布于 2019 年 3 月 25 日

修复​

  • 导出到 Excel 的问题

版本 3.1​

发布于 2019 年 3 月 21 日

新功能​

更新​

修复​

  • 活动单元格上快捷键的问题

版本 3.0.3​

发布于 2018 年 12 月 13 日

修复​

  • 自定义只读模式下的不正确行为
  • 删除列/行方法的问题
  • 编辑行焦点丢失的问题
  • 活动单元格上快捷键的问题

版本 3.0.2​

发布于 2018 年 12 月 6 日

修复​

  • 快捷键行为的问题
  • 选择手柄位置的问题
  • 活动单元格焦点丢失的问题
  • 活动单元格上选中行为不正确
  • 活动单元格上快捷键行为不正确
  • 方向键滚动行为不正确

版本 3.0.1​

发布于 2018 年 11 月 8 日

修复​

  • 撤销操作的不正确行为
  • 对一组单元格执行剪切-粘贴操作的不正确行为

版本 3.0​

发布于 2018 年 10 月 25 日

重大变更​

备注

版本 3.0 的 API 与 v2.1 的 API 不兼容。

与之前基于 PHP 的版本相比，版本 3.0 的 DHTMLX Spreadsheet 是一个完全客户端的 JavaScript 组件。

请查阅迁移文章了解新 API 的使用方法。

新功能​

Spreadsheet 的 API 已经过更改，使用起来更加便捷。另一个重要更新是对组件进行了全面重新设计，使 Spreadsheet 界面焕然一新。在全新外观的同时，DHTMLX Spreadsheet 的可用性也得到了大幅提升。

Need more help?Contact Support