feat(deploy): production deployment setup and fixes
- Debian-based api image (bookworm-slim), docker/debian mirrors, prisma binaryTargets for openssl 3.0 - nginx: admin SPA under /admin, TLS via acme.sh (ZeroSSL) + auto-renewal cron, http->https redirect - prisma: add origin_goods.delisted migration, sync missing schema (good_image/tag_font_color/good_tags), fix users.createdAt Timestamptz - api: CORS wildcard reflection, helmet CORP cross-origin, price backfill in persistProductDetail, categoryIcon ancestor fallback, mediaByColor per-color gallery in public goods detail - admin: /admin base path (vite + router) - import-data.mjs: udt_name casting, serial sequence advance fix
This commit is contained in:
yeuimu
+109
-109
@@ -1,109 +1,109 @@
|
||||
---
|
||||
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)
|
||||
---
|
||||
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)
|
||||
|
||||
Reference in New Issue
Block a user