23. Slot

Slot 이란?

 

HTML 요소와 마찬가지로 우리가 만든 컴포넌트에 콘텐츠를 전달할 수 있으면 유용합니다.

<FancyButton> 컴폰넌트를 만든 후 콘텐츠를 전달해 보도록 하겠습니다.

<!-- FancyButton.vue -->
<template>
	<button class="fancy-btn">
		<slot></slot>
	</button>
</template>

slot을 사용하는 방법은 매우 간단합니다.

컨텐츠를 위치하게 하고 싶은곳에 <slot> 컴포넌트를 배치 시키면 됩니다.

그리고 사용하는 쪽에 아래 예시처럼 컨텐츠를 넣으면 됩ㄴ디ㅏ.

 

위에 정의한 컴포넌트를 부모 컴포넌트에서 사용해 보겠습니다.

<FancyButton>
	<!-- 슬롯 콘텐츠 -->
	Click!!
</FancyButton>

여기서 작성된 콘텐츠는 <slot>이 선언된 위치에서 그대로 사용됩니다.

 

 

<slot> 요소는 부모 컴포넌트에서 제공하는 콘텐츠를 나타내는 슬롯 콘텐츠 입니다. 

그리고 슬롯은 텍스트뿐만아니라 HTML요소, 컴포넌트 등 다양한 모든 콘텐츠가 될 수 있습니다.

<FancyButton>
	<!-- 슬롯 콘텐츠 -->
  <span style="color: red">Click me</span>
  <i>!</i>
</FancyButton>

 

---

Fallback Content

 

상위 컴포넌트에서 슬롯 콘텐츠가 제공되지 않을때는 슬롯에 대한 폴백(기본 콘텐츠)를 지정할 수 있습니다.

<!-- FancyButton.vue -->
<template>
  <button class="btn">
    <slot>Default Click!!</slot>
  </button>
</template>

 

---

Named Slots

 

<slot> 요소에 이름을 부여하여 여러개의 <slot>을 정의할 수 있습니다.

<!-- BaseCard.vue -->
<template>
  <article>
    <div>
      <slot name="header"></slot>
    </div>
    <div>
      <slot></slot>
    </div>
    <div">
      <slot name="footer"></slot>
    </div>
  </article>
</template>

 

<slot>에 name 속성을 부여하여 특정 슬롯 콘텐츠가 렌더링 되어야 할 위치를 설정할 수 있습니다.

name이 없는 <slot>의 이름은 암시적으로 default 입니다.

<!-- 부모 컴포넌트 사용 예시 -->
<template>
  <BaseCard>
    <template v-slot:header>제목</template>
    <template v-slot:default>안녕하세요</template>
	<template v-slot:footer>푸터</template>
  </BaseCard>
</template>

위 예시처럼 name이 부여된 <slot>에 콘텐츠를 전달하려면 v-slot 디렉티브를 사용하여 전달할 수 있습니다.

그리고 v-slot:전달인자 를 사용하여 지정된 슬롯 콘텐츠에 전달할 수 있습니다.

 

v-slot은 #으로 단축 표현할 수 있습니다.

<!-- 부모 컴포넌트 사용 예시 -->
<template>
  <BaseCard>
    <template #header>제목</template>
    <template #default>안녕하세요</template>
    <template #footer>푸터</template>
  </BaseCard>
</template>

 

그리고 default 슬롯은 암시적으로 처리할 수 있습니다.

<!-- 부모 컴포넌트 사용 예시 -->
<template>
  <BaseCard>
    <template #header>제목</template>
    <!-- 암시적으로 default slot -->
    안녕하세요
    <template #footer>푸터</template>
  </BaseCard>
</template>

---

Dynamic Slot Named

 

v-slot 디렉티브 전달인자에 데이터를 바인딩하여 동적으로 변경할 수도 있습니다.

<BaseCard>
  <template v-slot:[dynamicSlotName]>
    ...
  </template>

  <!-- with shorthand -->
  <template #[dynamicSlotName]>
    ...
  </template>
</BaseCard>

 

const dynamicSlotName = ref('header'); 

이렇게 변수로 동적 바인딩 가능합니다.

---

Render Scope

슬롯 콘텐츠는 상위 컴포넌트에 정의되어 있으므로 상위 컴포넌트의 데이터 영역에 접근은 가능하지만 

하위 컴포넌트의 영역에는 접근할 수 없습니다.

 

---

Scoped Slot

 

Render Scope 에서 언급했던 것처럼 슬롯 콘텐츠는 자식 컴포넌트의 데이터에 접근할 수 없습니다.

하지만 슬롯 콘텐츠에서 상위 컴포넌트와 하위 컴포넌트 데이터를 모두 사용할수 있다면 

우리는 개발 할 때 매우 유용합니다.

 

이러한 방법으로 우리는 자식 컴포넌트에서 <slot> 요소를 사용할 때 Props를 전달하는 것처럼 속성을 슬롯 콘텐츠에 전달할 수 있습니다.

<!-- MyComponent.vue -->
<template>
  <div>
    <slot :text="greetingMessage" :count="count"></slot>
  </div>
</template>
<script>
import { ref } from 'vue';

export default {
  setup() {
    const greetingMessage = ref('Hello World!');
    const count = ref(1);
    return {
      greetingMessage,
      count,
    };
  },
};
</script>

 

default <slot>이 하나밖에 없는 경우는 v-slot 디렉티브를 사용하여 props를 전달 받을수 있습니다.

객체로 받아와서 사용됩니다. 받아오는 객체명은 정해져있는게 아니라 지정 가능합니다.

slotProps가 아니라 obj로 받아와도 객체 접근 가능합니다.

<MyComponent v-slot="slotProps">
  {{ slotProps.text }} {{ slotProps.count }}
</MyComponent>

 

구조분해 할당 문법으로 더 사용하기 편리하게 받을 수 있습니다.

<MyComponent v-slot="{ text, count }">
  {{ text }} {{ count }}
</MyComponent>

---

Name Scoped Slots

 

이름이 부여된 슬롯도 유사하게 작동합니다. v-slot:name="slotProps"

<MyComponent>
  <template #header="headerProps">
    {{ headerProps }}
  </template>

  <template #default="defaultProps">
    {{ defaultProps }}
  </template>

  <template #footer="footerProps">
    {{ footerProps }}
  </template>
</MyComponent>

---

 

Slot 콘텐츠가 있을때만 header를 보이게 하고 싶다면?

 

v-if와 $slot을 통해 구현 가능하다.

v-if="$slot.header" : header라는 슬롯이 정의되어 있으면 이런 엘리먼트를 렌더링하겠다 라는 뜻. 

v-if 사용 전

v-if 사용 후

 

 

 

 

setUp 함수 안에서도 slots을 사용할 수 있다.

---

 

공식 홈페이지에 보면 Component Instance 항목에 있는 객체들이 있다.

$slots 도 이 중 하나