Orbit组件库19.0.0-alpha.0版本发布:全面清理废弃API与增强无障碍支持
2025-07-02 17:18:47作者:沈韬淼Beryl
Orbit组件库是Kiwicom团队开发的一套React UI组件系统,专注于为旅行行业应用提供高质量的交互界面。本次发布的19.0.0-alpha.0版本是一个重要的预发布版本,主要围绕两个核心方向进行了重大改进:全面清理废弃的API接口和显著增强组件的无障碍访问能力。
废弃API清理与现代化改造
在长期迭代过程中,组件库积累了一些不再推荐使用的API接口。19.0.0版本对这些内容进行了系统性清理:
-
Box组件移除了多个废弃属性值:
- 移除了过时的borderRadius值,统一使用现代命名规范
- 清理了旧版elevation值,确保阴影效果的一致性
- 移除了不推荐的spacing值,简化间距系统
-
布局组件统一了间距系统:
- Stack、Inline、HorizontalScroll等布局组件都移除了旧的spacing值
- Separator组件不再支持过时的sideOffset值
- LinkList组件也同步更新了间距系统
-
工具函数优化:
- 彻底移除了已废弃的left和right工具函数
- 重命名了媒体查询中的断点token,新命名更加简洁直观
这些改动虽然带来了breaking changes,但显著提升了API的一致性和可维护性,为未来的发展奠定了更坚实的基础。
无障碍访问能力增强
新版本在多处改进了组件的无障碍支持:
-
InputGroup组件现在会正确地将label属性作为aria-label传递给子组件,确保屏幕阅读器能够准确识别表单控件的用途。
-
CountryFlag组件新增了role属性,允许开发者根据具体场景定制国家标志元素的ARIA角色,满足不同的无障碍需求。
-
表单组件增强:
- InputField新增了ariaLabel属性,为输入框提供更精确的无障碍标签
- Select组件同样新增了ariaLabel属性,改善下拉选择器的可访问性
-
ErrorFormTooltip组件移除了无效的inputSize属性,简化了API的同时也避免了可能产生的无障碍问题。
图标系统更新
图标库迎来了重要更新:
- 对现有图标进行了全面更新,确保与设计系统中的最新版本保持一致
- 将UserSingle图标重命名为UserSingleLight,虽然视觉上没有变化,但命名更加准确
其他重要改进
- Separator组件修复了在flex容器中宽度可能坍缩为0的问题,确保分隔线在各种布局环境下都能正常显示
- 移除了InputGroup组件中无效的size属性,简化了组件API
升级建议
19.0.0-alpha.0作为预发布版本,主要面向早期采用者和需要进行兼容性测试的团队。升级时需要注意:
- 全面检查项目中是否使用了被移除的废弃API
- 特别关注布局相关的spacing值变更
- 考虑是否需要为表单组件添加新的无障碍属性
- 更新图标引用,特别是UserSingle图标需要更名为UserSingleLight
这次更新虽然包含了一些破坏性变更,但将显著提升代码质量和无障碍支持水平,建议开发团队尽早开始兼容性评估和升级准备工作。
登录后查看全文
热门项目推荐
相关项目推荐
kernelopenEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。C0115
let_datasetLET数据集 基于全尺寸人形机器人 Kuavo 4 Pro 采集,涵盖多场景、多类型操作的真实世界多任务数据。面向机器人操作、移动与交互任务,支持真实环境下的可扩展机器人学习00
mindquantumMindQuantum is a general software library supporting the development of applications for quantum computation.Python059
PaddleOCR-VLPaddleOCR-VL 是一款顶尖且资源高效的文档解析专用模型。其核心组件为 PaddleOCR-VL-0.9B,这是一款精简却功能强大的视觉语言模型(VLM)。该模型融合了 NaViT 风格的动态分辨率视觉编码器与 ERNIE-4.5-0.3B 语言模型,可实现精准的元素识别。Python00
GLM-4.7-FlashGLM-4.7-Flash 是一款 30B-A3B MoE 模型。作为 30B 级别中的佼佼者,GLM-4.7-Flash 为追求性能与效率平衡的轻量化部署提供了全新选择。Jinja00
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
490
3.61 K
Ascend Extension for PyTorch
Python
299
331
暂无简介
Dart
739
177
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
274
115
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
865
468
仓颉编译器源码及 cjdb 调试工具。
C++
149
880
React Native鸿蒙化仓库
JavaScript
297
344
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
65
20
Dora SSR 是一款跨平台的游戏引擎,提供前沿或是具有探索性的游戏开发功能。它内置了Web IDE,提供了可以轻轻松松通过浏览器访问的快捷游戏开发环境,特别适合于在新兴市场如国产游戏掌机和其它移动电子设备上直接进行游戏开发和编程学习。
C++
52
7