首页
/ SmartHR UI v71.0.0 发布:主题系统重构与国际化改进

SmartHR UI v71.0.0 发布:主题系统重构与国际化改进

2025-07-09 04:37:54作者:劳婵绚Shirley

SmartHR UI 是一个企业级 React UI 组件库,专为人力资源管理系统设计,提供了一套完整的、可定制的 UI 组件和设计系统。最新发布的 v71.0.0 版本带来了两项重要变更:主题系统的重大重构和 Button 组件的国际化支持。

主题系统重构

本次更新对主题系统进行了深度清理,移除了大量已标记为废弃(deprecated)的属性和方法,这是 SmartHR UI 向更现代化、更一致的设计系统演进的重要一步。

主要变更点

  1. 默认值重命名

    • defaultPalettedefaultColor
    • defaultFramedefaultBorder
    • defaultSize.sizedefaultSpacing
    • defaultSize.fontdefaultFontSize
    • defaultSize.mediaQuerydefaultBreakpoint
  2. createTheme 方法简化

    • 不再支持直接设置 palette,改用 color
    • 不再支持 frame 设置,改用 border
    • size 配置项被拆分为独立的 spacingfontSizebreakpoint
  3. 字体系统调整

    • 移除了 htmlFontSize 和特定尺寸常量(SHORT/TALL/GRANDE/VENTI)
    • 推荐使用标准字体尺寸值替代
  4. 阴影系统优化

    • 移除了 BASE 和 DIALOG 阴影常量
    • 开发者应从现有的阴影选项中选择合适的替代方案

迁移建议

对于使用 styled-components 的开发者,应确保通过 ThemeProvider 访问主题值,而不是直接引用。对于被移除的属性和方法,应按照上述对应关系进行替换。

Button 组件国际化

v71.0.0 对 Button 组件进行了国际化改造,移除了原有的 decorators 实现方式,改为使用更标准的 intl 方案。这一变更使得 Button 组件能够更好地支持多语言环境,同时也使代码结构更加清晰。

技术影响

这一变更意味着:

  1. 现有的 Button 组件自定义装饰器将不再工作
  2. 国际化文本现在需要通过标准的 intl 机制提供
  3. 组件行为更加可预测,与 React 国际化最佳实践对齐

升级建议

对于正在使用 SmartHR UI 的开发者,升级到 v71.0.0 时需要注意:

  1. 全面检查主题相关的代码,确保没有使用已废弃的属性和方法
  2. 对于 Button 组件,检查是否依赖了旧的装饰器功能
  3. 考虑在 CI 流程中加入主题兼容性检查
  4. 对于大型项目,建议分阶段进行迁移

这次更新体现了 SmartHR UI 向更规范、更国际化方向发展的决心,虽然带来了一些破坏性变更,但从长远来看将提高项目的可维护性和一致性。

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