如何使用 Vue3 建置 Web Components?以下這篇文章為大家介紹一下用 Vue3 建立 Web Components的方法,希望對大家有幫助!
有時候想寫一個無關框架元件,又不想用原生或Jquery 那套去寫,而且還要避免樣式衝突,用Web Components 去做剛覺就挺合適的。但現在 Web Components 使用起來還是不夠靈活,很多地方還是不太方便的,如果能和 MVVM 搭配使用就好了。早在之前 Angular 就支援將元件建置成 Web Components,Vue3 3.2 開始終於支援將組成建置成 Web Components 了。剛好最近想重構下評論插件,於是上手試了試。
vue 提供了一個defineCustomElement 方法,用來將vue 元件轉換成擴充到HTMLElement的自訂函數構造函數,使用方式和defineComponent 參數api基本上保持一致。 【相關推薦:vuejs影片教學】
import { defineCustomElement } from 'vue' const MyVueElement = defineCustomElement({ // 在此提供正常的 Vue 组件选项 props: {}, emits: {}, template: `...`, // defineCustomElement 独有特性: CSS 会被注入到隐式根 (shadow root) 中 styles: [`/* inlined css */`] }) // 注册 Web Components customElements.define('my-vue-element', MyVueElement)
如果需要使用單一文件,需要@vitejs/plugin-vue@^1.4.0 或vue -loader@^16.5.0 或更高版本工具。如果只是部分檔案需要使用,可以將後綴改為 .ce.vue 。若果需要將所有檔案建置Web Components 可以將@vitejs/plugin-vue@^1.4.0 或vue-loader@^16.5.0的customElement 配置項開啟。這樣不需要再使用 .ce.vue 字尾名了。
vue 會把所有的的 props 自訂元素的物件的 property 上,也會將自訂元素標籤上的 attribute 做一個對應。
<com-demo></com-demo> props:{ type:String }
因為HTML 的attribute 的只能是字串,除了基礎型別(Boolean、Number) Vue 在映射時會幫忙做型別轉換,其他複雜型別則需要設定到DOM property 上。
在自訂元素中,透過this.$emit 或在setup 中的 emit 發出的事件會被調度為原生CustomEvents。附加的事件參數 (payload) 會作為陣列暴露在 CustomEvent 物件的 details property 上。
在寫元件時,可以想 vue 一樣,但是使用時只能原生的插槽語法,所以也不在支援作用域插槽。
使用子元件嵌套的時,有個坑的地方就是預設不會將子元件裡的樣式抽離出來。
父元件
<template> <div>{{ title }}</div> <childer></childer> </template> <script> import Childer from "./childer.vue" export default { components: { Childer }, data() { return { title: "父组件" } }, } </script> <style> .title { padding: 10px; background-color: #eee; font-weight: bold; } </style>
子元件
<template> <div>{{ title }}</div> </template> <script> export default { data() { return { title: "子组件" } }, } </script> <style> .childer { padding: 10px; background-color: #222; color: #fff; font-weight: bold; } </style>
可以看到子元件的樣式沒有插入進去,但是樣式隔離的識別是有產生的 data-v-5e87e937。不知道vue官方後續會不會修復這個bug
查看元件是可以看到,子元件的樣式是有被抽離出來的,這樣就只需要自己注入進去了。
將子元件樣式抽離插入到父元件裡,參考這個的實作
import ComDemo from '~/demo/index.vue' const deepStylesOf = ({ styles = [], components = {} }) => { const unique = array => [...new Set(array)]; return unique([...styles, ...Object.values(components).flatMap(deepStylesOf)]); } // 将子组件样式插入到父组件里 ComDemo.styles = deepStylesOf(ComDemo) !customElements.get('com-demo') && customElements.define('com-demo', defineCustomElement(ComDemo))
完美解決子元件樣式問題
defineCustomElement 建構的元件預設是不會將方法掛到customElement 上的,看Vue 原始碼中,只有_def(建構子),_instance(元件實例))。如果想要呼叫元件內的方法,dom._instance.proxy.fun(),感覺實在不太優雅。
我們當然希望我們元件暴露的方法能像普通dom一樣直接 dom.fun() 去掉用,我們對 defineCustomElement 稍作擴充。
import { VueElement, defineComponent } from 'vue' const defineCustomElement = (options, hydate) => { const Comp = defineComponent(options); class VueCustomElement extends VueElement { constructor(initialProps) { super(Comp, initialProps, hydate); if (Comp.methods) { Object.keys(Comp.methods).forEach(key => { // 将所有非下划线开头方法 绑定到 元素上 if(!/^_/.test(key)){ this[key] = function (...res) { if (this._instance) { // 将方法thi改为 组件实例的proxy return Comp.methods[key].call(this._instance.proxy, ...res) } else { throw new Error('未找到组件实例') } } } }) } } } VueCustomElement.def = Comp; return VueCustomElement; }
總體來說坑還是有不少的,如果僅僅需要建立一些比較簡單跨框架插件,使用這種方式來建立Web Components 也是一種不錯的方案。
更多程式相關知識,請造訪:程式設計入門! !
以上是聊聊怎麼用Vue3建構Web Components的詳細內容。更多資訊請關注PHP中文網其他相關文章!