首页
/ SmartHR UI v70.2.0 版本发布:文件输入增强与SSR优化

SmartHR UI v70.2.0 版本发布:文件输入增强与SSR优化

2025-07-09 20:16:20作者:董灵辛Dennis

SmartHR UI 是一个现代化的企业级 React UI 组件库,专为人力资源管理系统设计。它提供了丰富的预构建组件,帮助开发者快速构建符合企业标准的用户界面。本次发布的 v70.2.0 版本主要带来了文件输入组件的功能增强和服务端渲染(SSR)场景下的多项优化。

文件输入组件(InputFile)功能增强

在本次更新中,InputFile 组件获得了重要的功能升级,现在支持添加多个文件并实现多选功能。这一改进显著提升了文件上传场景下的用户体验。

技术实现细节

新的多文件选择功能通过以下方式实现:

  1. 组件内部状态管理升级,现在能够跟踪和维护多个文件对象
  2. 文件选择对话框现在支持标准的操作系统级多选操作(通过按住Ctrl或Shift键)
  3. 新增了文件列表展示区域,用户可以清晰地看到已选择的所有文件
  4. 提供了逐个移除文件的交互控制

这一改进特别适合需要批量上传文档的人力资源场景,如员工入职时的多份证明文件上传,或绩效考核时的多份材料提交。

SSR(服务端渲染)优化

本次版本针对服务端渲染场景进行了多项重要优化:

AppHeader 显示模式优化

AppHeader 组件现在能够更智能地在SSR环境下确定其显示模式。通过改进的渲染逻辑,组件能够:

  • 在服务器端准确预判显示模式
  • 避免客户端渲染时的闪烁问题
  • 保持与客户端渲染的一致性

这一优化确保了在Next.js等SSR框架中使用时的稳定表现。

无障碍访问改进

AppNavi 组件进行了重要的无障碍访问改进。考虑到该组件通常出现在页面顶部且位于h1标题之前,传统的heading level结构会导致语义层级混乱。新版本采用aria-labelledby属性来更准确地表达导航结构,确保:

  • 屏幕阅读器用户能够正确理解导航结构
  • 不破坏页面的语义层级
  • 保持与WCAG标准的兼容性

国际化与构建优化

本次发布还包含以下重要改进:

  1. 现在正确导出locales文件,方便国际化应用的开发
  2. 修复了"process is not defined"错误,提升了在特定构建环境下的兼容性
  3. 优化了构建输出,减少了不必要的依赖

升级建议

对于正在使用SmartHR UI的开发团队,建议:

  1. 需要多文件上传功能的场景应立即升级以利用新的InputFile功能
  2. 使用SSR架构的项目可以受益于显示模式和无障碍访问的改进
  3. 国际化项目现在可以更方便地使用内置的本地化资源

本次更新保持了向后兼容性,升级过程应该是平滑的。不过,如果项目中直接依赖了某些内部实现细节,建议在升级后进行充分的测试。

登录后查看全文
热门项目推荐