概述

Radix Primitives 是一套底层 UI 组件库，重点关注无障碍性、可定制性与开发者体验。你可以把它当作设计系统的基础层，也可以按需逐步采用。

它想解决什么

我们中的大多数人对常见 UI 模式——手风琴、复选框、组合框、对话框、下拉菜单、选择器、滑块、文字提示——共享着差不多的定义。这些 UI 模式由 WAI-ARIA 记录在案，社区也普遍理解它们。

问题出在 Web 平台直接提供的实现上。它们要么根本不存在，要么功能不足，要么无法被充分定制。

于是开发者被迫自己造轮子，这是一项极其困难的任务。结果就是：今天 Web 上的大多数组件都谈不上无障碍、性能不佳，而且缺少关键能力。

我们的目标是做一个资金充足的开源组件库，让社区可以用它搭出无障碍的设计系统。

关键的取舍

Radix 不替你做设计决定。它给的是行为，视觉完全交给你：

这个取舍是理解 Radix 的关键。如果你在找一个自带视觉风格的开箱即用组件库，Radix 不是；如果你要的是一套能压进自有设计系统的无障碍行为层，它就是。

下面这个开关是真实的 Radix 组件。按一下空格，看看 aria-checked 怎么变：

常见组件的样子

下面这些都是真的，不是截图：

它有多少东西

radix-ui 聚合包目前导出 33 个稳定组件，合计 161 个公开部件。每个部件都是包真实导出的名字， 由脚本从各包的 export 语句里抽取，而不是从文档里抄的示意。

完整的 33 个组件与它们的全部部件，见组件索引。