WijmoJS - V2025.0 Update1 新特性

支持 Next.js 15

Wijmo 增加了对 Next.js 版本 15 的支持！Wijmo 的 React Interop 使您能够在 Next.js 项目中使用 Wijmo 控件。

 

支持 React 中的Cleanup Callbacks

从 React 19 开始，框架支持从 ref 回调函数返回Cleanup函数。Wijmo 现在在所有顶级组件中添加了对这些清理功能的支持。当 Wijmo 组件被处理或销毁时，将调用这些函数，使 Wijmo 组件更符合现代 React 组件架构。

 

FlexGrid 中的空数据消息

为了满足客户请求，我们向 FlexGrid 添加了一个新的 noDataOverlayContent 属性。这允许开发人员指定当网格数据为空时要显示的 HTML 字符串内容。

这是显示空 DataGrid 的一种更用户友好的方式。消息设计和内容可以完全自定义。

此外，还引入了新属性 overlayManager，以允许开发人员对叠加内容进行更多自定义。要使用 overlayManager，您可以通过继承 OverlayManager 类并覆盖所需的方法来定义新类以自定义其功能。

 

FlexGrid 中的三态排序

另一个很棒的客户建议是添加在单击列标题时自定义排序行为的功能。以前，用户只能使用 Ctrl + 单击来删除列的排序。但是，我们根据客户的建议增加了使用三次单击模式：

1. 单击 1 = 升序排序
2. 单击 2 = 降序排序
3. 单击 3 = 删除排序

为了支持这一点（甚至更改顺序），我们引入了 sortOrder 属性。这允许您为 FlexGrid 选择 Sort 行为。

SortOrder 包括以下选项：

• AscDesc （默认）
• DescAsc
• AscDescNone
• DescAscNone

这使开发人员可以选择使用三次单击排序模式，甚至可以确定排序的顺序。

 

FlexGrid、CollectionViewNavigator 和 Glyphs 中的辅助功能改进

此版本对 FlexGrid 的辅助功能进行了一些增强（和修复）。改进了字形以支持高对比度。

请将 npm 引用迁移到 @grapecity-software范围！

提醒一下，我们的新版本现在已经发布到 npm 上的 @grapecity-software 范围。要访问最新的代码，您应该从旧的 @grapecity 范围迁移到新的 @grapecity-software 范围的软件包。

下表包括一些新软件包地址及其旧等效软件包的示例：

新建套餐	旧软件包
@grapecity-software/wijmo	@grapecity/wijmo
@grapecity-software/wijmo.input	@grapecity/wijmo.input
@grapecity-software/wijmo.grid	@grapecity/wijmo.grid

您将需要更新 package.json 引用以及 import 语句。更新应用程序的最佳方法是使用查找和替换工具（如 VSCode 中的工具），查找“@grapecity/”，然后将其替换为“@grapecity-software/”。这将涵盖 package.json 和 import 语句。

弃用通知：我们仍将在一段时间内在旧 @grapecity 范围内发布 Wijmo 的新版本。在此期限之后，我们将停止更新它们，仅将新版本发布到@grapecity-software 范围。因此，我们强烈建议迁移到新的 @grapecity-software 范围。