Vue コンテンツ配信スロット

前の言葉

コンポーネントを構成するには、親コンポーネントのコンテンツと子コンポーネント独自のテンプレートを混合する方法が必要です。このプロセスは コンテンツ配信 (または「トランスクルージョン」) と呼ばれます。 Vue は、生のコンテンツのスロットとして特別な <slot> 要素を使用して、現在のドラフト Web コンポーネント仕様に準拠したコンテンツ配布 API を実装します。この記事では、Vue コンテンツ配布スロットについて詳しく紹介します<slot> 元素作为原始内容的插槽。本文将详细介绍Vue内容分发slot

编译作用域

　　在深入内容分发 API 之前，先明确内容在哪个作用域里编译。假定模板为

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

　　message 应该绑定到父组件的数据，还是绑定到子组件的数据？答案是父组件。组件作用域简单地说是：父组件模板的内容在父组件作用域内编译；子组件模板的内容在子组件作用域内编译。

　　一个常见错误是试图在父组件模板内将一个指令绑定到子组件的属性/方法：

<!-- 无效 -->
<child-component v-show="someChildProperty"></child-component>

　　假定someChildProperty是子组件的属性，上例不会如预期工作。父组件模板不应该知道子组件的状态

　　如果要绑定作用域内的指令到一个组件的根节点，应当在组件自己的模板上做：

Vue.component('child-component', {
  // 有效，因为是在正确的作用域内
  template: '<p v-show="someChildProperty">Child</p>',
  data: function () {
    return {
      someChildProperty: true
    }
  }
})

　　类似地，分发内容是在父作用域内编译

 

默认丢弃

　　一般地，如果子组件模板不包含<slot>插口，父组件的内容将会被丢弃

var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child>
      <p>测试内容</p>
    </child>
  </p>
  `,
  components: {
    'child': childNode
  },
};

<p id="example">
  <parent></parent></p><script src="https://unpkg.com/vue"></script><script>var childNode = {
  template: `  <p class="child">
    <p>子组件</p>
  </p>  `,
};var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child>
      <p>测试内容</p>
    </child>
  </p>  `,
  components: {    'child': childNode
  },
};// 创建根实例new Vue({
  el: '#example',
  components: {    'parent': parentNode
  }
})</script>

　　如下图所示，所包含的

测试内容

被丢弃

 

匿名slot

　　当子组件模板只有一个没有属性的 slot 时，父组件整个内容片段将插入到 slot 所在的 DOM 位置，并替换掉 slot 标签本身

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

var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child>
      <p>测试内容</p>
    </child>
  </p>
  `,
  components: {
    'child': childNode
  },
};

　　如果出现多于1个的匿名slot，vue将报错

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

【默认值】

　　最初在 <slot> 标签中的任何内容都被视为备用内容，或者称为默认值。备用内容在子组件的作用域内编译，并且只有在宿主元素为空，且没有要插入的内容时才显示备用内容

　　当slot存在默认值，且父元素在中没有要插入的内容时，显示默认值

var childNode = {
  template: `  <p class="child">
    <p>子组件</p>
    <slot><p>我是默认值</p></slot>
  </p>
  `,
};
var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child></child>
  </p>
  `,
  components: {
    'child': childNode
  },
};

　　当slot存在默认值，且父元素在中存在要插入的内容时，则显示设置值

