Vue内容分发slot
前面的話
為了讓組件可以組合,需要一種方式來混合父組件的內(nèi)容與子組件自己的模板。這個過程被稱為 內(nèi)容分發(fā) (或 “transclusion” )。Vue實(shí)現(xiàn)了一個內(nèi)容分發(fā) API,參照了當(dāng)前 Web 組件規(guī)范草案,使用特殊的 <slot> 元素作為原始內(nèi)容的插槽。本文將詳細(xì)介紹Vue內(nèi)容分發(fā)slot
?
編譯作用域
在深入內(nèi)容分發(fā) API 之前,先明確內(nèi)容在哪個作用域里編譯。假定模板為
<child-component>{{ message }} </child-component>message 應(yīng)該綁定到父組件的數(shù)據(jù),還是綁定到子組件的數(shù)據(jù)?答案是父組件。組件作用域簡單地說是:父組件模板的內(nèi)容在父組件作用域內(nèi)編譯;子組件模板的內(nèi)容在子組件作用域內(nèi)編譯。
一個常見錯誤是試圖在父組件模板內(nèi)將一個指令綁定到子組件的屬性/方法:
<!-- 無效 --> <child-component v-show="someChildProperty"></child-component>假定someChildProperty是子組件的屬性,上例不會如預(yù)期工作。父組件模板不應(yīng)該知道子組件的狀態(tài)
如果要綁定作用域內(nèi)的指令到一個組件的根節(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}} })類似地,分發(fā)內(nèi)容是在父作用域內(nèi)編譯
?
默認(rèn)丟棄
一般地,如果子組件模板不包含<slot>插口,父組件的內(nèi)容將會被丟棄
var parentNode = {template: `<div class="parent"><p>父組件</p><child><p>測試內(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>測試內(nèi)容</p></child></div> `,components: {'child': childNode}, }; // 創(chuàng)建根實(shí)例 new Vue({el: '#example',components: {'parent': parentNode} }) </script>如下圖所示,<child>所包含的<p>測試內(nèi)容</p>被丟棄
?
內(nèi)聯(lián)模板
如果子組件有 inline-template 特性,組件將把它的內(nèi)容當(dāng)作它的模板,而忽略真實(shí)的模板內(nèi)容
但是 inline-template 讓模板的作用域難以理解
var childNode = {template: `<div class="child"><p>子組件</p></div>`, }; var parentNode = {template: `<div class="parent"><p>父組件</p><child inline-template><p>測試內(nèi)容</p></child></div>`,components: {'child': childNode}, };?
匿名slot
當(dāng)子組件模板只有一個沒有屬性的 slot 時,父組件整個內(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>測試內(nèi)容</p></child></div>`,components: {'child': childNode}, };如果出現(xiàn)多于1個的匿名slot,vue將報(bào)錯
var childNode = {template: `<div class="child"><p>子組件</p><slot></slot><slot></slot></div>`, };【默認(rèn)值】
最初在 <slot> 標(biāo)簽中的任何內(nèi)容都被視為備用內(nèi)容,或者稱為默認(rèn)值。備用內(nèi)容在子組件的作用域內(nèi)編譯,并且只有在宿主元素為空,且沒有要插入的內(nèi)容時才顯示備用內(nèi)容
當(dāng)slot存在默認(rèn)值,且父元素在<child>中沒有要插入的內(nèi)容時,顯示默認(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è)置值
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> 元素可以用一個特殊的屬性 name 來配置如何分發(fā)內(nèi)容。多個 slot 可以有不同的名字。具名 slot 將匹配內(nèi)容片段中有對應(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}, };仍然可以有一個匿名 slot,它是默認(rèn) slot,作為找不到匹配的內(nèi)容片段的備用插槽。匿名slot只能作為沒有slot屬性的元素的插槽,有slot屬性的元素如果沒有配置slot,則會被拋棄
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}, };<p slot="my-body">插入<slot name="my-body">中,<p>我是其他內(nèi)容</p>插入<slot>中,而<p slot="my-footer">被丟棄
如果沒有默認(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}, };<p>我是其他內(nèi)容</p>和<p slot="my-footer">都被拋棄
?
作用域插槽
作用域插槽是一種特殊類型的插槽,用作使用一個 (能夠傳遞數(shù)據(jù)到) 可重用模板替換已渲染元素。
在子組件中,只需將數(shù)據(jù)傳遞到插槽,就像將 props 傳遞給組件一樣
<div class="child"><slot text="hello from child"></slot> </div>在父級中,具有特殊屬性 scope 的 <template> 元素必須存在,表示它是作用域插槽的模板。scope 的值對應(yīng)一個臨時變量名,此變量接收從子組件中傳遞的 props 對象
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}, };?
轉(zhuǎn)載于:https://www.cnblogs.com/xiaohuochai/p/7392384.html
創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎勵來咯,堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎總結(jié)
以上是生活随笔為你收集整理的Vue内容分发slot的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 【译】怎样处理 Safari 移动端对图
- 下一篇: 江山控股附属斥资3.02亿收购云阳新能源