2026-01-31 00:00:46 +08:00
|
|
|
|
# 组件库
|
|
|
|
|
|
|
|
|
|
|
|
## 必要前提
|
|
|
|
|
|
|
|
|
|
|
|
您必须熟悉 [tailwindcss](https://tailwindcss.com/) 的常见用法，这在 hucky 中基本上是不可或缺的。我们选用的是 v4.1 版本，请不要再研究其他旧版本。
|
|
|
|
|
|
|
|
|
|
|
|
## 首选
|
|
|
|
|
|
|
|
|
|
|
|
我们首选 tailwindcss 非常适配的 [daisyui](https://daisyui.com/) 作为我们的主要组件库，这个组件库通过配置 class 为普通的元素添加功能，同时通过 theme 规范主题样式。
|
|
|
|
|
|
|
|
|
|
|
|
当然我们也提供了目前前端最主流的组件库 [shadcn-vue](https://www.shadcn-vue.com/) 在项目中支持，这个组件库同样和 tailwindcss 紧密关联，通过将组件代码直接呈现在项目中，同时适配了 Vue 的组件化开发，您可以深入调整组件细节的同时拥有方便的组件调用。
|
|
|
|
|
|
|
|
|
|
|
|
考虑到国内环境，我们也提供了 [element-plus](https://element-plus.org/) 作为备用组件库，您可以根据项目需求选择使用。
|
|
|
|
|
|
|
|
|
|
|
|
:::tip 提示
|
|
|
|
|
|
我们最不推荐您使用 element-plus，其难以调节的组件样式和重复化的审美使得在现代前端市场中被视为过时技术，尽管这可能是您的熟悉的组件库，我们仍然强烈推荐您学习 tailwindcss 相关的组件库。
|
|
|
|
|
|
:::
|
|
|
|
|
|
|
|
|
|
|
|
## 主题
|
|
|
|
|
|
|
|
|
|
|
|
我们使用 daisyui 内置的 35 种主题，可以通过 `hooks/globalThemeHook` 中的方法来切换主题，我们也封装了 `components/button/ChangeThemeDropdownButton.vue` 下拉框按钮组件来方便切换主题。
|
|
|
|
|
|
|
2026-01-31 00:08:52 +08:00
|
|
|
|
如果您需要自定义主题，请查询 [daisyui 主题文档](https://daisyui.com/docs/themes/)，Hucky 规定仅使用这种方式自定义主题。
|
|
|
|
|
|
|
|
|
|
|
|
当您需要调整的是某个具体的组件样式时，请优先使用 tailwindcss 深入组件内部进行覆盖调整，而不是全局调整 css 变量的值。
|
|
|
|
|
|
|
2026-01-31 00:00:46 +08:00
|
|
|
|
## 关于 Shadcn
|
|
|
|
|
|
|
2026-01-31 02:54:00 +08:00
|
|
|
|
:::warning 警告
|
|
|
|
|
|
Shadcn 组件的样式将会被 Daisy-ui 组件样式所覆盖。阅读以下文档进行调整。
|
|
|
|
|
|
:::
|
|
|
|
|
|
|
2026-01-31 00:00:46 +08:00
|
|
|
|
`components/ui` 目录下是 shadcn-vue 提供的组件代码，您可以在项目中直接调用这些组件，同时也可以根据需要进行调整。
|
2026-01-31 02:54:00 +08:00
|
|
|
|
|
|
|
|
|
|
由于 daisy-ui 和 shadcn 同时使用类似 --color-primary 的 css 变量来调整主题样式，Hucky 删除了 shadcn 在全局样式上做的调整，如果您需要调整 shadcn 中的组件样式，请通过在组件内部的 style 标签中设置 css 变量来实现。
|
|
|
|
|
|
|
|
|
|
|
|
:::tip 提示
|
|
|
|
|
|
尽管 shadcn 组件的样式确实可以调整，但仅建议对 css 掌握度较高的开发者调整。如果您不熟悉 css 及 css 变量，仍然建议您接受 shadcn 的组件使用 daisy-ui 提供的默认样式，或者不使用 shadcn 组件。
|
|
|
|
|
|
:::
|
