Repolode
提交项目
radix-ui

radix-ui/primitives

一套开源的无样式、注重无障碍的 React UI 基础组件，用于构建设计系统和 Web 应用。

在 GitHub 查看官网
Star
19,415
Fork
1,277
未关闭 Issue
240
最近提交
7天前

这是什么？

Radix Primitives 是一个面向 React 的底层 UI 组件库，重点关注无障碍、可定制性和开发体验。它提供对话框、弹出层、菜单、标签页、表单控件等基础组件，并处理焦点管理、键盘导航等复杂交互。

这些组件可以作为设计系统的基础层使用，开发者可以自行设计样式。也可以逐步引入到现有项目中，无需一次性替换整个界面。

项目采用 TypeScript 单仓库结构，使用 pnpm 管理依赖。文档、更新日志和贡献指南均在官网和仓库中提供。

核心功能

  • 01组件内置焦点管理和键盘导航等无障碍支持。
  • 02不带默认样式，视觉设计可以完全自定义。
  • 03可以与现有 React 项目逐步集成。
  • 04使用 TypeScript 编写，适合 React 项目。

适用场景

  • 在无障碍基础组件之上构建自定义设计系统。
  • 为 React Web 应用添加对话框、菜单或弹出层，无需从零实现焦点逻辑。
  • 逐步升级现有 React 应用的 UI 层。

快速上手

  1. 1

    全局安装 pnpm

    npm install -g pnpm
  2. 2

    安装项目依赖

    pnpm install

使用前须知

  • README 仅说明了参与该仓库开发的安装步骤；单个包的使用方法需参见外部文档站。

标签

#react#ui-components#accessibility#design-system#typescript#headless-ui#colors#component-library#design-systems#radix-ui

常见问题

primitives 是什么？
一套开源的无样式、注重无障碍的 React UI 基础组件，用于构建设计系统和 Web 应用。 Radix Primitives 是一个面向 React 的底层 UI 组件库，重点关注无障碍、可定制性和开发体验。它提供对话框、弹出层、菜单、标签页、表单控件等基础组件，并处理焦点管理、键盘导航等复杂交互。
primitives 可以免费使用吗？用的什么许可证？
primitives 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
primitives 还在维护吗？
活跃维护中。primitives 最近一次提交是在 2026年10月14日。
primitives 适合用来做什么？
在无障碍基础组件之上构建自定义设计系统。 为 React Web 应用添加对话框、菜单或弹出层，无需从零实现焦点逻辑。 逐步升级现有 React 应用的 UI 层。
primitives 怎么安装和运行？
全局安装 pnpm: npm install -g pnpm 安装项目依赖: pnpm install
在哪里获取 primitives？
源代码和安装说明在 GitHub 上：https://github.com/radix-ui/primitives

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目