设置

主题设置

先加载组件样式,再选择配色和明暗模式。使用语义 CSS 变量覆盖你需要的部分,让组件继续共享一致的外观。

按顺序导入样式

源码安装在应用样式中依次导入 Tailwind 和生成的样式,再放置你的覆盖。组件包则在应用入口导入一次组件包样式。

src/style.css
src/main.ts

选择一套配色

文档右上角的主题面板提供 11 套配色。选择后复制 CSS,将生成的变量放到项目样式的末尾。配色不会改变组件的尺寸和交互。

src/style.css

切换明暗模式

在根元素使用 dark 类启用深色模式;移除该类恢复浅色模式。首次渲染和客户端水合应使用一致的初始选择。

index.html

覆盖语义变量

优先覆盖 background、foreground、primary、border 等语义变量。将局部覆盖放在容器上,可让其中的组件继承,而不影响页面其他部分。

src/style.css

已有 shadcn-vue 项目

已有 shadcn-vue 项目可复用现有令牌。新项目先完成初始化,再按安装指南导入 orvui 生成的完整样式。

终端

查看完整主题样式

需要完整令牌、动效动画和辅助样式时,查看下方内容或下载theme.css。

globals.css

检查结果与下一步

在明暗模式中检查文字、边框、焦点和禁用状态,再验证窄屏布局。继续阅读动效指南,让主题与交互一起保持一致。