DCloud_UNI_JBB
DCloud_UNI_JBB
  • 发布:2025-09-25 19:37
  • 更新:2025-10-13 11:02
  • 阅读:374

微信、支付宝、抖音等小程序支持自定义 componentPlaceholder

分类:uni-app

背景

微信小程序支持 跨分包自定义组件引用,但是 uniapp 目前只支持在 pages.json 下的页面中配置 componentPlaceholder, 并不支持在某个具体的组件中添加此配置。

可以通过这个 插件 来解决此问题,支持 cli项目 和 hx项目

Vue3

安装

npm install @uni_toolkit/vite-plugin-component-config -D  
# 或  
pnpm add @uni_toolkit/vite-plugin-component-config -D  
# 或  
yarn add @uni_toolkit/vite-plugin-component-config -D

使用方法

配置 vite.config.js

// vite.config.js  
import { defineConfig } from 'vite'  
import uni from '@dcloudio/vite-plugin-uni'  
import componentConfig from '@uni_toolkit/vite-plugin-component-config'  

export default defineConfig({  
  plugins: [  
    componentConfig(), // 在 uni 插件之前调用  
    uni(),  
  ]  
})

修改 Vue 文件

<template>  
  <view class="container">  
    <text>Hello World</text>  
  </view>  
</template>  

<script>  
export default {  
  name: 'MyComponent'  
}  
</script>  

// #ifdef MP  
<component-config>  
// 此处必须是标准的 json 对象,支持条件编译  
{  
  "usingComponents": {  
    "custom-button": "/components/custom-button"  
  },  
  "styleIsolation": "apply-shared",  
  "componentPlaceholder": {    
    "test": "view",    
  }    
}  
</component-config>  
// #endif

Vue2

安装

npm install @uni_toolkit/webpack-plugin-component-config -D  
# 或  
pnpm add @uni_toolkit/webpack-plugin-component-config -D  
# 或  
yarn add @uni_toolkit/webpack-plugin-component-config -D

使用方法

配置 vue.config.js

const WebpackComponentConfigPlugin = require('@uni_toolkit/webpack-plugin-component-config').default;  

module.exports = {  
  configureWebpack: {  
    plugins: [  
      new WebpackComponentConfigPlugin()  
    ]  
  }  
};

修改 Vue 文件

<template>  
  <view class="container">  
    <text>Hello World</text>  
  </view>  
</template>  

<script>  
export default {  
  name: 'MyComponent'  
}  
</script>  

// #ifdef MP  
<component-config>  
// 此处必须是标准的 json 对象,支持条件编译  
{  
  "usingComponents": {  
    "custom-button": "/components/custom-button"  
  },  
  "styleIsolation": "apply-shared",  
  "componentPlaceholder": {    
    "test": "view",    
  }    
}  
</component-config>  
// #endif
2 关注 分享
7***@qq.com julytian

要回复文章请先登录注册

DCloud_UNI_JBB

DCloud_UNI_JBB (作者)

回复 7***@qq.com :
升级到 0.0.3 试试还有没有问题
2025-10-13 11:02
DCloud_UNI_JBB

DCloud_UNI_JBB (作者)

回复 7***@qq.com :
你可以先临时修改node-modules下面的那个包,找到dist下的index.cjs文件,搜索Object.assign,那里就是合并json的地方,可以修改一下默认覆盖这个策略。也欢迎到我的github仓库提个pr
2025-10-12 10:32
DCloud_UNI_JBB

DCloud_UNI_JBB (作者)

回复 7***@qq.com :
应该是bug,我今天修复一下
2025-10-12 10:19
7***@qq.com

7***@qq.com

回复 DCloud_UNI_JBB :
可以用,非常感谢。我发现usingComponents好像会把原来引用的组件覆盖,需要删除usingComponents或者在usingComponents中重新声明原来引用的组件,这是正常的吗?
2025-10-12 09:51
DCloud_UNI_JBB

DCloud_UNI_JBB (作者)

回复 7***@qq.com :
文章我更新了,你看vue2的部分
2025-10-11 19:20
DCloud_UNI_JBB

DCloud_UNI_JBB (作者)

回复 7***@qq.com :
https://github.com/uni-toolkit/uni-toolkit/tree/main/packages/webpack-plugin-component-config 试试这个
2025-10-11 19:15
7***@qq.com

7***@qq.com

回复 DCloud_UNI_JBB :
好的,谢谢你。
2025-10-11 16:52
DCloud_UNI_JBB

DCloud_UNI_JBB (作者)

回复 7***@qq.com :
不支持vue2,vue2用的是webpack,我这两天实现一个webpack版本的
2025-10-11 16:44
7***@qq.com

7***@qq.com

请问支持vue2吗?我按照上面文档,不起作用。
2025-10-11 16:41
7***@qq.com

7***@qq.com

太棒了,亲测有效,不过有个小细节我补充一下,如果组件使用驼峰式命名引入时,在配置 componentPlaceholder需要配置成中线方式,因为小程序编译的时候usingComponents会把驼峰转换成中线
例如:
import myChildren from "@/subpage/components/public/myChildren.vue";
配置成
defineOptions({
componentPlaceholder: {
'my-children': "view",
},
});
2025-09-26 10:54