微信小程序、支付宝小程序、抖音小程序等支持 占位组件，但是 uniapp 只支持在 pages.json 下的页面中配置 componentPlaceholder， 并不支持在某个具体的组件中添加此配置，此插件旨在解决这个问题。
- 配置简单，开箱即用
- 支持 vue、nvue、uvue 三种文件
- 支持 uni-app 和 uni-app-x 项目
- 支持 组合式 和 选项式 两种写法
- 支持 cli 项目和 hx 项目
// npm
npm i @binbinji/vite-plugin-component-placeholder -D
// yarn
yarn add @binbinji/vite-plugin-component-placeholder -D
// pnpm
pnpm add @binbinji/vite-plugin-component-placeholder -D// vite.config.*
import componentPlaceholderPlugin from '@binbinji/vite-plugin-component-placeholder'
import uni from '@dcloudio/vite-plugin-uni'
import { defineConfig } from 'vite'
// https://vitejs.dev/config/
export default defineConfig({
plugins: [uni(), componentPlaceholderPlugin()],
})Tip
注意配置的 key 需要转换成 kebab-case 风格，比如你的组件名为 TestComp，配置应该写 test-comp
在 vue 相关文件中添加 componentPlaceholder 配置
<template>
<view>test page</view>
<test></test>
</template>
<script setup>
import test from './test.vue'
defineOptions({
// ifdef MP
componentPlaceholder: {
test: 'view',
}
// endif
})
</script><template>
<view>test page</view>
<test></test>
</template>
<script>
import test from './test.vue'
export default {
components: {
test,
},
// ifdef MP
componentPlaceholder: {
test: 'view',
}
// endif
}
</script>插件支持以下配置选项：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
include |
FilterPattern |
['**/*.{vue,nvue,uvue}'] |
指定需要处理的文件模式 |
exclude |
FilterPattern |
[] |
指定需要排除的文件模式 |