使用高级 Chakra UI 组件更快地构建 💎

了解更多
跳到内容
文档游乐场指南博客
赞助

安装

如何在您的项目中安装和设置 Chakra UI

框架指南

Chakra UI 适用于您喜爱的框架。我们为这些框架编写了分步指南

Next.js

轻松将 Chakra UI 添加到 Next.js 应用

Vite

在 Vite 中使用 Chakra UI

Stackblitz

在 Stackblitz 沙盒中尝试 Chakra UI

所需的最低 Node 版本为 Node.20.x

安装

要在您的项目中手动设置 Chakra UI,请按照以下步骤操作。

1

安装@chakra-ui/react

npm i @chakra-ui/react @emotion/react
2

添加代码片段

代码片段是预构建的组件,可帮助您更快地构建 UI。使用 @chakra-ui/cli 您可以将代码片段添加到您的项目中。

npx @chakra-ui/cli snippet add
3

设置提供者

在应用程序的根目录中,使用 components/ui/provider 组件生成的 Provider 组件包裹您的应用程序。

此提供者包含以下内容

  • 来自 @chakra-ui/reactChakraProvider 用于样式系统
  • 来自 next-themesThemeProvider 用于颜色模式
import { Provider } from "@/components/ui/provider"

function App({ Component, pageProps }) {
  return (
    <Provider>
      <Component {...pageProps} />
    </Provider>
  )
}
4

更新 tsconfig

如果您正在使用 TypeScript,您需要更新 tsconfig 文件中的 compilerOptions 以包含以下选项

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "skipLibCheck": true,
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

如果您正在使用 JavaScript,创建一个 jsconfig.json 文件并将上述代码添加到该文件中。

5

尽情享受!

借助代码片段和 Chakra UI 的原始组件的强大功能,您可以更快地构建 UI。

import { Button, HStack } from "@chakra-ui/react"

const Demo = () => {
  return (
    <HStack>
      <Button>Click me</Button>
      <Button>Click me</Button>
    </HStack>
  )
}

学习

观看我们的官方课程,深入学习数十个视频,这些视频将教您所有关于 Chakra UI 的知识,从基础到高级概念。

贡献

无论您是 Chakra UI 的初学者还是高级用户,加入我们的社区都是与志同道合、使用该库构建优秀产品的人们建立联系的最佳方式。