首页
/ Orbit Components 20.0.0版本发布:专注可访问性与模态框改进

Orbit Components 20.0.0版本发布:专注可访问性与模态框改进

2025-07-02 23:52:55作者:劳婵绚Shirley

Orbit Components是Kiwicom团队开发的一套React组件库,专注于为旅行行业提供高质量的UI组件解决方案。最新发布的20.0.0版本带来了一系列重要的改进,主要集中在可访问性增强和模态框功能的优化上。

主要变更与改进

模态框组件重大重构

本次更新对Modal组件进行了深度重构,使其更符合现代Web可访问性标准:

  1. 强制关闭按钮标签:现在当定义了onClose回调且未显式设置hasCloseButton为false时,labelClose属性变为必填项。这一改变确保了关闭按钮有明确的文本描述,对视障用户更加友好。

  2. 自动焦点管理优化:移除了autoFocus属性,现在模态框会自动将焦点设置到第一个可聚焦元素上。这一行为更符合WAI-ARIA模态框的最佳实践。

  3. 焦点恢复功能:新增了triggerRef属性,允许开发者指定一个引用,在模态框关闭后将焦点恢复到触发元素上,这对键盘用户尤为重要。

  4. ARIA属性支持:新增了ariaLabel、ariaLabelledby和ariaDescribedby属性,让开发者能够更精细地控制模态框的语义化描述。

水平滚动组件可访问性增强

HorizontalScroll组件现在要求为箭头按钮提供aria-label描述(当启用arrows属性时)。这一改变确保了屏幕阅读器用户能够理解这些控制按钮的功能。

此外,滚动区域现在被正确标记为可聚焦,改进了键盘导航体验。

加载状态组件改进

Loading组件新增了asComponent和title属性,允许开发者指定加载指示器的语义化容器元素(默认为div)并提供描述性标题,这对辅助技术用户理解当前状态非常有帮助。

徽章组件清理

移除了Badge组件中未使用的border属性,简化了API。同时为状态徽章添加了正确的ARIA角色,提升了可访问性。

标题组件样式修复

修复了Heading组件中h5和h6标题的文本转换问题,确保样式一致性。

迁移建议

对于正在使用Modal组件的项目,需要注意:

  1. 检查所有Modal实例,确保在需要关闭功能时提供了labelClose属性
  2. 移除不再需要的autoFocus属性
  3. 考虑使用新的triggerRef属性来改善焦点管理

对于HorizontalScroll组件,需要为箭头按钮添加适当的aria-label描述。

本次更新体现了Orbit Components对Web可访问性的持续投入,建议开发者及时升级以获取更好的用户体验和更符合标准的实现。

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