はい、承知いたしました。Vue.jsのスロットに関する詳細な技術記事を約5000語で記述します。
Vue.js スロットとは？コンポーネント活用術 の詳細な解説
はじめに：なぜVue.jsのスロットが必要なのか？
Vue.jsを使った開発において、コンポーネントはアプリケーションを構築する上で不可欠な要素です。UIの再利用や保守性の向上に大きく貢献しますが、コンポーネントを設計する上でしばしば直面する課題があります。それは、「コンポーネントの構造は共通だけど、その『中身』や『振る舞い』の一部は使う場所によって変えたい」という要求です。
例えば、汎用的なボタンコンポーネントを考えましょう。ボタンの基本的なスタイルやクリック時の共通処理はコンポーネント内で定義できますが、ボタンに表示するテキストやアイコンは様々です。「保存」「キャンセル」「削除」など、ボタンごとにラベルが異なります。このような場合、プロップスを使ってボタンのテキストを渡すことは可能です。しかし、ボタンの中に単なるテキストだけでなく、アイコンや他の要素を含めたい場合はどうでしょうか？ プロップスで複雑なHTML構造を文字列として渡すのは、可読性も悪く、セキュリティリスク（XSS）も伴います。
また、より複雑な例として、モーダルコンポーネントを考えてみましょう。モーダルの背景のオーバーレイ、閉じるボタン、中央に表示されるコンテナといった構造は共通ですが、モーダルの「中身」、つまりヘッダー、ボディ、フッターに表示するコンテンツは、表示する情報や操作によって全く異なります。プロップスだけでヘッダー、ボディ、フッターのコンテンツを全て受け渡すのは現実的ではありません。子コンポーネント（モーダル）は親コンポーネント（モーダルを表示する画面）がどのようなコンテンツを表示したいかを知らないため、汎用的なモーダルコンポーネントとして機能させるには、コンテンツを「外部から注入」できる仕組みが必要です。
このような、「コンポーネントの骨組みや共通部分はコンポーネント内で定義するが、その特定の部分に外部（親コンポーネント）から要素やコンポーネントを挿入したい」というニーズに応えるのが、Vue.jsの「スロット (Slot)」です。
スロットは、子コンポーネント内の特定の場所に、親コンポーネントが提供するコンテンツを「穴埋め」するメカニズムを提供します。これにより、コンポーネントの構造とコンテンツを分離し、コンポーネントの再利用性と柔軟性を飛躍的に向上させることができます。プロップスが「データ」を子に渡す手段であるのに対し、スロットは「DOM要素やコンポーネントといったコンテンツ」を子に渡す手段と言えます。
本記事では、Vue.jsのスロットについて、その基本的な使い方から、名前付きスロット、スコープ付きスロットといった発展的な機能、そしてVue 2.6以降で推奨されている v-slot ディレクティブの詳細、さらにRenderless Componentsのような高度な活用パターンまで、約5000語にわたって網羅的に解説します。スロットをマスターすることで、より設計性の高く、再利用可能なVue.jsコンポーネントを開発できるようになるでしょう。
Vue.js スロットの基本
スロットの最も基本的な使い方は、子コンポーネントのテンプレート内に単に <slot> 要素を配置することです。
1. 単一スロット (Default Slot)
子コンポーネントのテンプレートに <slot> タグを一つだけ配置した場合、それは「デフォルトスロット」または「単一スロット」と呼ばれます。親コンポーネントは、この子コンポーネントのカスタムタグの開始タグと終了タグの間に記述したコンテンツを、この <slot> の位置に挿入できます。
子コンポーネント ( BaseButton.vue ):
“`vue
“`
親コンポーネントでの使用例:
“`vue
クリックしてください
確定
保存
“`
この例では、BaseButton コンポーネントは <button> 要素の基本的な構造とスタイルを定義しています。<slot> タグがある位置に、親コンポーネントで BaseButton タグの間に記述された「クリックしてください」、「確定」、「 保存」といったコンテンツが挿入されます。これにより、BaseButton のスタイルや共通の振る舞いを再利用しつつ、ボタンのラベルを柔軟に変更できます。
2. フォールバックコンテンツ (Fallback Content)
子コンポーネントの <slot> タグの中にコンテンツを記述しておくと、それは「フォールバックコンテンツ（またはデフォルトコンテンツ）」として機能します。親コンポーネントがそのスロットに何もコンテンツを提供しなかった場合に、このフォールバックコンテンツが表示されます。
子コンポーネント ( BaseButton.vue – フォールバック追加):
“`vue
“`
親コンポーネントでの使用例:
“`vue
送信
“`
親コンポーネントが <BaseButton> タグの間に何もコンテンツを記述しなかった場合、子コンポーネントの <slot>Submit</slot> の中の「Submit」が表示されます。これは、スロットにデフォルトのコンテンツを提供したい場合に便利です。
スロットの目的とプロップスとの比較
スロットの主な目的は、コンポーネントの「コンテンツの構造」と「挿入される具体的なコンテンツ」を分離することです。これにより、同じ構造を持つコンポーネントを、中身だけを変えて様々な場所で再利用できるようになります。
プロップスも親から子へデータを渡すためのものですが、用途が異なります。
* プロップス: 親から子へ「データ」や「設定値」を渡す。子コンポーネントはそのデータを受け取り、自身のロジックや表示に使用します。
* スロット: 親から子へ「DOM要素やコンポーネントといったコンテンツそのもの」を渡す。子コンポーネントは渡されたコンテンツを自身のテンプレートの <slot> の位置に配置します。
プロップスで渡せるのは文字列、数値、オブジェクト、配列、関数など、JavaScriptのデータ型です。一方、スロットで渡せるのは、HTMLタグ、テキストノード、Vueコンポーネントといったテンプレートの断片です。この違いを理解することが、プロップスとスロットを適切に使い分ける鍵となります。
名前付きスロット (Named Slots)
単一スロットはコンポーネント内にコンテンツを挿入する場所が一つだけの場合に便利ですが、モーダルの例のように、複数の異なる場所にコンテンツを挿入したい場合があります。このような場合に「名前付きスロット」を使用します。
名前付きスロットを使うには、子コンポーネントの <slot> タグに name 属性を付けます。
子コンポーネント ( BaseModal.vue ):
“`vue
“`
上記の BaseModal.vue コンポーネントには、header, body, footer という3つの名前付きスロットと、名前のないデフォルトスロット（もしあれば）ではなく、ここでは明示的に名前を付けています。それぞれのスロットにはフォールバックコンテンツも定義されています。
親コンポーネントは、これらの名前付きスロットにコンテンツを提供するために、v-slot ディレクティブを使用します。v-slot ディレクティブは、通常 <template> タグと一緒に使われます。
親コンポーネントでの使用例:
“`vue
ユーザー情報の編集
ユーザー情報を入力してください。
“`
親コンポーネントでは、BaseModal の子要素として <template> タグを使用し、そこに v-slot:header、v-slot:body、v-slot:footer という形でスロット名を指定しています。これにより、それぞれの <template> タグで囲まれたコンテンツが、子コンポーネントの対応する名前のスロットの位置に挿入されます。
v-slot ディレクティブの詳細と省略記法
v-slot ディレクティブはVue 2.6で導入された新しいスロット構文であり、それまでの slot 属性と slot-scope 属性に代わるものです。推奨される構文であり、より明確で柔軟なスロットの使い方を提供します。
v-slot は引数としてスロット名を : の後に取ります。
- 名前付きスロット:
v-slot:スロット名 - デフォルトスロット:
v-slot:default(名前を指定しない<slot>に対応)
デフォルトスロットの場合、v-slot:default は省略して単に v-slot と記述できます。
デフォルトスロットの例 ( BaseButton.vue を v-slot で使用):
“`vue
クリックしてください
確定
保存
テキスト1
テキスト2
“`
名前付きスロットにも省略記法があります。v-slot:名前 は #名前 と省略できます。
名前付きスロットの省略記法例 ( BaseModal.vue を # で使用):
“`vue
ユーザー情報の編集 (省略記法)
ユーザー情報を入力してください。(省略記法)
“`
この # 記法は非常に便利で、多くのVueプロジェクトで使われています。特に名前付きスロットを多用する場合にテンプレートがすっきりします。
v-slot ディレクティブを <template> 要素に使うことが推奨される理由は、<template> タグ自体はレンダリングされないため、スロットに提供するコンテンツが複数の要素で構成されていても問題なくグループ化できるからです。要素自体に v-slot を使うと、その要素がスロットコンテンツのルート要素として扱われますが、デフォルトスロット以外ではこの使い方はできません（Vue 3では要素への名前付きスロットの使用は非推奨になりました）。デフォルトスロットの場合でも、複数のルートノードを持つコンテンツを渡す場合は <template> を使う必要があります。
スコープ付きスロット (Scoped Slots)
ここまでのスロットの使い方は、「親コンポーネントが提供するコンテンツを、子コンポーネントの指定された位置に挿入する」というものでした。スロットに挿入されるコンテンツは、親コンポーネントのデータスコープで評価されます。つまり、スロット内の式（例: {{ message }}）は、親コンポーネントの data や computed に定義された message を参照します。
しかし、子コンポーネント内のデータを使って、親コンポーネントがスロットのコンテンツを描画したい場合があります。
例えば、リストを表示する汎用的なコンポーネント (ItemList.vue) を考えてみましょう。このコンポーネントはアイテムの配列をプロップスで受け取り、それらをリスト表示します。
子コンポーネント ( ItemList.vue ):
“`vue
“`
この ItemList コンポーネントはアイテムのリスト構造（<ul>, <li>）を提供しますが、各 <li> の中身（アイテムをどのように表示するか）は、アイテムの型やアプリケーションの要求によって異なります。例えば、ユーザーリストなら「名前、メールアドレス」、商品リストなら「商品名、価格」などを表示したいかもしれません。
もし単なるスロットを使うと、スロットの中身は親のデータにしかアクセスできません。しかし、ここで必要なのは、ループ中の現在のアイテムのデータにアクセスして、それを使ってリストアイテムを描画することです。
この問題を解決するのが「スコープ付きスロット」です。スコープ付きスロットを使うと、子コンポーネントはスロットをレンダリングする際に、自身のデータを親コンポーネントに「渡す」ことができます。親コンポーネントはそのデータを受け取り、それを使ってスロットのコンテンツを定義します。
スロットプロップス (Slot Props)
子コンポーネントがスロットから親に渡すデータを「スロットプロップス (Slot Props)」と呼びます。子コンポーネントは、<slot> タグに属性としてこのデータをバインド（v-bind の省略記法 : を使用）することで、スロットプロップスを渡します。
子コンポーネント ( ItemList.vue – スコープ付きスロット化):
“`vue
“`
上記の ItemList コンポーネントでは、<li> の中の <slot> タグに :item="item" と :index="index" という属性を追加しました。これにより、v-for ループで現在処理されている item オブジェクトと index が、スロットプロップスとして親コンポーネントに利用可能になります。
親コンポーネントは、v-slot ディレクティブを使ってこれらのスロットプロップスを受け取ります。v-slot の値として、スロットプロップスを受け取る変数を指定します。
親コンポーネントでの使用例 ( ItemList.vue をスコープ付きスロットで使用):
“`vue
ユーザーリスト
– {{ slotProps.item.email }}
(Index: {{ slotProps.index }})
商品リスト
“`
この例の最初の ItemList の使用箇所では、<template v-slot="slotProps"> としています。これは、子コンポーネントから渡されたすべてのスロットプロップスが slotProps というオブジェクトとして親に渡されることを意味します。子コンポーネントは :item="item" と :index="index" を渡しているので、slotProps オブジェクトは { item: /* 現在のアイテム */, index: /* 現在のインデックス */ } のようになります。親コンポーネントは slotProps.item.name や slotProps.index のように、このオブジェクトのプロパティを通してデータにアクセスできます。
二番目の ItemList の使用箇所では、<template v-slot="{ item }"> としています。これはJavaScriptの分割代入の構文です。slotProps オブジェクトの中から item プロパティだけを取り出して、それを直接 item という名前の変数として使えるようにします。これにより、テンプレート内で item.name のように直接アイテムデータにアクセスできるようになり、コードがより簡潔になります。分割代入は、必要なスロットプロップスだけを受け取りたい場合に非常に便利です。例えば、インデックスが必要なければ { item } とし、アイテムだけが必要なければ { index }、両方必要なら { item, index } のように記述できます。
スコープ付きスロットを使用することで、ItemList コンポーネントは「アイテムのリストを表示する」という共通の構造を提供しつつ、各アイテムの具体的な表示形式は親コンポーネントが完全にコントロールできるようになりました。これは、UIの再利用性を高める上で非常に強力なパターンです。
名前付きスロットとスコープ付きスロットの組み合わせ
名前付きスロットとスコープ付きスロットは組み合わせて使用できます。特定名前のスロットにスコープ付きデータを提供したい場合に利用します。
子コンポーネントでは、名前付きスロット <slot name="名前" :propName="value"> のようにデータを渡します。
親コンポーネントでは、v-slot:名前="slotProps" または v-slot:名前="{ propName }" のように指定します。
子コンポーネント ( DataDisplayCard.vue ):
アイテムデータとタイトルを表示するカードコンポーネントを考えます。カードのボディ部分はアイテムデータを使ってカスタマイズしたいが、タイトル部分は単に親から文字列を受け取りたいとします。
“`vue
ID: {{ dataItem.id }}
Name: {{ dataItem.name }}
“`
親コンポーネントでの使用例:
“`vue
ユーザー情報
名前: {{ item.name }}
メール: {{ item.email }}
ID: {{ item.id }}
商品情報
“`
この例では、DataDisplayCard は title という名前付きスロット（スコープなし）と itemContent という名前付きスロット（スコープ付き）を持っています。親コンポーネントは #title でタイトルコンテンツを提供し、#itemContent="{ item }" でアイテムデータを受け取り、それを使って詳細な表示を定義しています。2つ目のカードのように、itemContent スロットにコンテンツを提供しない場合は、子コンポーネントのフォールバックコンテンツが表示されます。フォールバックコンテンツ内では、スコープ付きスロットで渡される item プロップスではなく、子コンポーネント自身のプロップスである dataItem を参照することに注意が必要です。
このように、名前付きスロットとスコープ付きスロットを組み合わせることで、コンポーネントの様々な部分を、子コンポーネントのデータを利用しながら、親コンポーネント側で柔軟にカスタマイズできるようになります。
動的スロット名
v-slot ディレクティブの引数（スロット名）は、動的に指定することも可能です。これは、テンプレート内でJavaScriptの式を使ってスロット名を決定したい場合に役立ちます。動的引数の構文 [ディレクティブ:式] を使用します。
子コンポーネント ( DynamicSlotComponent.vue ):
“`vue
“`
親コンポーネントでの使用例 (動的なスロット名):
“`vue
使用するスロット: {{ slotNameToUse || ‘default’ }}
これは動的に指定されたスロットのコンテンツです。
選択されたスロット名: {{ slotNameToUse }}
静的な名前付きスロットの例（比較用）
静的なヘッダーコンテンツ
静的なメインコンテンツ
“`
この例では、slotNameToUse というデータプロパティの値が ‘header’, ‘main’, ‘footer’ のいずれかである場合に、<template v-slot:[slotNameToUse]> が対応する名前付きスロットにコンテンツを挿入します。ユーザーが入力フィールドの値を変更すると、それに合わせてコンテンツが挿入されるスロットが動的に切り替わります。
動的スロット名は、例えばタブコンポーネントでアクティブなタブに対応するコンテンツを動的に切り替えたい場合などに役立ちます。
スロットの高度な活用術
スロットは、単にコンテンツを挿入するだけでなく、コンポーネント設計において強力なパターンを実現するためにも使用されます。
Renderless Components (レンダーレスコンポーネント)
レンダーレスコンポーネントは、自身のUI（見た目）をほとんど、あるいは全く持たず、主にロジックや状態管理、データの取得といった「振る舞い」を提供し、その結果（データやメソッド）をスコープ付きスロット経由で親コンポーネントに渡すことに特化したコンポーネントです。親コンポーネントは、受け取ったデータやメソッドを使って、実際のUI要素（レンダリング）を定義します。
このパターンは、ロジックとUIを完全に分離できる点が大きなメリットです。同じロジックやデータを使いながら、全く異なるUIで表示することが容易になります。
例：トグル状態を管理するレンダーレスコンポーネント
クリックすると状態が切り替わるトグルボタンや、開閉するパネルなど、単純なトグル状態は様々なUI要素で必要になります。この「トグル状態とその切り替えロジック」だけをレンダーレスコンポーネントとして抽出してみましょう。
子コンポーネント ( ToggleState.vue – Renderless Component):
“`vue
“`
このコンポーネントは <template> ブロックを持たず、代わりに render 関数を使用しています。render 関数内で、デフォルトスロット（this.$scopedSlots.default）を呼び出し、その引数として { isOn: this.isOn, toggle: this.toggle } というオブジェクトを渡しています。これがスコープ付きスロットのプロップスになります。
親コンポーネントは、この ToggleState コンポーネントを使用し、スコープ付きスロットで isOn（状態）と toggle（メソッド）を受け取ります。そして、受け取ったデータとメソッドを使って実際のボタンやテキストなどのUIをレンダリングします。
親コンポーネントでの使用例:
“`vue
レンダーレスコンポーネントの例
現在の状態: {{ isOn ? ‘ON’ : ‘OFF’ }}
別のUIで同じロジックを使用
“`
親コンポーネントは、ToggleState の中の <template v-slot="{ isOn, toggle }"> で、ToggleState が提供する isOn と toggle を受け取っています。一つ目の例ではボタンとテキストで、二つ目の例ではクリック可能な div で、受け取ったデータ (isOn) を表示し、メソッド (toggle) を呼び出しています。どちらのUIも、ToggleState コンポーネントが提供する同じ状態管理ロジックを使用しています。
レンダーレスコンポーネントパターンは、フォームの入力値検証、非同期データのフェッチ、モーダルの表示/非表示管理など、様々な共通ロジックをUIから切り離して再利用可能なコンポーネントとして提供する場合に非常に有効です。
スロットとCSS (スタイリング)
スロットを使用する際に、スタイリングはどのように扱われるのでしょうか？ VueのCSSスコープ（scoped 属性）とスロットコンテンツの関係を理解することが重要です。
- 子コンポーネントのスタイル: 子コンポーネントで定義されたスタイル（特に
scopedスタイル）は、その子コンポーネント自身のテンプレート内の要素にのみ適用されます。スロットに挿入された親コンポーネントのコンテンツには、子コンポーネントのscopedスタイルは適用されません。 - 親コンポーネントのスタイル: 親コンポーネントで定義されたスタイル（
scopedまたは非scoped）は、スロット経由で子に挿入されたコンテンツに適用されます。スロットコンテンツは親のテンプレートの一部として扱われるためです。
これは、「スロットコンテンツは親コンポーネントのスコープで評価される」というルールに基づいています。コンテンツがどのスコープで評価されるかが、適用されるCSSのスコープを決定します。
例:
子コンポーネント ( StyledBox.vue ):
“`vue
“`
親コンポーネントでの使用例:
“`vue
これはスロットコンテンツです。
“`
この例では、子コンポーネントのスタイルシートにある p { color: green; } は、スロットコンテンツとして挿入された <p>これはスロットコンテンツです。</p> には適用されません。一方、親コンポーネントのスタイルシートにある p { color: red; ... } と button { background-color: yellow; } は、スロットコンテンツとして挿入された <p> と <button> に適用されます。最終的に、スロットコンテンツの <p> は親のスタイルによって赤色になります。
これは意図された挙動であり、スロットコンテンツの見た目はそれを記述した親コンポーネントが制御するという原則に基づいています。
子コンポーネントからスロットコンテンツにスタイルを適用したい場合
しかし、子コンポーネントがスロットコンテンツに対して特定のスタイルを適用したいケースも存在します。例えば、リストコンポーネントが各リストアイテムにパディングを適用したい場合などです。
-
子コンポーネントがラッパー要素を提供する: スロットコンテンツを子コンポーネント内で
<div class="item-wrapper"><slot></slot></div>のようなラッパー要素で囲み、そのラッパー要素にスタイルを適用するのが最もクリーンな方法です。親はラッパーを意識せずコンテンツを提供できます。vue
<!-- ItemList.vue (改良) -->
<template>
<ul>
<li v-for="item in items" :key="item.id">
<div class="list-item-content">
<slot :item="item"></slot>
</div>
</li>
</ul>
</template>
<style scoped>
.list-item-content {
padding: 8px 0; /* 子がコンテンツのラッパーにスタイルを適用 */
border-bottom: 1px solid #eee;
}
</style>
この方法が最も推奨されます。 -
CSS Deep Selectors: スコープ付きスタイルを使用している子コンポーネントから、スロットコンテンツ（親から挿入された要素）にスタイルを適用したい場合は、特殊なセレクター（deep selectors）を使用する必要があります。
- Vue 2.x では
>>>や/deep/が使用されました。 - Vue 3.x では
:deep()疑似要素が推奨されます。
vue
<!-- StyledBox.vue (Vue 3 の :deep() 例) -->
<template>
<div class="box">
<slot></slot>
</div>
</template>
<style scoped>
.box {
border: 2px dashed blue;
padding: 15px;
}
/* .box の中の要素に対してスタイルを適用（スロットコンテンツ含む）*/
.box :deep(p) {
color: green; /* スロットコンテンツの p が緑色になる */
}
.box :deep(button) {
border-color: green;
}
</style>
親コンポーネントのスタイルと競合する場合、詳細度（specificity）によってどちらのスタイルが優先されるかが決まります。:deep()は強力なセレクターなので、使用には注意が必要です。乱用するとスタイル間の依存関係が複雑になり、メンテナンス性が低下する可能性があります。可能な限り、ラッパー要素によるスタイリングを検討しましょう。 - Vue 2.x では
スロットとアクセシビリティ (A11y)
スロットを使用する際には、生成される最終的なDOM構造がアクセシビリティに配慮されているかどうかも考慮する必要があります。
- 役割と構造: スロットによって挿入されるコンテンツが、コンポーネント全体の構造の中で適切なセマンティックな役割を果たせるか確認します。例えば、リストコンポーネントのスロットに
<li>要素以外の要素（<div>など）を挿入すると、<ul>の直接の子が<li>ではないという不適切なHTML構造になり、スクリーンリーダーがリストとして認識できなくなる可能性があります。子コンポーネント側で<li>要素を提供し、その中にスロットを配置する設計 (<li><slot></slot></li>) が、リスト構造のアクセシビリティを保つ上で重要です。 - ARIA属性: 子コンポーネントで定義されるARIA属性と、スロットコンテンツで親が追加するARIA属性が競合したり、不適切な組み合わせになったりしないか確認します。例えば、子コンポーネントが特定の要素に
role="button"を付けているのに、親がスロットで挿入したコンテンツにも別の役割を持たせてしまうなどです。 - キーボード操作: スロットコンテンツに含まれるインタラクティブな要素（ボタン、リンク、フォーム要素など）が、キーボードで正しく操作（フォーカス、アクティベートなど）できるか確認します。これは主にスロットコンテンツ自体（親が提供する部分）の責任ですが、子コンポーネントがスロットの配置やラッパー要素によってフォーカス順序などを意図せず変更してしまう可能性もゼロではありません。
アクセシビリティを考慮したコンポーネントを設計する場合、スロットを使うことで親がDOM構造の一部を制御できるため、より柔軟なアクセシビリティ対応が可能になることもあります。しかし、逆に不適切な使い方をするとアクセシビリティを損なうリスクもあるため、最終的にレンダリングされるDOM構造を確認することが重要です。
スロットの内部挙動と注意点
スロットコンテンツの描画スコープ
Vueのリアクティブシステムにおいて、スロットコンテンツは親コンポーネントのスコープで評価されます。これは非常に重要なポイントです。
“`vue
子コンポーネント
子のデータ: {{ childData }}
親コンポーネント
親のデータ: {{ parentData }}
スロット内のデータ: {{ parentData }}
スロット内の子のデータへのアクセス (失敗): {{ childData }}
“`
この例の親コンポーネントでは、スロットコンテンツ <p>スロット内のデータ: {{ parentData }}</p> が記述されています。この {{ parentData }} は、ChildComponent の中ではなく、ParentComponent のデータである parentData を参照します。一方、{{ childData }} は ParentComponent のスコープには存在しないため、評価結果は undefined となります（開発モードでは警告が出る場合があります）。
この挙動は、親がスロットコンテンツの見た目や振る舞いを完全に制御できるという設計思想に基づいています。スロットコンテンツのリアクティブな更新は、親コンポーネントの状態変化によってトリガーされます。
スコープ付きスロットの特殊性
スコープ付きスロットは、この「親コンポーネントのスコープで評価される」という原則に則っています。スコープ付きスロットで子コンポーネントから親に渡されるデータ（スロットプロップス）は、親コンポーネントのテンプレート内の、そのスコープ付きスロットを受け取る <template> 要素のスコープで利用可能になります。
親コンポーネントの <template v-slot="{ item }"> の中で {{ item.name }} と記述した場合、item は子コンポーネントから渡されたスロットプロップスです。この item は親コンポーネントのデータとは別物ですが、親コンポーネントが提供したテンプレート（スロットコンテンツ）の中で、子から渡されたデータを使うことができるという仕組みです。これは、親が子からデータを受け取り、そのデータを使って自身のテンプレートの一部をレンダリングしていると考えるのが最も正確です。
パフォーマンスに関する考慮事項
一般的な場合において、スロットの使用が深刻なパフォーマンス問題を引き起こすことは稀です。Vueの仮想DOMシステムが効率的に更新を処理するためです。
しかし、大規模なリストなどでスコープ付きスロットを使用する場合、注意すべき点があります。v-for ループ内で各アイテムに対してスコープ付きスロットを使用し、スロットコンテンツが複雑な場合、リストのアイテム数が多いとその分レンダリングされるノードも多くなります。また、スロットプロップスに渡すデータやスロットコンテンツ内で使用するデータが頻繁に更新される場合、それに応じて再レンダリングが発生します。
ほとんどの場合、これはVueの最適化によって効率的に処理されますが、極端なケース（数千、数万のアイテムを表示し、各アイテムのスロットコンテンツが非常に複雑でリアクティブな依存関係が多いなど）ではパフォーマンスのボトルネックになる可能性もゼロではありません。
パフォーマンスが問題になる場合は、以下の点を検討します。
* 仮想リスト (Virtual Scrolling): 表示領域に収まるアイテムだけをレンダリングする手法。リスト全体のDOMを生成しないため、大量のデータを扱う場合に非常に有効です。スコープ付きスロットとも組み合わせて使用できます。
* スロットプロップスの最適化: 子コンポーネントから渡すスロットプロップスの量が膨大でないか、不要なリアクティブなオブジェクトを渡していないか確認します。
* スロットコンテンツのシンプル化: スロットコンテンツ自体のレンダリングコストが高い場合に、UIやロジックを見直す。
多くの場合、デフォルトのスロットの挙動で十分なパフォーマンスが得られます。パフォーマンス最適化は、実際に問題が発生した場合に検討すべきです。
key 属性とスロット
v-for と一緒にスロットを使用する場合、特にスコープ付きスロットの場合、<template v-slot="..." v-for="..." :key="..."> のように v-for を <template> タグに適用することがあります。この場合、key 属性は <template> にではなく、その内側にある繰り返されるルート要素に適用する必要があります。
“`vue
“`
ただし、上記の例のように、子コンポーネントの v-for と親コンポーネントの v-for が重複するのは冗長であり、混乱を招きやすいです。より推奨されるパターンは、ItemList のように子コンポーネントが v-for を担当し、親はそのループの各アイテムに対するコンテンツをスコープ付きスロットで提供するというものです。この場合、key 属性は子コンポーネントの v-for が付いた要素（通常はループのルート要素、ここでは <li>）に適切に設定されていれば十分です。親コンポーネントのスロットコンテンツ自体に key を付ける必要はありません。
よくある質問とトラブルシューティング
「スロットの中のデータにアクセスできない！」
問題: スロットコンテンツ内で、子コンポーネントの data や methods にアクセスしようとして undefined になる。
原因: スロットコンテンツは親コンポーネントのスコープで評価されるため、子コンポーネントのデータには直接アクセスできません。
解決策:
* 親のデータを使いたい場合: 親コンポーネントのデータやメソッドをそのまま使用します。
* 子のデータを使いたい場合: スコープ付きスロットを使用して、子コンポーネントから親にデータを渡してもらいます。親コンポーネントは v-slot="slotProps" または v-slot="{ childData }" のように受け取り、それを使用します。
「名前付きスロットがレンダリングされない！」
問題: <slot name="my-slot"> を定義したが、親コンポーネントで <template v-slot:my-slot> を使ってもコンテンツが表示されない。
原因:
* スロット名にタイプミスがある。
* <template> タグではなく、別の要素に v-slot を適用しているが、その要素がデフォルトスロット以外では無効である（Vue 3 の場合）。
* 子コンポーネント側で、該当の名前のスロット <slot name="my-slot"> がそもそも定義されていない。
* 子コンポーネントが条件付きレンダリング（v-if など）によって描画されず、スロットも描画されていない。
解決策:
* 子コンポーネントと親コンポーネントでスロット名が完全に一致しているか確認します。
* 名前付きスロットにコンテンツを提供する際は、<template v-slot:スロット名> または <template #スロット名> を使用します。
* 子コンポーネントのテンプレートに <slot name="my-slot"> が正しく記述されているか確認します。
「スコープ付きスロットのデータが表示されない！」
問題: スコープ付きスロットで子からデータを受け渡しているはずなのに、親のテンプレートで参照すると undefined になる。
原因:
* 子コンポーネントの <slot> タグで、データをスロットプロップスとして正しくバインド（:propName="value"）していない。
* 親コンポーネントの v-slot で、スロットプロップスを正しく受け取れていない（例: v-slot="slotProps" の slotProps を変数として利用できていない、または v-slot="{ propName }" の分割代入でプロパティ名が子から渡される名前と一致していない）。
* 子コンポーネントがデータを渡しているスコープ付きスロットの名前と、親コンポーネントが v-slot で指定している名前（デフォルトスロットなら v-slot または v-slot:default、名前付きなら v-slot:名前）が一致していない。
* スコープ付きスロットは <template> タグに v-slot を付けて使用するのが一般的だが、それ以外の要素に付けていないか。
解決策:
* 子コンポーネントの <slot> タグで、スロットプロップスが正しく属性としてバインドされているか確認します (<slot :item="itemData">)。属性名は親で参照する名前になります。
* 親コンポーネントで、v-slot の値としてスロットプロップスを受け取る変数名や分割代入の構文が正しいか確認します。受け取るオブジェクトの構造は子から渡される属性名によって決まります。
* 名前付きスコープ付きスロットの場合は、名前が一致しているか確認します (<slot name="mySlot" ...> と <template v-slot:mySlot="...">)。
* デバッグ時には、親コンポーネントの v-slot="slotProps" で受け取った slotProps オブジェクトの中身を {{ JSON.stringify(slotProps) }} などで一時的に表示してみると、どのようなデータが渡されているか確認できます。
レガシー構文 (slot/slot-scope) から v-slot への移行
Vue 2.6 より前のバージョンでは、単一スロットへのコンテンツ挿入は子コンポーネントのタグ間に直接記述、名前付きスロットは親コンポーネントの要素に slot="スロット名" 属性を付ける、スコープ付きスロットは子コンポーネントの <slot> にプロパティをバインドし、親コンポーネントの要素に slot-scope="scopeData" 属性を付けて受け取る、という構文が使われていました。
v-slot 構文は、これらの使い方（特に名前付きとスコープ付き）を <template> タグを使った単一のディレクティブに統合し、より一貫性があり分かりやすくなっています。また、スコープ付きスロットと名前付きスロットの組み合わせも v-slot でより自然に表現できるようになりました。
現在Vue 2.6以降やVue 3を使用している場合は、新しい v-slot 構文を使用することが強く推奨されます。レガシー構文はVue 3で完全に削除されました。既存のコードを移行する場合は、公式ドキュメントの移行ガイドを参照すると良いでしょう。主な置き換えルールは以下の通りです。
- 名前なしスロット:
<div slot>...</div>-><template v-slot:default>...</template>または<template>...</template>または子タグ間に直接 - 名前付きスロット (Vue 2.5以前):
<div slot="header">...</div>-><template v-slot:header>...</template>または<template #header>...</template> - スコープ付きスロット (Vue 2.5以前):
<div slot-scope="scope">...</div>-><template v-slot="scope">...</template> - 名前付きスコープ付きスロット (Vue 2.5以前):
<div slot="item" slot-scope="scope">...</div>-><template v-slot:item="scope">...</template>または<template #item="scope">...</template>
実践的なサンプルコード: データ表示テーブルコンポーネント
これまでに学んだスロットの基本、名前付きスロット、スコープ付きスロットを組み合わせて、より実践的な例として汎用的なデータ表示テーブルコンポーネントを作成してみましょう。
このコンポーネントは以下の機能を持つとします。
* データの配列を受け取り、テーブル (<table>, <thead>, <tbody>, <tr>, <td>) として表示する。
* ヘッダー行の内容は固定だが、必要に応じてカスタマイズできるようにする（名前付きスロット）。
* 各データ行の表示形式は、データの種類に応じて親コンポーネントが定義できるようにする（スコープ付きスロット）。
* 各カラムの表示形式も、親がアイテムデータとカラム名を元にカスタマイズできるようにする（名前付きスコープ付きスロット）。
子コンポーネント ( BaseTable.vue ):
“`vue
| {{ column.label || column }} |
|---|
|
{{ item[column.key || column] }} |
“`
親コンポーネントでの使用例:
この BaseTable を使って、ユーザーリストを表示してみましょう。特定のカラム（例: actions）は、ボタンなどを表示してカスタマイズしたいとします。
“`vue
“`
この例では、BaseTable コンポーネントはデータの構造 (<table>, <tr>, <td>) と基本的なループ処理を提供します。ヘッダー (<thead>) はデフォルトでは columns プロップスから自動生成されますが、<template #header> スロットを提供すれば完全にカスタマイズできます。
ボディ部分では、各行 (<tr>) は <slot name="row"> スロットで完全にカスタマイズできます。このスロットは item, rowIndex, columns を提供します。もし row スロットが提供されない場合、フォールバックとして各カラムがループ処理され、各カラムのセル (<td>) が生成されます。
さらに、各カラムのセルの中身は、<slot :name="column.key || column"> という名前付きスコープ付きスロットでカスタマイズできます。スロット名はカラムの key または名前になります。このスロットは item, rowIndex, colIndex を提供します。親コンポーネントでは、<template #email="{ item }"> や <template #actions="{ item }"> のように、カラム名に対応するスロットを提供することで、そのカラムの表示を自在に変更できます。actions カラムのように、columns プロップスにキーだけ定義しておき、実際の表示はスロットで完全に定義するという使い方も可能です。
この BaseTable コンポーネントは、データの構造を固定しつつ、ヘッダー、各行、そして各カラムの表示という様々なレベルで親コンポーネントによるカスタマイズを可能にしており、スロットがコンポーネントの柔軟性と再利用性向上にどのように貢献するかを示す良い例と言えるでしょう。
まとめ
Vue.jsのスロットは、コンポーネントの構造とコンテンツを分離するための強力なメカニズムです。プロップスがデータを渡すのに対し、スロットはDOM要素やコンポーネントといったテンプレートの断片を親から子に注入することを可能にします。
- 基本的なスロット (デフォルトスロット): 子コンポーネントの
<slot>タグの位置に、親コンポーネントの子要素として記述されたコンテンツを挿入します。フォールバックコンテンツを設定することも可能です。 - 名前付きスロット: 子コンポーネント内の複数の場所に異なるコンテンツを挿入したい場合に使用します。子コンポーネントは
<slot name="...">で挿入ポイントに名前を付け、親コンポーネントは<template v-slot:名前>または<template #名前>で対応するコンテンツを提供します。 - スコープ付きスロット: 子コンポーネントのデータを使って親コンポーネントがスロットコンテンツをレンダリングしたい場合に使用します。子コンポーネントは
<slot :propName="value">のようにスロットプロップスを渡し、親コンポーネントはv-slot="slotProps"やv-slot="{ propName }"でこれを受け取り、スロットコンテンツ内で利用します。名前付きスロットと組み合わせて使用することも可能です。 v-slotディレクティブ: Vue 2.6以降で推奨されるスロット構文です。<template>タグと共に使用し、デフォルトスロット、名前付きスロット、スコープ付きスロットの全てを統一的な記法で扱えます。省略記法#名前も便利です。- 高度な活用術: Renderless Components のようなパターンでは、スロットはロジックとUIを分離し、高い再利用性を実現するための鍵となります。
- スタイリング: スロットコンテンツは親コンポーネントのスコープで評価されるため、親のスタイルが適用されます。子コンポーネントからスロットコンテンツにスタイルを適用したい場合は、ラッパー要素の使用や
:deep()のような特殊セレクターを検討しますが、ラッパー要素が推奨される手法です。
スロットを効果的に使用することで、コンポーネントの再利用性が向上し、アプリケーション全体の保守性と拡張性が高まります。特に、デザインシステムの一部として汎用的なUIコンポーネントを作成する場合や、複雑なデータ表示コンポーネントを柔軟にカスタマイズ可能にしたい場合に、スロットは不可欠なツールとなります。
最初は少し複雑に感じるかもしれませんが、実際にコードを書きながら様々なスロットの使い方を試してみることで、その強力さと柔軟性を理解できるはずです。ぜひ本記事で解説した内容を参考に、ご自身のVue.js開発でスロットを積極的に活用してみてください。