Vue內(nèi)容分發(fā)slot(全面解析)

更新時(shí)間：2017年08月19日 09:54:20 投稿：jingxian

下面小編就為大家?guī)?lái)一篇Vue內(nèi)容分發(fā)slot(全面解析)。小編覺(jué)得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

前面的話

為了讓組件可以組合，需要一種方式來(lái)混合父組件的內(nèi)容與子組件自己的模板。這個(gè)過(guò)程被稱(chēng)為內(nèi)容分發(fā) (或 “transclusion” )。Vue實(shí)現(xiàn)了一個(gè)內(nèi)容分發(fā) API，參照了當(dāng)前 Web 組件規(guī)范草案，使用特殊的 <slot> 元素作為原始內(nèi)容的插槽。本文將詳細(xì)介紹Vue內(nèi)容分發(fā)slot

編譯作用域

在深入內(nèi)容分發(fā) API 之前，先明確內(nèi)容在哪個(gè)作用域里編譯。假定模板為

<child-component>
 {{ message }}
</child-component>

message 應(yīng)該綁定到父組件的數(shù)據(jù)，還是綁定到子組件的數(shù)據(jù)？答案是父組件。組件作用域簡(jiǎn)單地說(shuō)是：父組件模板的內(nèi)容在父組件作用域內(nèi)編譯；子組件模板的內(nèi)容在子組件作用域內(nèi)編譯。

一個(gè)常見(jiàn)錯(cuò)誤是試圖在父組件模板內(nèi)將一個(gè)指令綁定到子組件的屬性/方法：

<!-- 無(wú)效 -->
<child-component v-show="someChildProperty"></child-component>

假定someChildProperty是子組件的屬性，上例不會(huì)如預(yù)期工作。父組件模板不應(yīng)該知道子組件的狀態(tài)

如果要綁定作用域內(nèi)的指令到一個(gè)組件的根節(jié)點(diǎn)，應(yīng)當(dāng)在組件自己的模板上做：

Vue.component('child-component', {
 // 有效，因?yàn)槭窃谡_的作用域內(nèi)
 template: '<div v-show="someChildProperty">Child</div>',
 data: function () {
 return {
  someChildProperty: true
 }
 }
})

類(lèi)似地，分發(fā)內(nèi)容是在父作用域內(nèi)編譯

默認(rèn)丟棄

一般地，如果子組件模板不包含<slot>插口，父組件的內(nèi)容將會(huì)被丟棄

var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p>測(cè)試內(nèi)容</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

<div id="example">
 <parent></parent>
</div>
<script src="https://unpkg.com/vue"></script>
<script>
var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 </div>
 `,
};
var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p>測(cè)試內(nèi)容</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};
// 創(chuàng)建根實(shí)例
new Vue({
 el: '#example',
 components: {
 'parent': parentNode
 }
})
</script>

如下圖所示，<child>所包含的測(cè)試內(nèi)容被丟棄

匿名slot

當(dāng)子組件模板只有一個(gè)沒(méi)有屬性的 slot 時(shí)，父組件整個(gè)內(nèi)容片段將插入到 slot 所在的 DOM 位置，并替換掉 slot 標(biāo)簽本身

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot></slot>
 </div>
 `,
};

var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p>測(cè)試內(nèi)容</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

如果出現(xiàn)多于1個(gè)的匿名slot，vue將報(bào)錯(cuò)

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot></slot>
 <slot></slot>
 </div>
 `,
};

【默認(rèn)值】

最初在 <slot> 標(biāo)簽中的任何內(nèi)容都被視為備用內(nèi)容，或者稱(chēng)為默認(rèn)值。備用內(nèi)容在子組件的作用域內(nèi)編譯，并且只有在宿主元素為空，且沒(méi)有要插入的內(nèi)容時(shí)才顯示備用內(nèi)容

當(dāng)slot存在默認(rèn)值，且父元素在<child>中沒(méi)有要插入的內(nèi)容時(shí)，顯示默認(rèn)值

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot><p>我是默認(rèn)值</p></slot>
 </div>
 `,
};
var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child></child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

當(dāng)slot存在默認(rèn)值，且父元素在<child>中存在要插入的內(nèi)容時(shí)，則顯示設(shè)置值

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot><p>我是默認(rèn)值</p></slot>
 </div>
 `,
};
var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p>我是設(shè)置值</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

具名Slot

<slot> 元素可以用一個(gè)特殊的屬性 name 來(lái)配置如何分發(fā)內(nèi)容。多個(gè) slot 可以有不同的名字。具名 slot 將匹配內(nèi)容片段中有對(duì)應(yīng) slot 特性的元素

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot name="my-header">頭部默認(rèn)值</slot>
 <slot name="my-body">主體默認(rèn)值</slot>
 <slot name="my-footer">尾部默認(rèn)值</slot>
 </div>
 `,
};

var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p slot="my-header">我是頭部</p>
  <p slot="my-footer">我是尾部</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

仍然可以有一個(gè)匿名 slot，它是默認(rèn) slot，作為找不到匹配的內(nèi)容片段的備用插槽。匿名slot只能作為沒(méi)有slot屬性的元素的插槽，有slot屬性的元素如果沒(méi)有配置slot，則會(huì)被拋棄

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot name="my-body">主體默認(rèn)值</slot>
 <slot></slot>
 </div>
 `,
};

var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p slot="my-body">我是主體</p>
  <p>我是其他內(nèi)容</p>
  <p slot="my-footer">我是尾部</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

插入<slot name="my-body">中，我是其他內(nèi)容插入<slot>中，而被丟棄

如果沒(méi)有默認(rèn)的 slot，這些找不到匹配的內(nèi)容片段也將被拋棄

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
 <slot name="my-body">主體默認(rèn)值</slot>
 </div>
 `,
};

var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <p slot="my-body">我是主體</p>
  <p>我是其他內(nèi)容</p>
  <p slot="my-footer">我是尾部</p>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

我是其他內(nèi)容和都被拋棄

作用域插槽

作用域插槽是一種特殊類(lèi)型的插槽，用作使用一個(gè) (能夠傳遞數(shù)據(jù)到) 可重用模板替換已渲染元素。

在子組件中，只需將數(shù)據(jù)傳遞到插槽，就像將 props 傳遞給組件一樣

<div class="child">
 <slot text="hello from child"></slot>
</div>

在父級(jí)中，具有特殊屬性 scope 的 <template> 元素必須存在，表示它是作用域插槽的模板。scope 的值對(duì)應(yīng)一個(gè)臨時(shí)變量名，此變量接收從子組件中傳遞的 props 對(duì)象

var childNode = {
 template: `
 <div class="child">
 <p>子組件</p>
  <slot xxx="hello from child"></slot>
 </div>
 `,
};
var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <template scope="props">
  <p>hello from parent</p>
  <p>{{ props.xxx }}</p>
  </template>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};

如果渲染以上結(jié)果，得到的輸出是

【列表組件】

作用域插槽更具代表性的用例是列表組件，允許組件自定義應(yīng)該如何渲染列表每一項(xiàng)

var childNode = {
 template: `
 <ul>
 <slot name="item" v-for="item in items" :text="item.text">默認(rèn)值</slot>
 </ul>
 `,
 data(){
 return{
  items:[
  {id:1,text:'第1段'},
  {id:2,text:'第2段'},
  {id:3,text:'第3段'},
  ]
 }
 }
};

var parentNode = {
 template: `
 <div class="parent">
 <p>父組件</p>
 <child>
  <template slot="item" scope="props">
  <li>{{ props.text }}</li>
  </template>
 </child>
 </div>
 `,
 components: {
 'child': childNode
 },
};