var childNode = {
  template: `  <p class="child">
    <p>子组件</p>
    <slot><p>我是默认值</p></slot>
  </p>
  `,
};
var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child>
      <p>我是设置值</p>
    </child>
  </p>
  `,
  components: {
    'child': childNode
  },
};

 

具名Slot

　　<slot> 元素可以用一个特殊的属性 name 来配置如何分发内容。多个 slot 可以有不同的名字。具名 slot 将匹配内容片段中有对应 slot

コンパイル スコープ

コンテンツ配布 API について詳しく説明する前に、まずコンテンツがどのスコープでコンパイルされるかを明確にします。テンプレートが

var childNode = {
  template: `  <p class="child">
    <p>子组件</p>
    <slot name="my-header">头部默认值</slot>
    <slot name="my-body">主体默认值</slot>
    <slot name="my-footer">尾部默认值</slot>
  </p>
  `,
};

であると仮定します。 message は親コンポーネントのデータにバインドされるべきですか、それとも子コンポーネントのデータにバインドされるべきですか?答えは親コンポーネントです。コンポーネント スコープとは、単に、親コンポーネント テンプレートのコンテンツが親コンポーネント スコープでコンパイルされ、子コンポーネント テンプレートのコンテンツが子コンポーネント スコープでコンパイルされることを意味します。

よくある間違いは、親コンポーネントのテンプレート内で子コンポーネントのプロパティ/メソッドにディレクティブをバインドしようとすることです:

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

someChildProperty が子コンポーネントのプロパティであると仮定すると、上記の例は期待どおりに動作しません。親コンポーネントのテンプレートは、子コンポーネントの状態を認識すべきではありません

スコープ付きディレクティブをコンポーネントのルート ノードにバインドしたい場合は、コンポーネント独自のテンプレートでそれを行う必要があります:

var childNode = {
  template: `  <p class="child">
    <p>子组件</p>
    <slot name="my-body">主体默认值</slot>
    <slot></slot>
  </p>
  `,
};

同様に、配布コンテンツは親スコープでコンパイル済みです

デフォルトでは破棄

通常、子コンポーネント テンプレートに <slot> ソケットが含まれていない場合、コンテンツは下の図に示すように、<子>に含まれる

testコンテンツ

は破棄されます

匿名スロット

時サブコンポーネント テンプレートには属性のないスロットが 1 つだけあり、親コンポーネントのコンテンツ フラグメント全体がスロットが配置されている DOM の場所に挿入され、スロット タグ自体が置き換えられます

var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child>
      <p slot="my-body">我是主体</p>
      <p>我是其他内容</p>
      <p slot="my-footer">我是尾部</p>
    </child>
  </p>
  `,
  components: {
    'child': childNode
  },
};

var childNode = {
  template: `  <p class="child">
    <p>子组件</p>
    <slot name="my-body">主体默认值</slot>
  </p>
  `,
};

匿名スロットが複数ある場合は、vueエラーが報告されます

🎜🎜

var parentNode = {
  template: `  <p class="parent">
    <p>父组件</p>
    <child>
      <p slot="my-body">我是主体</p>
      <p>我是其他内容</p>
      <p slot="my-footer">我是尾部</p>
    </child>
  </p>
  `,
  components: {
    'child': childNode
  },
};

🎜🎜🎜🎜🎜 【デフォルト値】🎜🎜 もともと<slot>タグ内にあるものはすべて🎜フォールバックコンテンツ🎜とみなされ、デフォルト値として知られています。バックアップ コンテンツは子コンポーネントのスコープでコンパイルされ、ホスト要素が空で挿入するコンテンツがない場合にのみバックアップ コンテンツが表示されます🎜🎜 スロットにデフォルト値があり、親要素に何もない場合<子>コンテンツに挿入すると、デフォルト値が表示されます🎜🎜🎜

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

🎜🎜🎜 🎜🎜 スロットにデフォルト値があり、親要素にに挿入する内容がある場合、設定値が表示されます🎜🎜🎜

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

🎜🎜🎜🎜🎜 🎜

名前付きスロット

🎜 <slot> 要素では、特別な属性 name を使用して、コンテンツの配布方法を構成できます。複数のスロットには異なる名前を付けることができます。名前付きスロットは、対応する slot 属性を持つコンテンツ フラグメント内の要素と一致します 🎜🎜🎜

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

🎜🎜🎜🎜

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

🎜🎜🎜🎜🎜🎜 匿名スロットを使用することもできます。デフォルト スロット🎜、コンテンツ フラグメントに一致する代替スロットが見つかりませんでした。匿名スロットは、スロット属性のない要素のスロットとしてのみ使用できます。スロット属性が設定されていない場合、スロットは破棄されます。私は他のコンテンツです

<slot> を挿入し、

が破棄されます 🎜🎜🎜🎜🎜 デフォルトのスロットがない場合、一致するものが見つからないこれらのコンテンツ フラグメントは、も破棄されます 🎜🎜🎜rrreee🎜🎜🎜🎜rrreee🎜🎜🎜

I am other content

作用域插槽

　　作用域插槽是一种特殊类型的插槽，用作使用一个 (能够传递数据到) 可重用模板替换已渲染元素。

　　在子组件中，只需将数据传递到插槽，就像将 props 传递给组件一样

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

　　在父级中，具有特殊属性 scope 的 <template> 元素必须存在，表示它是作用域插槽的模板。scope 的值对应一个临时变量名，此变量接收从子组件中传递的 props 对象

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

　　如果渲染以上结果，得到的输出是

【列表组件】

　　作用域插槽更具代表性的用例是列表组件，允许组件自定义应该如何渲染列表每一项

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

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

 

以上がVue コンテンツ配信スロットの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。