@chakra-ui/panda-preset

中文文档
3.38.0发布于 2026/11/03MITTypeScriptESM + CJS近 30 天下载 2573

Chakra UI的熊猫预设

中文使用文档
文档目录5 节
  1. 安装
  2. 配置熊猫
  3. 颜色模式( 浅/ 暗)
  4. 下一个.js和 next-themes
  5. 相关

@chakra-ui/熊猫预设

熊猫 CSS 预设的镜像 查克拉乌伊 默认主题( kens, 语义) 颜色、食谱、档位食谱和全局风格),这样你就可以用 熊猫 同时保留了Chakra相通的设计符号.

安装

pnpm add @chakra-ui/panda-preset
# or
npm install @chakra-ui/panda-preset

同行期望: @pandacss/dev (和您的应用程序的回放/ Vite/ 下一步设置为 熊猫的老样子.

配置熊猫

panda.config.ts (或 .js:

import { defineConfig } from "@pandacss/dev"

export default defineConfig({
  presets: ["@chakra-ui/panda-preset"],
  preflight: true,
  include: ["./src/**/*.{js,jsx,ts,tsx}"],
  outdir: "styled-system", // default; change if you prefer another folder
})

然后生成运行时间 :

pnpm exec panda codegen

在您的应用程序中, 导入 CSS 层 Panda 发送( 例如生成) styled-system/styles.css 或您自己的条目,符合熊猫的地层设置) 和使用情况 css(), (中文(简体) ), 食谱,以及 模式 从你的 outdir 和任何其他一样 熊猫计划.

颜色模式( 浅/ 暗)

此预设用途中的语义符号 _light 财务报告和审定财务报表 _dark (例如颜色, (原始内容存档于2013-10-12). shadows. 要正确应用这些值,文档根应带有 类 选择活动颜色模式:

  • 设定 class="light" 或者说 class="dark" 打开 <html> (或另一个) 组合元素的设置用途).

示例

<html class="light">
  <!-- ... -->
</html>

没有其中一类,轻/暗依赖的符号可能无法解决 以你所期待的方式.

下一个.js和 next-themes

与 下一个主题,使用时 attribute="class" 因此活动主题被反映为 light 编号 : dark 打开 <html>,匹配熊猫 _light 编号 : _dark 语义符号. defaultTheme 编号 : enableSystem 取决于您的产品默认值.

// e.g. app/providers.tsx — mark as a Client Component in the App Router
"use client"

import { ThemeProvider } from "next-themes"

export function Providers({ children }: { children: React.ReactNode }) {
  return (
    <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
      {children}
    </ThemeProvider>
  )
}
// e.g. app/layout.tsx — wrap the app; suppressHydrationWarning avoids a class mismatch warning on <html>
import { Providers } from "./providers"

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" suppressHydrationWarning>
      <body>
        <Providers>{children}</Providers>
      </body>
    </html>
  )
}

安装 : pnpm add next-themes。 。 。 .

版本与发布记录

@chakra-ui/panda-preset 共发布 54 个版本,首次发布于 2025/01/10;过去 12 个月发布了 10 个版本。

版本发布日期距今
3.38.0latest2026/11/035 天前
3.37.02026/08/282 个月前
3.36.12026/07/193 个月前
3.36.02026/06/104 个月前
3.35.02026/04/236 个月前
3.34.02026/03/038 个月前

关于 @chakra-ui/panda-preset 的常见问题

@chakra-ui/panda-preset 是什么?

Chakra UI的熊猫预设

如何安装 @chakra-ui/panda-preset?

在项目目录运行 npm install @chakra-ui/panda-preset,或使用 pnpm add / yarn add / bun add。

@chakra-ui/panda-preset 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chakra-ui/panda-preset 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@chakra-ui/panda-preset 可以商用吗?

@chakra-ui/panda-preset 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chakra-ui/panda-preset 的下载量有多少?

根据 npm 官方下载统计,@chakra-ui/panda-preset 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,573 次,日均约 86 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chakra-ui/panda-preset 还在维护吗?

最新版本 3.38.0 发布于 2026/11/03(5 天前);至今共发布 54 个版本,其中过去 12 个月发布了 10 个;首次发布于 2025/01/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。