用途:Chakra UI 是用于 React 的可访问组件库,通过样式属性与模块化设计令牌,快速组合响应式、可主题化的用户界面,常用于可访问 Web 应用、组件驱动样式、暗色模式与主题、Next.js/Vite 单页应用及 v3/Ark UI 基础的设计系统。
主要能力:以令牌化属性构建布局(如 bg、py、px 支持 base/md 响应式与 _dark);提供 Box、Flex、Heading、Text、Button、Stack 等组件;支持自定义主题扩展与语义令牌(createSystem、defaultConfig、defineConfig、extendTheme);提供 Dialog、Field、Input 等可访问表单与对话框,含焦点陷阱与键盘导航。
必要用法:应用根需包裹在 ChakraProvider 中(推荐 <ChakraProvider value={system}>);主题可经 defineConfig 定义 tokens 与 semanticTokens,或用 extendTheme 覆盖颜色与组件默认属性;Dialog 用 Dialog.Root 配合 open/onOpenChange 控制。安装命令与包名等资料未提供。
适用场景:企业设计系统、可访问表单与模态、带暗色模式的多主题界面、现代 Next.js/Vite 单页应用。
限制:需目标 v3/Snippets 架构以减小打包体积并提升服务端组件兼容;自定义组件应使用 shouldForwardProp 防止属性泄漏;不应硬编码颜色值、不应过度嵌套 Box、不应在无可访问替代时禁用焦点环。注意事项:组件须在 Provider 内渲染,暗色模式需在文档 head 添加 ColorModeScript,否则可能出现读取 undefined 或水合失败。