首页
/ SmartHR UI 70.0.0版本发布:组件优化与无障碍改进

SmartHR UI 70.0.0版本发布:组件优化与无障碍改进

2025-07-09 07:51:01作者:董灵辛Dennis

SmartHR UI是一个面向企业级应用的React组件库,专注于提供高效、易用的用户界面解决方案。本次发布的70.0.0版本带来了一系列重要的改进和优化,主要集中在组件API的简化和无障碍体验的提升上。

主要变更与优化

1. 组件API简化与规范化

本次版本对多个组件的API进行了简化和规范化处理,移除了部分冗余属性,使API设计更加一致和简洁:

  • Button组件:移除了square属性,简化了按钮的形状控制方式,减少了API的复杂度。
  • SegmentedControl组件:同样移除了isSquare选项,使组件API更加精简。
  • SideNav组件:将isSelected属性重命名为更直观的current,提高了代码的可读性和一致性。

这些变更虽然属于破坏性变更,但有助于长期维护更简洁、一致的API设计。开发者需要检查项目中这些组件的使用情况并进行相应调整。

2. 无障碍体验改进

SmartHR UI团队持续关注无障碍体验,本次版本包含了多项相关改进:

  • DropdownMenuButton:现在会根据菜单的开闭状态自动切换屏幕阅读器专用的不可见文本,为视障用户提供更清晰的界面状态反馈。
  • VisuallyHiddenText:调整了样式,解决了屏幕阅读器读取内容时可能导致页面意外滚动的问题,提升了用户体验。
  • DropdownMenuGroup:修复了键盘导航问题,现在使用键盘可以更顺畅地在菜单组间移动。

这些改进使得组件库对辅助技术的支持更加完善,符合WCAG标准,确保所有用户都能获得良好的使用体验。

3. 功能增强与问题修复

  • AppNaviDropdownMenuButton:新增了onOpenonClose回调函数,为开发者提供了更多控制菜单行为的可能性。
  • FormControl和Fieldset:修复了当指定statusLabels属性时出现的缺少key警告问题。
  • SideMenuGroup和SideMenuItem:恢复了v69版本中意外未导出的这两个组件,确保向后兼容性。

升级建议

对于正在使用SmartHR UI的项目,升级到70.0.0版本时需要注意以下几点:

  1. 检查项目中是否使用了被移除的squareisSquare属性,并移除相关代码。
  2. 将SideNav组件中的isSelected属性更新为current
  3. 测试应用中涉及键盘导航和无障碍功能的部分,确保升级后仍能正常工作。
  4. 考虑利用新添加的onOpen/onClose回调函数来增强导航菜单的行为控制。

本次版本虽然包含了一些破坏性变更,但这些变更是为了长期维护更简洁、一致的API设计。团队建议开发者尽早升级,以获得更好的组件稳定性和无障碍支持。

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