首页
/ Elastic UI (EUI) v103.0.0 版本更新解析

Elastic UI (EUI) v103.0.0 版本更新解析

2025-06-10 00:15:02作者:明树来

Elastic UI(简称EUI)是Elastic公司开发的一套开源UI组件库,专为构建复杂的企业级Web应用而设计。它提供了丰富的React组件和设计系统,帮助开发者快速构建符合Elastic设计语言的用户界面。本次v103.0.0版本带来了一系列视觉优化、新功能增强和重要变更。

核心视觉优化

本次更新对多个组件的视觉表现进行了精细调整,体现了设计系统的一致性原则:

  1. 文本样式统一化:移除了EuiText中h6标题的大写样式,使其与EuiTitle保持一致。同时对EuiListGroupItem的小尺寸(xs和s)字体粗细进行了调整,确保视觉层级的一致性。

  2. 按钮组件优化:EuiFilterButton和EuiButtonGroupButton的默认字体粗细调整为450,这一细微变化提升了按钮的可读性和视觉平衡。

  3. 导航组件改进:修复了EuiCollabsibleNavItem选中状态不可见的问题,增强了导航的可用性。同时优化了EuiHeaderSectionItemButton中通知的视觉定位。

图标系统更新

图标系统迎来了两项重要变更:

  1. 原有的"questionInCircle"图标被简化为"question",新版本推荐使用更简洁的命名方式。虽然旧名称仍可向后兼容,但建议开发者逐步迁移到新命名。

  2. 新增了"info"图标,为开发者提供了更多选择。同时"iInCircle"图标被重命名为更直观的"icon"。

色彩系统增强

本次更新显著扩展了EUI的色彩能力:

  1. 新增调色板函数:引入了三组新的调色板函数及其对应的React Hook:

    • 天蓝色调色板(euiPaletteSkyBlue/useEuiPaletteSkyBlue)
    • 黄色调色板(euiPaletteYellow/useEuiPaletteYellow)
    • 橙色调色板(euiPaletteOrange/useEuiPaletteOrange)
  2. 新增可视化颜色token:增加了多个新的可视化颜色token,包括:

    • 中性色(euiColorVisNeutral0/1)
    • 警告色(euiColorVisWarning1)
    • 风险色(euiColorVisRisk0/1)
  3. 重要token变更:需要注意两个token的重命名:

    • euiColorVisNeutral0 → euiColorVisBase0
    • euiColorVisWarning0 → euiColorVisWarning1

开发者需要特别注意这些token变更,虽然旧token仍然可用,但其颜色值已经改变。如果不更新到新token,界面可能会出现意料之外的颜色表现。

功能增强与修复

  1. EuiFilterButton改进:numActiveFilters属性现在支持百分比值,为数据展示提供了更多灵活性。

  2. EuiResizableCollapseButton优化:改用空按钮实现,提升了组件的可访问性和一致性。

  3. EuiMarkdownFormat修复:解决了未注册代码块语言的处理问题,增强了Markdown解析的健壮性。

升级建议

对于正在使用EUI的开发团队,建议重点关注以下升级事项:

  1. 检查项目中是否使用了被重命名的颜色token,及时更新为新名称以保证视觉效果一致。

  2. 逐步将图标引用从旧命名迁移到新命名,为未来的完全移除做准备。

  3. 利用新增的调色板函数丰富数据可视化表现。

  4. 测试导航组件和按钮组件的视觉变化是否影响现有界面布局。

本次更新虽然包含了一些破坏性变更,但整体上保持了良好的向后兼容性。通过合理的规划和测试,开发者可以平滑地过渡到新版本,同时享受更完善的UI组件体验。

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