2026年1月 - Base UI 文档

我们已发布了 Base UI 组件的完整文档。

今年12月我们推出了 npx shadcn create，新增了选择 Radix 或 Base UI 作为组件库的功能。今天，我们为所有 Base UI 组件发布了完整的文档。

新特性

• 完整的 Base UI 文档 —— 每个组件现在都有针对 Base UI 的专门文档，涵盖用法、属性和示例。
• 重建示例 —— 所有组件示例都为 Radix 和 Base UI 重新构建。可切换查看两者在实现上的差异。
• 并列对比 —— 文档方便地对比两个库中组件的工作方式。

相同抽象，不同原语

目标不变：无论选用哪个原语库，都提供一致的 API。组件外观和行为相同，唯独底层实现不同。

Copy// 无论使用 Radix 还是 Base UI，工作方式都相同。
import { Dialog, DialogContent, DialogTrigger } from "@/components/ui/dialog"

如果你正在启动新项目，运行 npx shadcn create 并选择你偏好的库，CLI 会完成剩余工作。