vue 插槽slot
本文是對官網內容的整理 https://cn.vuejs.org/v2/guide/components.html#編譯作用域
在使用組件時,我們常常要像這樣組合它們:
<app> <app-header></app-header> <app-footer></app-footer> </app>
註意兩點:
-
<app>
組件不知道它會收到什麽內容。這是由使用<app>
的父組件決定的。 -
<app>
組件很可能有它自己的模板
為了讓組件可以結合,我們需要一種方式來混合父組件的內容和子組件自己的模板,這個過程叫內容分發,
<slot>
元素作為原始內容的插槽。
單個插槽
除非子組件模板包含至少一個 <slot>
插口,否則父組件的內容將會被丟棄。當子組件模板只有一個沒有屬性的插槽時,父組件傳入的整個內容片段將插入到插槽所在的 DOM 位置,並替換掉插槽標簽本身。
最初在 <slot>
標簽中的任何內容都被視為備用內容。備用內容在子組件的作用域內編譯,並且只有在宿主元素為空,且沒有要插入的內容時才顯示備用內容。
具名插槽
<slot>
元素可以用一個特殊的特性 name
來進一步配置如何分發內容。多個插槽可以有不同的名字。具名插槽將匹配內容片段中有對應 slot
仍然可以有一個匿名插槽,它是默認插槽,作為找不到匹配的內容片段的備用插槽。如果沒有默認插槽,這些找不到匹配的內容片段將被拋棄。
例如,假定我們有一個 app-layout
組件,它的模板為:
<div class="container"> <header> <slot name="header"></slot> </header> <main> <slot></slot> </main> <footer> <slot name="footer"></slot> </footer> </div>
父組件模板:
<app-layout> <h1 slot="header">這裏可能是一個頁面標題</h1> <p>主要內容的一個段落。</p> <p>另一個主要段落。</p> <p slot="footer">這裏有一些聯系信息</p> </app-layout>
渲染結果為:
<div class="container"> <header> <h1>這裏可能是一個頁面標題</h1> </header> <main> <p>主要內容的一個段落。</p> <p>另一個主要段落。</p> </main> <footer> <p>這裏有一些聯系信息</p> </footer> </div>
在設計組合使用的組件時,內容分發 API 是非常有用的機制。
作用域插槽( 2.1.0 新增)
作用域插槽是一種特殊類型的插槽,用作一個 (能被傳遞數據的) 可重用模板,來代替已經渲染好的元素。
在子組件中,只需將數據傳遞到插槽,就像你將 prop 傳遞給組件一樣:
<div class="child"> <slot text="hello from child"></slot> </div>
在父級中,具有特殊特性 slot-scope
的 <template>
元素必須存在,表示它是作用域插槽的模板。slot-scope
的值將被用作一個臨時變量名,此變量接收從子組件傳遞過來的 prop 對象:
<div class="parent"> <child> <template slot-scope="props"> <span>hello from parent</span> <span>{{ props.text }}</span> </template> </child> </div>
如果我們渲染上述模板,得到的輸出會是:
<div class="parent"> <div class="child"> <span>hello from parent</span> <span>hello from child</span> </div> </div>
在Vue 2.5.0+,
slot-scope
能被用在任意元素或組件中而不再局限於<template>
。
作用域插槽更典型的用例是在列表組件中,允許使用者自定義如何渲染列表的每一項:
<my-awesome-list :items="items"> <!-- 作用域插槽也可以是具名的 --> <li slot="item" slot-scope="props" class="my-fancy-item"> {{ props.text }} </li> </my-awesome-list>
列表組件的模板:
<ul> <slot name="item" v-for="item in items" :text="item.text"> <!-- 這裏寫入備用內容 --> </slot> </ul>
解構
slot-scope
的值實際上是一個可以出現在函數簽名參數位置的合法的 JavaScript 表達式。這意味著在受支持的環境 (單文件組件或現代瀏覽器) 中,您還可以在表達式中使用 ES2015 解構:
<child> <span slot-scope="{ text }">{{ text }}</span> </child>
vue 插槽slot