适用于 uni-app (Vue3) 的 unplugin-vue-components。组件按需自动引入,配置文件在 vite.config.ts 里写。
安装
npm i -D @uni-helper/vite-plugin-uni-components使用
vite.config.ts
import Uni from '@dcloudio/vite-plugin-uni'
import Components from '@uni-helper/vite-plugin-uni-components'
import { defineConfig } from 'vite'
export default defineConfig({
plugins: [
Components(), // 必须在 Uni() 之前
Uni(),
],
})
选项与 unplugin-vue-components 相同。
从 UI 库导入
本插件内置以下 UI 库的解析器:
| UI 库 | 解析器 |
|---|---|
| Ano UI | AnoResolver |
| hy-app | HyAppResolver |
| TDesign UniApp | TDesignUniappResolver |
| uni-ui | UniUIResolver |
| uv-ui | UvResolver |
| uview-pro | uViewProResolver |
| wot-design-uni | WotResolver |
| wot-ui v2 | WotV2Resolver |
| z-paging | ZPagingResolver |
解析器从 @uni-helper/vite-plugin-uni-components/resolvers 导入:
vite.config.ts
import Uni from '@dcloudio/vite-plugin-uni'
import Components from '@uni-helper/vite-plugin-uni-components'
import { WotResolver } from '@uni-helper/vite-plugin-uni-components/resolvers'
import { defineConfig } from 'vite'
export default defineConfig({
plugins: [
Components({ resolvers: [WotResolver()] }),
Uni(),
],
})
UI 组件类型提示
用 pnpm 时,必须在根目录创建 .npmrc,参见 unplugin-vue-components#389。
.npmrc
shamefully-hoist = true
关联项目
- vite-plugin-uni-pages:用 TypeScript 编写
pages.json,支持约定式路由。 - vite-plugin-uni-layouts:为 Vite 下的 uni-app 提供类 nuxt 的 layouts 系统。
- vite-plugin-uni-manifest:用 TypeScript 编写
manifest.json。 - vite-plugin-uni-platform:按文件名分流的平台编译插件。
- vite-plugin-uni-platform-modifier:为属性、指令提供平台修饰符。
- vite-plugin-uni-middleware:在
src/middleware中定义中间件。