安装
推荐:聚合包
我们建议安装 radix-ui 包,然后 import 你需要的原语。这是最简单的上手方式,能避免版本冲突或重复,也便于管理更新。
npm install radix-ui
import { Dialog, DropdownMenu, Tooltip } from 'radix-ui';
这个包是可以 tree-shake 的,所以你只会打包你真正用到的组件。
逐个安装
也可以单独安装每一个原语:
npm install @radix-ui/react-dialog
npm install @radix-ui/react-dropdown-menu
npm install @radix-ui/react-tooltip
import * as Dialog from '@radix-ui/react-dialog';
import * as DropdownMenu from '@radix-ui/react-dropdown-menu';
import * as Tooltip from '@radix-ui/react-tooltip';
分开安装时,我们建议把 Radix 的所有包一起更新,以防共享依赖被重复安装、让产物体积变大。
用包管理器
radix-ui 是一个标准的 npm 包,用哪种包管理器都可以:
bun add radix-ui
pnpm add radix-ui
yarn add radix-ui
从源码构建
这个站点仓库使用 Bun 和 bun.lock:
bun install
bun run dev # 本地开发
bun run build # 产出静态站点到 dist/
下面是一个真实的选择器,它同时也是上面两个安装方式的可操作版本:
打开、浏览、选中,整个流程都能用键盘走完。
装上之后会得到什么
聚合包里包含下面这些组件,下面每一格都是可以直接操作的真实组件:
Switch
Toggle
Checkbox
RadioGroup
Progress
Separator
Accordion
内容区域。
ScrollArea
Slider
Popover
Tooltip
Progress
Switch