feat: add shadcn

This commit is contained in:
2026-01-31 00:00:46 +08:00
parent bad60a8ee5
commit 5807fcad48
36 changed files with 992 additions and 22 deletions

View File

@@ -0,0 +1,25 @@
# 组件库
## 必要前提
您必须熟悉 [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` 下拉框按钮组件来方便切换主题。
## 关于 Shadcn
`components/ui` 目录下是 shadcn-vue 提供的组件代码,您可以在项目中直接调用这些组件,同时也可以根据需要进行调整。