本文參考官方文件整理而成,程式碼更完整、更適合新手閱讀學習。
資料來源:https://cn.vuejs.org/guide/components.html
組件(Component)是 Vue.js 最強大的功能之一。組件可以擴展 HTML 元素,封裝可重用的代碼。在較高層面上,組件就是自定義元素,Vue.js 的編譯器會為它添加特殊功能。有些情況下,組件也可以是原生 HTML 元素的形式,以 is 特性擴展。
【1】擴展 HTML 元素,封裝可重用的代碼;【2】組件是自定義元素,Vue.js 的編譯器可以為其添加特殊功能;【3】某些情況下,組件可以是原生 HTML 元素的形式,以 is 方式擴展。
分為以下幾步:
【1】掛載組件的地方,需要是 Vue 實例所渲染的 HTML 元素,比如 <div id="app"></div> 這樣的元素及其子節點;
【2】定義一個組件,用 var 變量名 = Vue.extend({template:"這裡是 html 的模板內容"}) 這樣的形式建立,例如:
//定義一個組件 var btn = Vue.extend({ template: "<button>這是一個按鈕</button>" })
【3】將定義的組件註冊到 Vue 實例上,這會讓指定標籤被組件的內容所替代:
//註冊他到 Vue 實例上 Vue.component("add-button", btn);
如此一來,每一個在 Vue 根實例範圍內的 <add-button></add-button> 標籤,都會被 <button>這是一個按鈕</button> 所替代。
【4】以上是全局註冊(每個 Vue 實例的 add-button 標籤都會被替代);解決辦法是局部註冊:
<div id="app"> </div> <script> //定義一個組件 var btn = Vue.extend({ template: "<button>這是一個按鈕</button>" }) Vue.component("add-button", btn); //創建根實例,也就是說讓 Vue 對這個根生效 var vm = new Vue({ el: '#app', template: "<add-button></add-button>" }); </script>
簡單來說,只對這一個 Vue 實例生效。具體做法是,在註冊那一步跳過,然後在聲明 Vue 實例時,將它添加到 components 屬性中(它是一個物件,以 KV 形式放置,注意這個單詞多一個 s):
<div id="app"> </div> <script> //定義一個組件 var btn = Vue.extend({ template: "<button>這是一個按鈕</button>" }) //創建根實例,也就是說讓 Vue 對這個根生效 var vm = new Vue({ el: '#app', template: "<add-button></add-button>", components: { "add-button": btn } }); </script>
注:根據官方教程,這種方法(指局部註冊)也適用於其他資源,比如指令、過濾器和過渡。
【1】定義組件和註冊組件結合起來一步完成:
//定義一個組件 Vue.component("add-button", { template: "<button>這是一個按鈕</button>" });
【2】局部註冊時,定義和註冊一步完成:
//創建根實例,也就是說讓 Vue 對這個根生效 var vm = new Vue({ el: '#app', template: "<add-button></add-button>", components: { "add-button": { template: "<button>這是一個按鈕</button>" } } });
直接給組件添加 data 屬性是不可以的(無效)。原因在於,假如這麼做,組件的 data 屬性有可能是一個物件,而這個物件也可能是外部傳入的(例如先聲明一個物件,然後作為 data 的值),可能導致這個組件的所有副本都共享同一個物件,這顯然是不對的。
因此,data 屬性應該是一個函數,並有一個返回值,這個返回值作為 data 的值,且這個返回值應該是一個全新的物件(即深度復制的,避免多個組件共享一個物件):
var vm = new Vue({ el: '#app', template: "<add-button></add-button>", components: { "add-button": { template: "<button>這是一個按鈕{{btn}}</button>", data: function () { return {btn: "123"}; } } } });
另外,假如像下面這樣,btn 的值就會一樣(因為它們實際上還是共享了一個物件):
<div id="app"> </div> <div id="app2"> </div> <script> var obj = {btn: "123"}; var vm = new Vue({ el: '#app', template: "<add-button></add-button>", components: { "add-button": { template: "<button>這是一個按鈕{{btn}}</button>", data: function () { return obj; } } } }); obj.btn = "456"; var vm2 = new Vue({ el: '#app2', template: "<add-button></add-button>", components: { "add-button": { template: "<button>這是一個按鈕{{btn}}</button>", data: function () { return obj; } } } }); </script>
注:el 屬性用在 Vue.extend() 中時,也須是一個函數。
【1】按照官方教程,一些 HTML 元素對什麼元素可以放在它之中是有限制的;但實際測試時暫未發現問題,因此這部分留待日後深入研究。
【2】相關說明可參考:https://cn.vuejs.org/guide/components.html#u6A21_u677F_u89E3_u6790
以上就是 Vue.js 組件的定義與註冊的完整解析,希望對大家有所幫助。若有任何疑問歡迎留言,我會及時回覆。