常见问题
有关运行注册表的常见问题。
常见问题
¥Frequently asked questions
复杂组件是什么样的？
¥What does a complex component look like?
以下是安装页面、两个组件、一个钩子、一个格式日期实用程序和一个配置文件的复杂组件的示例。
¥Here's an example of a complex component that installs a page, two components, a hook, a format-date utils and a config file.
{
"$schema": "https://shadcn.nodejs.cn/schema/registry-item.json",
"name": "hello-world",
"title": "Hello World",
"type": "registry:block",
"description": "A complex hello world component",
"files": [
{
"path": "registry/hello-world/page.tsx",
"type": "registry:page",
"target": "app/hello/page.tsx"
},
{
"path": "registry/hello-world/components/hello-world.tsx",
"type": "registry:component"
},
{
"path": "registry/hello-world/components/formatted-message.tsx",
"type": "registry:component"
},
{
"path": "registry/hello-world/hooks/use-hello.ts",
"type": "registry:hook"
},
{
"path": "registry/hello-world/lib/format-date.ts",
"type": "registry:utils"
},
{
"path": "registry/hello-world/hello.config.ts",
"type": "registry:file",
"target": "~/hello.config.ts"
}
]
}如何添加新的 Tailwind 颜色？
¥How do I add a new Tailwind color?
要添加新颜色，你需要将其添加到 cssVars 和 tailwind.config.theme.extend.colors。
¥To add a new color you need to add it to cssVars and tailwind.config.theme.extend.colors.
{
"$schema": "https://shadcn.nodejs.cn/schema/registry-item.json",
"name": "hello-world",
"title": "Hello World",
"type": "registry:block",
"description": "A complex hello world component",
"files": [
// ...
],
"cssVars": {
"light": {
"brand-background": "20 14.3% 4.1%",
"brand-accent": "20 14.3% 4.1%"
},
"dark": {
"brand-background": "20 14.3% 4.1%",
"brand-accent": "20 14.3% 4.1%"
}
},
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"brand": {
"DEFAULT": "hsl(var(--brand-background))",
"accent": "hsl(var(--brand-accent))"
}
}
}
}
}
}
}CLI 将更新项目 CSS 文件和 tailwind.config.js 文件。更新后，新颜色将可用作实用程序类：bg-brand 和 text-brand-accent。
¥The CLI will update the project CSS file and tailwind.config.js file. Once updated, the new colors will be available to be used as utility classes: bg-brand and text-brand-accent.
如何添加 Tailwind 动画？
¥How do I add a Tailwind animation?
要添加新动画，请将其添加到 tailwind.config.theme.extend.animation 和 tailwind.config.theme.extend.keyframes。
¥To add a new animation you add it to tailwind.config.theme.extend.animation and tailwind.config.theme.extend.keyframes.
{
"$schema": "https://shadcn.nodejs.cn/schema/registry-item.json",
"name": "hello-world",
"title": "Hello World",
"type": "registry:block",
"description": "A complex hello world component",
"files": [
// ...
],
"tailwind": {
"config": {
"theme": {
"extend": {
"keyframes": {
"wiggle": {
"0%, 100%": { "transform": "rotate(-3deg)" },
"50%": { "transform": "rotate(3deg)" }
}
},
"animation": {
"wiggle": "wiggle 1s ease-in-out infinite"
}
}
}
}
}
}