vue3插槽的使用

原创已于 2023-04-21 15:39:56 修改 · 3k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#前端 #vue #javascript

于 2023-04-15 13:29:30 首次发布

vue 同时被 2 个专栏收录

17 篇文章

订阅专栏

4 篇文章

订阅专栏

插槽就是子组件中的提供给父组件使用的一个占位符，用表示，父组件可以在这个占位符中填充任何模板代码，如 HTML、组件等，填充的内容会替换子组件的标签。

1.插槽基本使用

子组件SlotComponent.vue

<template>
    <div class="child-box">
    <p>我是子组件</p>
    <!-- 插槽 -->
    <slot></slot>
  </div>
  </template>
<script setup lang="ts">
</script>

父组件

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent></SlotComponent>
  </div>
</template>

<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
</script>

输出结果：

在这里插入图片描述

2.插槽默认内容

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <!-- 插槽 -->
    <slot>
      <p>我是默认内容</p>
    </slot>
  </div>
</template>
<script setup lang="ts"></script>

输出结果：

在这里插入图片描述

3.具名插槽

子组件SlotComponent.vue

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <header>
      <slot name="header"></slot>
    </header>
    <main>
      <slot></slot>
    </main>
    <footer>
      <slot name="footer"></slot>
    </footer>
  </div>
</template>
<script setup lang="ts"></script>

上段代码中我们添加了 3 个 slot 插槽，并且给其中两个 slot 标签添加了一个 name 属性，也就是每个插槽的名字。需要注意的是，上段代码中有一个插槽我们没有添加 name 属性，这个时候 Vue 会隐式的将这个插槽命名为“default”，

父组件

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent>
      <template #header>
        <div>我是 header{{ message }}</div>
      </template>
      <template #default>
        <div>我没有名字{{ message }}</div>
        <div>我没有名字{{ message }}</div>
        <div>我没有名字{{ message }}</div>
      </template>
      <template #footer>
        <div>我是 footer{{ message }}</div>
      </template>
    </SlotComponent>
  </div>
</template>
<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
const message = ref("---我是父组建中的数据");
</script>

输出结果：

在这里插入图片描述

4.简写

原写法

<template v-slot:footer></template>

简写

<template #footer></template>

默认插槽与具名插槽混用

当一个子组件中既有具名插槽，又有默认插槽时，该如何渲染呢？

前面我们说默认插槽会被隐式的命名为 default，所以我们传入内容时可以将插槽名字改为 defalut 即可。

子组件SlotComponent.vue

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <header>
      <slot name="header"></slot>
    </header>
    <main>
      <slot></slot>
    </main>
    <footer>
      <slot name="footer"></slot>
    </footer>
  </div>
</template>
<script setup lang="ts"></script>

父组件

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent>
      <template #header>
        <div>我是 header{{ message }}</div>
      </template>
      <template #default>
        <div>我没有名字{{ message }}</div>
        <div>我没有名字{{ message }}</div>
        <div>我没有名字{{ message }}</div>
      </template>
      <template #footer>
        <div>我是 footer{{ message }}</div>
      </template>
    </SlotComponent>
  </div>
</template>
<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
const message = ref("---我是父组建中的数据");
</script>

输出结果：

在这里插入图片描述

5.插槽作用域问题

上段代码中 message 是我们在父组件中定义的数据，但是在我们的子组件SlotComponent 中渲染了出来，说明子组件中的插槽是可以访问到父组件中的数据作用域的，但是反过来是不行的，因为我们无法通过插槽拿到子组件的数据。

- 总结：

插槽内容可以访问到父组件的数据作用域，就好比上述中的 message 是父组件的。
插槽内容无法访问到子组件的数据，就好比上述 App.vue 中的插槽内容拿不到子组件 child 的数据。

6.作用域插槽

前一节我们说父组件中的插槽内容是无法访问到子组件中的数据的，但是，万一我们有需求就是需要在插槽内容中获取子组件数据怎么办呢？

6.1默认插槽作用域传值

子组件SlotComponent.vue

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <slot text="我是子组件" :count="1"></slot>
  </div>
</template>
<script setup lang="ts"></script>

父组件

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent v-slot="slotProps">
      <div>{{ slotProps.text }}---{{ slotProps.count }}</div>
    </SlotComponent>
  </div>
</template>
<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
</script>

输出结果：

在这里插入图片描述
上段代码中我们在子组件中 slot 标签上添加了一些自定义属性，属性值就是我们想要传递给父组件的一些内容。在父组件中通过 v-slot="slotProps"等形式接收子组件传过来的数据，slotProps 的名字是可以任意取的，它是一个对象，包含了所有传递过来的数据。

