Vue コンテンツ配信スロット-jsチュートリアル-php.cn

前の言葉

コンポーネントを構成するには、親コンポーネントのコンテンツと子コンポーネント独自のテンプレートを混合する方法が必要です。このプロセスは コンテンツ配信 (または「トランスクルージョン」) と呼ばれます。 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
  },
};

ログイン後にコピー