首页
/ SmartHR UI v65.0.0 版本发布:表单控件优化与重要类型修正

SmartHR UI v65.0.0 版本发布:表单控件优化与重要类型修正

2025-07-09 01:49:09作者:邬祺芯Juliet

SmartHR UI 是一个面向企业级应用的 React 组件库,专注于提供高效、易用的用户界面组件。本次发布的 v65.0.0 版本带来了几项重要的改进和修复,主要涉及表单控件和布局组件的优化。

主要变更内容

FloatArea 组件类型修正

本次版本对 FloatArea 组件的 responseMessage 属性类型进行了重要调整。这个变更属于破坏性变更(breaking change),意味着如果项目中直接使用了这个属性的类型定义,可能需要相应调整代码。

FloatArea 是一个常用于表单底部固定区域的组件,通常包含操作按钮和状态提示信息。类型修正确保了组件属性类型与实际实现保持一致,提高了代码的类型安全性。

表单控件的无障碍改进

针对 FormControl 和 Fieldset 组件,修复了当使用 dangerouslyTitleHidden 属性时,测试工具无法正确识别和操作这些组件的问题。这个改进特别重要,因为:

  1. 确保了测试覆盖率不会因为这些隐藏标题的表单控件而降低
  2. 保持了组件的可测试性,即使标题被隐藏
  3. 不影响原有的视觉隐藏效果,只是改进了 DOM 结构

Textarea 自动高度调整优化

Textarea 组件在 autoResize 模式下现在能够正确处理初始值(valuedefaultValue)的高度计算。这意味着:

  • 当 Textarea 初始化时就包含内容时,高度会自动调整以适应内容
  • 解决了之前需要手动触发或内容变化后才会调整高度的问题
  • 提升了表单初始化时的用户体验

AppHeader 组件重构

AppHeader 组件内部现在使用 AppNavi 组件实现,这一内部重构带来了:

  • 更一致的导航体验
  • 减少重复代码
  • 更好的可维护性

虽然这是一个内部实现变化,但对外部 API 保持兼容,不会影响现有使用方式。

升级建议

对于使用 SmartHR UI 的项目,升级到 v65.0.0 时需要注意:

  1. 如果项目中直接使用了 FloatArea 的 responseMessage 类型定义,需要检查并调整相关代码
  2. 对于测试用例,特别是针对 FormControl 和 Fieldset 的测试,可以简化部分测试代码
  3. Textarea 的自动高度调整行为更加可靠,可以减少相关的手动调整代码

这些改进共同提升了 SmartHR UI 的表单处理能力和类型安全性,使开发者能够构建更稳定、更易用的企业级应用界面。

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