Vue3 将组件手动渲染到指定元素中的方法实现
作者:Fisschl
一些第三方库内部创建的元素,并不是由 Vue 管理的。比如 ECharts,Antv 等图表库中的自定义图形节点。这些库或许支持使用 HTML 自定义图表中的某一部分,但仅仅书写 HTML 并不那么令人满意。
我希望将一个组件手动挂载到指定元素上,可以尝试两种方式:自定义元素,多应用。
将组件转换为自定义元素
文档:Vue 与 Web Components | Vue.js (vuejs.org)
Vue 对 Web Components 提供了良好的支持。可以使用defineCustomElement
将组件转换为自定义元素。随后就可以自由插入到 DOM 节点中了。
import { defineCustomElement } from 'vue' const MyVueElement = defineCustomElement({ // 这里是同平常一样的 Vue 组件选项 props: {}, emits: {}, template: `...`, // defineCustomElement 特有的:注入进 shadow root 的 CSS styles: [`/* inlined css */`] }) // 注册自定义元素 // 注册之后,所有此页面中的 `<my-vue-element>` 标签 // 都会被升级 customElements.define('my-vue-element', MyVueElement) // 你也可以编程式地实例化元素: // (必须在注册之后) document.body.appendChild( new MyVueElement({ // 初始化 props(可选) }) )
此外,还可以将一个 SFC (单文件组件)转换为自定义元素。
import { defineCustomElement } from 'vue' import Example from './Example.ce.vue' console.log(Example.styles) // ["/* 内联 css */"] // 转换为自定义元素构造器 const ExampleElement = defineCustomElement(Example) // 注册 customElements.define('my-example', ExampleElement)
值得注意的是,
defineCustomElement
会使用 Shadow DOM 渲染元素。而这种方式会造成样式隔离,外部的样式将无法作用到组件内部。 如果您使用了组件库,或依赖于某些外部样式,记得将这些样式重复导入一次。
Vue 的多应用实例
还记得在创建项目时,我们使用了createApp
创建一个App
实例,然后将它挂载到了#app
里。实际上,在一个 DOM 环境中可以同时存在多个 App 实例,也就是多个 Vue 应用。
利用这一点,可以再次创建一个 App 实例,然后将它挂载到某个特定的 DOM 元素上。
import YouComponent from "./YouComponent.vue"; // 创建一个新的 Vue 应用 const app = createApp(YouComponent); // 将应用挂载到自定义的 DOM 元素上 app.mount("#you-element");
这样,组件就可以正常渲染了。但是组件的 provide,inject 会失效,因为它并不属于原先的应用了。
如何进行组件之间的通信?可以使用自定义事件,或者 createEventHook | VueUse。 此外,也可以利用 Vue3 的响应性原理,使用
ref
或者reactive
创建一个单独的响应性对象,然后在不同的组件中引用它们,就可以实现双向的数据同步。
到此这篇关于Vue3 将组件手动渲染到指定元素中的方法实现的文章就介绍到这了,更多相关Vue3 渲染组件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!