需要注意的是，子组件传递过来的数据只能在子组件这个标签内使用。

父组件解构写法：

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent v-slot="{ text, count }">
      <div>{{ text }}---{{ count }}</div>
    </SlotComponent>
  </div>
</template>
<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
</script>

6.2具名插槽作用域传值

子组件SlotComponent.vue

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <slot name="header" text="我是子组件的" :count="1"></slot>
  </div>
</template>
<script setup lang="ts"></script>

父组件

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent>
      <template #header="{ text, count }">
        <div>{{ text }}---{{ count }}</div>
      </template>
    </SlotComponent>
  </div>
</template>
<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
</script>

上段代码中我们给 slot 添加了一个 name，在父组件中接收数据的时候不在采用 v-slot=““形式了，而是直接再插槽内容上采用#header=”“形式，当时这是简写形式，你也可以写为：v-slot:header=””

6.tsx中插槽的使用

子组件

<script lang="tsx">
  import { defineComponent} from 'vue';
  export default defineComponent({
    setup(props, context) {
        const {slots}=context
      return () => (
        <div>默认插槽: {slots.default && slots.default()}</div>
      );
    },
  });
</script>
<style scoped></style>

父组建写法一

<script lang="tsx">
  import { defineComponent } from 'vue';
  import Child from './component/child.vue'
  export default defineComponent({
    setup() {
        const text = ref("欢迎");
        return () => (
            <div style="color: red" class="my-test">
            <h1 v-text={text.value}></h1>
            <p>333</p>
                <Child v-slots={{
                default: () => '默认的内容是'
                }}/>
            </div>
        );
    },
  });
</script>
<style scoped></style>

父组建写法二

<script lang="tsx">
  import { defineComponent } from 'vue';
  import Child from './component/child.vue'
  export default defineComponent({
    setup() {
        const text = ref("欢迎");
        return () => (
            <div style="color: red" class="my-test">
            <h1 v-text={text.value}></h1>
            <p>333</p>
                <Child>
                    {{
                    default: () => '默认的内容是'
                    }}
                </Child>
            </div>
        );
    },
  });
</script>
<style scoped></style>

输出结果：

在这里插入图片描述

7.插槽高阶用法

实际开发中可以遇到组件层层嵌套，如果遇到一下情况如何解决。
7.1. 如果父组件需要拿到子组件的数据
7.2. 父组件还需要拿到孙组件的数据

父组件 `useSlot.vue`

<template>
  <div class="demo1">
    <h1>我是父组建</h1>
    <SlotComponent>
      <template #action="data">
        <div>我是 action----{{ data.text }}</div>
      </template>
      <template #SlotDemo="data">
        <div>我是 SlotDemo----{{ data.obj.text }}</div>
      </template>
    </SlotComponent>
  </div>
</template>
<script setup lang="ts">
import SlotComponent from "./component/SlotComponent.vue";
</script>

注释：

#action="data"中的data为子组件中传递过来的数据
#SlotDemo="data"中的data为孙组件中传递过来的数据

子组件 `SlotComponent.vue`

<script lang="tsx">
import SlotDemo from "./SlotDemo.vue";
import { Slots } from 'vue'
export default defineComponent({
  name:'SlotComponent',
  setup(props,{ attrs,slots,emit,expose }){
    let state=reactive({ text:'我是子组件中的数据' })
    //slots收到的插槽集合
    //slot 当前插槽的名字  默认是default
    //data 要传给插槽的数据
    const getSlot = (slots: Slots, slot = 'default', data?: Recordable) => {
      const slotFn = slots[slot] //获取到父组件SlotDemo插槽
      if (!slotFn) return null //如果没在父组件找到插槽  就return null
      return slotFn(data)// 将数据data传递给父组件中的插槽
    }
    return () =>(
      <>
        <div>{slots.action?.(state)}</div>
        <SlotDemo>
          {{  
            default: (data) => getSlot(slots,'SlotDemo',data),
          }}
        </SlotDemo>
      </>
    )
  }
})
</script>

注释：

default: (data) => getSlot(slots,'SlotDemo',data),：default代表SlotDemo组件中的默认插槽data表示SlotDemo组件上v-bind绑定的参数,
getSlot(slots,'SlotDemo',data)：在slots中找到插槽SlotDemo，将参数data传给插槽SlotDemo，并返回插槽SlotDemo中的内容。

孙组件 `SlotDemo.vue`

<template>
    <div class="SlotDemo">
        <slot :obj="obj"></slot>
    </div>
</template>
<script>
export default defineComponent({
    setup() {
        let obj=reactive({ text:'我是孙子组件' })
        return { obj }
    },
})
</script>