Skip to content
75
3

With the release of Vue 3.5, Vue has more support for custom elements. This repository should have completed its mission (a transitional solution before Vue supports more features for custom elements), so this repository should not support 3.5. I recommend you upgrade to Vue 3.5.x to meet your needs for custom elements.

unplugin-vue-ce ​

A vue plugin that extends vue's Custom Element capabilities (v-model, child style)

English | δΈ­ζ–‡

Feature ​

  • 🧩 It is a function extension of vue
  • 🌈 Compatible with multiple bundled platforms(vite、webpackοΌ‰
  • β›° Support v-model
  • ⚑ Support child style

Tips: ⚠ This plugin will inject the implementation code into the vue runtime, which is what I have to tell you. If you have any problems using it, please submit an issue

Install ​

bash
npm i unplugin-vue-ce -D

or

bash
yarn add unplugin-vue-ce-D

or

bash
pnpm add unplugin-vue-ce -D

Usage ​

Tips: You need to enable the customElement option of @vitejs/plugin-vue

Vite
ts
// vite.config.ts
import { defineConfig } from 'vite'
import { viteVueCE } from 'unplugin-vue-ce'
import vue from '@vitejs/plugin-vue'
import type { PluginOption } from 'vite'
export default defineConfig({
  plugins: [
    vue(),
    viteVueCE() as PluginOption,
  ],
})
Rollup
ts
// rollup.config.js
import { rollupVueCE } from '@nplugin-vue-ce'
export default {
  plugins: [
    rollupVueCE(),
  ],
}
Webpack
ts
// webpack.config.js
module.exports = {
  /* ... */
  plugins: [
    require('unplugin-vue-ce').webpackVueCE(),
  ],
}
Vue CLI
ts
// vue.config.js
module.exports = {
  configureWebpack: {
    plugins: [
      require('unplugin-vue-ce').webpackVueCE({}),
    ],
  },
}
ESBuild
ts
// esbuild.config.js
import { build } from 'esbuild'
import { esbuildVueCE } from 'unplugin-vue-ce'

build({
  plugins: [esbuildVueCE()],
})

🎯 Support v-model ​

view more details @unplugin-vue-ce/v-model

πŸŽƒ Support the style of child components ​

view more details @unplugin-vue-ce/sub-style

🍻 Support using web component as root component ​

view more details @unplugin-vue-ce/ce-app

Thanks ​

Released under the MIT License.