一個模組的命名關係到我們是否能快速地知道這個模組的功能是甚麼,同時可以避免跟現有的 HTML 標籤相衝突。
在Vue.js - 风格指南中, component 有一個重要的命名規則 - Multi-word component names ,指的是模組的命名需要由多個單字組合而成,這是為了避免跟現有的 HTML 標籤產生衝突(現有的 HTML 標籤都是一個單字)。
命名方法有2種:
使用 kebab-case (短橫線分隔):如 my-component-name
、todo-item
、cart-item
等。
使用 PascalCase (首字母大寫): MyComponentName
、TodoItem
、CartItem
等。
必須注意的是在 HTML 時,標籤名一定要是 kebab-case (短橫線分隔)模式,例如: <my-component-name></my-component-name>
、 <todo-item></todo-item>
。
更多命名的規則請參考Vue.js - 风格指南。
在上一篇文章中所介紹的模組都是用全域註冊。沒錯,就是使用 Vue.component('模組名',{...})
,模組全域註冊的目的是讓其他的模組都能使用它。
模組的全域註冊
Vue.component('global-component-a',{
props:['status'],
template: `<p>我是一個全域的模組A</p>`,
data(){
return {
//資料
},
methods:{
//方法
},
//生命週期鉤子
}
})
Vue.component('global-component-b',{
//可以直接使用<global-component-a>,而無須再次註冊
template:`<div>
<p>我是一個全域的模組B</p>
<global-component-a></global-component-a>
</div>`
//options
})
Vue.component('global-component-c',{
template:`<p>我是一個全域的模組C</p>`
//options
})
全域註冊模組的使用
<div id="vm">
<global-component-a></global-component-a>
<global-component-b></global-component-b>
<global-component-c></global-component-c>
</div>
通過上方可知,只要是全域的模組,其他的模組都可以直接使用而不用再次註冊。
在 Vue 文件中有提到
Remember that global registration must take place before the root Vue instance is created (with new Vue).
全域模組註冊必須要在根 Vue 實例創建前。(根 Vue 實例就是用 new Vue 創建出來的那個)。
模組的區域註冊*
const LocalComponentA = {
template:`<p>我是一個區域的模組A</p>`
}
const LocalComponentB = {
// 將區域模組LocalComponentA註冊到要使用他的LocalComponentB實例中
components:{ LocalComponentA },
template:`<div>
<p>我是一個區域的模組B</p>
<local-component-a></local-component-a>
</div>`
}
const LocalComponentC = {
// 將區域模組LocalComponentB註冊到要使用他的LocalComponentC實例中
components:{ LocalComponentB },
template:`<div>
<p>我是一個區域的模組C</p>
<local-component-b></local-component-b>
</div>`
}
const vm = new Vue({
el: "#vm",
// 將區域模組註冊到要使用他們的實例中
components:{
// LocalComponentA
LocalComponentB,
LocalComponentC
}
})
區域註冊模組的使用
<div id="vm">
<local-component-a></local-component-a>
<local-component-b></local-component-b>
<local-component-c></local-component-c>
</div>
這裡有幾個需要注意的地方:
模組區域註冊必須先宣告賦值後才能使用,像是不能在 LocalComponentA
中註冊使用 LocalComponentB
,因為 LocalComponentB
的宣告賦值是在 LocalComponentA
之後的。
要使用區域模組一定要先註冊,像是在 LocalComponentB
中要使用 LocalComponentA
,就必須在 LocalComponentB
的 options 中加入 components:{LocalComponentA:LocalComponentA}
,使用 ES6 語法可寫成 components:{LocalComponentA}
,這時在 LocalComponentB
中才可以使用 LocalComponentA
。
Demo:[DAY11]跟 Vue.js 認識的30天 - Vue 的模組註冊
參考資料:
Vue.js Components Fundamentals