f5792c40be
Pulled ALL skills from 15 source repositories: - anthropics/skills: 16 (docs, design, MCP, testing) - obra/superpowers: 14 (TDD, debugging, agents, planning) - coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth) - better-auth/skills: 5 (auth patterns) - vercel-labs/agent-skills: 5 (React, design, Vercel) - antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo) - Plus 13 individual skills from various repos Mosaic Stack is not limited to coding — the Orchestrator and subagents serve coding, business, design, marketing, writing, logistics, analysis, and more. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
110 lines
2.7 KiB
Markdown
110 lines
2.7 KiB
Markdown
---
|
|
title: Slot Name is Reserved and Not Included in Slot Props
|
|
impact: LOW
|
|
impactDescription: Expecting 'name' in scoped slot props when it's reserved causes confusion
|
|
type: gotcha
|
|
tags: [vue3, slots, scoped-slots, reserved-props, naming]
|
|
---
|
|
|
|
# Slot Name is Reserved and Not Included in Slot Props
|
|
|
|
**Impact: LOW** - When using scoped slots, the `name` attribute on the `<slot>` element is reserved for identifying the slot. It is not passed as part of the slot props to the parent component.
|
|
|
|
## Task Checklist
|
|
|
|
- [ ] Don't expect `name` in slot props - it's reserved
|
|
- [ ] Use a different prop name if you need to pass a name value
|
|
- [ ] Remember only explicitly bound attributes become slot props
|
|
|
|
**Incorrect Expectation:**
|
|
```vue
|
|
<!-- ChildComponent.vue -->
|
|
<template>
|
|
<div>
|
|
<slot name="header" title="Welcome"></slot>
|
|
</div>
|
|
</template>
|
|
```
|
|
|
|
```vue
|
|
<!-- ParentComponent.vue -->
|
|
<ChildComponent>
|
|
<template #header="props">
|
|
<!-- props = { title: "Welcome" } -->
|
|
<!-- 'name' is NOT included! -->
|
|
{{ props.name }} <!-- undefined -->
|
|
{{ props.title }} <!-- "Welcome" -->
|
|
</template>
|
|
</ChildComponent>
|
|
```
|
|
|
|
**If You Need to Pass a "Name" Value:**
|
|
```vue
|
|
<!-- ChildComponent.vue -->
|
|
<template>
|
|
<div>
|
|
<!-- Use a different prop name like 'slotName' or 'label' -->
|
|
<slot name="header" :label="slotLabel" :title="title"></slot>
|
|
</div>
|
|
</template>
|
|
|
|
<script setup>
|
|
const slotLabel = 'header'
|
|
const title = 'Welcome'
|
|
</script>
|
|
```
|
|
|
|
```vue
|
|
<!-- ParentComponent.vue -->
|
|
<ChildComponent>
|
|
<template #header="{ label, title }">
|
|
<h2>{{ title }}</h2>
|
|
<span>Section: {{ label }}</span>
|
|
</template>
|
|
</ChildComponent>
|
|
```
|
|
|
|
## What Gets Passed as Slot Props
|
|
|
|
| Attribute on `<slot>` | Passed to Parent? |
|
|
|----------------------|-------------------|
|
|
| `name` | No (reserved for slot identification) |
|
|
| `:text="message"` | Yes, as `text` |
|
|
| `:count="5"` | Yes, as `count` |
|
|
| `v-bind="object"` | Yes, spreads object properties |
|
|
| `class="..."` | No (not bound with `:`) |
|
|
|
|
## Multiple Named Slots Example
|
|
|
|
```vue
|
|
<!-- TabPanel.vue -->
|
|
<template>
|
|
<div class="tabs">
|
|
<slot name="tab1" :active="activeTab === 1" :label="'First Tab'"></slot>
|
|
<slot name="tab2" :active="activeTab === 2" :label="'Second Tab'"></slot>
|
|
</div>
|
|
</template>
|
|
|
|
<script setup>
|
|
import { ref } from 'vue'
|
|
const activeTab = ref(1)
|
|
</script>
|
|
```
|
|
|
|
```vue
|
|
<!-- Usage -->
|
|
<TabPanel>
|
|
<template #tab1="{ active, label }">
|
|
<!-- 'name' not available, but 'label' is -->
|
|
<button :class="{ active }">{{ label }}</button>
|
|
</template>
|
|
|
|
<template #tab2="{ active, label }">
|
|
<button :class="{ active }">{{ label }}</button>
|
|
</template>
|
|
</TabPanel>
|
|
```
|
|
|
|
## Reference
|
|
- [Vue.js Slots - Scoped Slots](https://vuejs.org/guide/components/slots.html#scoped-slots)
|