初學 Vue 時,el、template、replace 這三個選項很容易搞混,但只要理解「掛載點」與「是否取代掛載點」這條主線,其實非常清楚。以下依序拆解。
型別:String | HTMLElement | Function
限制:在元件定義中只能是函式。
它為實例提供掛載元素,值可以是 CSS 選擇器、真正的 HTML 元素,或回傳 HTML 元素的函式。重點是:這個元素只作為掛載點。若同時提供了 template,該元素會被 template 取代,除非把 replace 設為 false。掛載完成後可用 vm.$el 存取。
在 Vue.extend 中必須是函式值,這樣各個實例才不會共用同一個元素。此外,若初始化時就指定了 el,實例會立刻進入編譯流程;否則需要自行呼叫 vm.$mount() 手動啟動。
型別:String
實例的模板。預設情況下模板會取代掛載元素;若 replace 為 false,模板則會被插入掛載元素內部。兩種情況下,掛載元素原本的內容都會被忽略,除非模板裡有內容分發用的 slot。
如果值以 # 開頭,它會被當成選擇器,並使用該元素的 innerHTML 作為模板——常見技巧是用 <script type="x-template"> 來承放模板。
另外要注意:某些情況(例如模板含多個頂層元素,或只包含純文字)會讓實例變成「片段實例」,管理多個節點而非單一節點,此時掛載元素上的非流程控制指令會被忽略。
型別:Boolean,預設 true,只能與 template 一起使用。
它決定是否用模板取代掛載元素。設為 true(預設)時,模板會覆蓋掛載元素,並把掛載元素與模板根節點的 attributes 合併;設為 false 時,模板只覆蓋掛載元素的內容,元素本身保留。
replace 為預設的 true:
<div id="replace" class="foo"></div>
new Vue({
el: '#replace',
template: '<p class="bar">replaced</p>'
})
結果——原本的 div 消失,class 與 id 被合併到新的 p 上:
<p class="foo bar" id="replace">replaced</p>
把 replace 設為 false:
<div id="insert" class="foo"></div>
new Vue({
el: '#insert',
replace: false,
template: '<p class="bar">inserted</p>'
})
結果——div 保留下來,模板變成它的子節點:
<div id="insert" class="foo"> <p class="bar">inserted</p> </div>
一句話總結:el 決定掛在哪裡,template 決定掛上去的內容是什麼,replace 決定掛載元素本身留不留。