vite-plugin-uni-components

从 unplugin-vue-components 派生并修改以适应UniApp。

适用于 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 UIAnoResolver
hy-appHyAppResolver
TDesign UniAppTDesignUniappResolver
uni-uiUniUIResolver
uv-uiUvResolver
uview-prouViewProResolver
wot-design-uniWotResolver
wot-ui v2WotV2Resolver
z-pagingZPagingResolver

解析器从 @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

关联项目