1. 程式人生 > >vue 插槽slot

vue 插槽slot

變量 默認 特性 得到 head ops rom header 找不到

本文是對官網內容的整理 https://cn.vuejs.org/v2/guide/components.html#編譯作用域

在使用組件時,我們常常要像這樣組合它們:

<app>
    <app-header></app-header>
    <app-footer></app-footer>
</app>

註意兩點:

  1. <app> 組件不知道它會收到什麽內容。這是由使用 <app> 的父組件決定的。

  2. <app> 組件很可能有它自己的模板

為了讓組件可以結合,我們需要一種方式來混合父組件的內容和子組件自己的模板,這個過程叫內容分發,

Vue.js 實現了一個內容分發 API,使用特殊的 <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