沙德网

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

当前的项目背景

上面的 JSON 包含项目配置和已安装的组件。使用 npx shadcn@latest docs <component> 获取任何组件的文档和示例 URL。

原则

首先使用现有的组件。在编写自定义 UI 之前使用 npx shadcn@latest search 检查注册表。还要检查社区注册表。创作,而不是重新发明。设置页面=选项卡+卡片+表单控件。仪表板 = 侧边栏 + 卡片 + 图表 + 表格。在自定义样式之前使用内置变体。 variant="outline"、size="sm"等。使用语义颜色。 bg-primary、text-muted-foreground — 绝不是像 bg-blue-500 这样的原始值。

关键规则

这些规则始终得到执行。每个链接都指向一个包含不正确/正确代码对的文件。

样式和 Tailwind → styling.md

className 用于布局,而不是样式。切勿覆盖组件颜色或版式。没有space-x-*或space-y-*。将flex与gap-*一起使用。对于垂直堆叠,flex flex-col gap-*。当宽度和高度相等时使用size-*。 size-10不是w-10 h-10。使用truncate简写。不是overflow-hidden text-ellipsis whitespace-nowrap。没有手动dark:颜色覆盖。使用语义标记(bg-background、text-muted-foreground)。

表单和输入 → forms.md

表格使用FieldGroup + Field。切勿将原始 div 与 space-y-* 或 grid gap-* 一起使用进行表单布局。 InputGroup 使用InputGroupInput/InputGroupTextarea。切勿在InputGroup内生Input/Textarea。输入内的按钮使用 InputGroup + InputGroupAddon。选项集(2-7 个选项)使用ToggleGroup。不要在手动活动状态下循环Button。 FieldSet + FieldLegend 用于对相关复选框/单选进行分组。不要使用带标题的div。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@remeda · MIT
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Bun
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 shadcn.preview
npx shadcn@latest docs button dialog select

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。