概览

现代 Web 应用建立在可重用的 UI 组件之上，我们设计、构建和共享这些组件的方式至关重要。本规范旨在为构建面向现代 Web 的开源 UI 组件确立一个正式的、开放的标准。

它由 Hayden Bleasel 和 shadcn 共同撰写，并有来自开源社区的贡献，同时参考了 React 生态中流行项目的实践。

目标是帮助开源维护者和资深前端工程师创建可组合、可访问且易于跨项目采用的组件。

这个规范是什么？

本规范不是关于 React 的教程或课程，也不是对任何特定组件库或注册表的推广。相反，它提供了用于设计 UI 组件的高层次指南、最佳实践和通用术语。

遵循本规范，开发者可以确保其组件符合现代期望，并能够顺利集成到任意代码库中。

这适用于谁？

本规范面向构建和分发组件库或设计系统的开源维护者和有经验的前端工程师。我们假定你熟悉 JavaScript/TypeScript 和 React。

为具体说明，所有示例将使用 React（带 JSX/TSX），但我们希望这些基本概念同样适用于 Vue、Svelte 或 Angular 等其他框架。

换句话说，我们希望本规范的理念是与框架无关的——无论你使用 React 还是其他库构建，都应强调相同的组合性、可访问性和可维护性原则。