Kurs Vue.js · Moduł 7: Props i zdarzenia
Fallthrough Attributes
W tej lekcji5
Sygnały telemetryczne, które nie są zdefiniowane jako props, automatycznie "przenikają" do głównego elementu komponentu - jak dane z czujników do centralnego procesora NOVA LAB. Ten mechanizm nazywa się fallthrough attributes i jest ważnym aspektem tworzenia elastycznych komponentów.
Automatyczne Dziedziczenie
Atrybuty przekazane do komponentu, które NIE są zadeklarowane jako props ani emity, automatycznie trafiają do root elementu szablonu:
<!-- Rodzic -->
<CustomInput class="special" data-testid="email" />
<!-- CustomInput.vue (root = input) -->
<template>
<input type="text" />
</template>
<!-- Wynik w DOM -->
<input type="text" class="special" data-testid="email" />Dotyczy to: class, style, id, data-*, event listenerów i innych atrybutów HTML. To zachowanie jest bardzo przydatne - pozwala użytkownikowi komponentu dodawać klasy CSS, style inline czy atrybuty dostępności bez konieczności definiowania ich jako props.
Łączenie klas i stylów
Jeśli root element komponentu ma już własne class lub style, Vue automatycznie je łączy (merge) z atrybutami z rodzica:
<!-- Rodzic -->
<StatusPanel class="highlighted" style="margin-top: 10px" />
<!-- StatusPanel.vue -->
<template>
<div class="panel" style="padding: 1rem">...</div>
</template>
<!-- Wynik w DOM - klasy i style połączone -->
<div class="panel highlighted" style="padding: 1rem; margin-top: 10px">...</div>Dziedziczenie event listenerów
Listenery zdarzeń również przechodzą. Jeśli rodzic przekaże @click, zostanie on dodany do root elementu:
<!-- Rodzic -->
<MarsButton @click="handleClick" />
<!-- MarsButton.vue -->
<template>
<button @click="logInternal">Kliknij</button>
</template>W tym przypadku kliknięcie przycisku wywoła oba handlery - najpierw logInternal z komponentu, potem handleClick z rodzica.
Wyłączenie Dziedziczenia
Gdy chcesz kontrolować dokładnie, gdzie trafiają atrybuty (np. chcesz je przypisać do wewnętrznego elementu zamiast root), użyj inheritAttrs: false:
<script setup>
defineOptions({ inheritAttrs: false })
</script>
<template>
<div class="wrapper">
<!-- Ręczne przypisanie do konkretnego elementu -->
<input v-bind="$attrs" type="text" />
</div>
</template>To jest częsty wzorzec w komponentach formularzy - wrapper <div> służy do stylowania, a $attrs trafiają bezpośrednio na <input>, gdzie są najbardziej użyteczne (np. placeholder, disabled, aria-label).
useAttrs()
Dostęp do atrybutów w <script setup> uzyskujesz przez composable useAttrs():
<script setup>
import { useAttrs } from 'vue'
const attrs = useAttrs()
console.log(attrs.class) // "special"
console.log(attrs['data-testid']) // "email"
console.log(attrs.style) // obiekt stylów
</script>Uwaga: useAttrs() NIE jest reaktywne - jeśli potrzebujesz reagować na zmiany atrybutów, użyj $attrs bezpośrednio w szablonie lub onUpdated hook.
Multi-root Components
Gdy komponent ma wiele root elementów (fragments), Vue nie wie, do którego przypisać fallthrough attributes. Musisz jawnie przypisać $attrs do wybranego elementu:
<script setup>
defineOptions({ inheritAttrs: false })
</script>
<template>
<header>Header</header>
<main v-bind="$attrs">Content</main>
<footer>Footer</footer>
</template>Bez inheritAttrs: false i jawnego v-bind="$attrs", Vue wyświetli ostrzeżenie w konsoli. To wymaga świadomej decyzji - który element ma "dziedziczyć" atrybuty z rodzica.
Praktyczny przykład - komponent panelu NOVA LAB
Połączmy wszystkie koncepcje w jednym przykładzie:
<script setup>
import { useAttrs } from 'vue'
defineOptions({ inheritAttrs: false })
defineProps({ title: String })
const attrs = useAttrs()
const hasCustomClass = !!attrs.class
</script>
<template>
<section class="nova-panel">
<h3>{{ title }}</h3>
<div v-bind="$attrs" class="panel-content">
<slot />
</div>
<small v-if="hasCustomClass">Custom styling applied</small>
</section>
</template>Dzięki temu wzorcowi rodzic może przekazać class, style, id i inne atrybuty, które trafią dokładnie na panel-content, a nie na zewnętrzną <section>.
Kod do tej lekcji: App.vue
<script setup>
import CustomInput from './CustomInput.vue'
import MultiRoot from './MultiRoot.vue'
</script>
<template>
<div class="nova-lab">
<h1>Fallthrough Attributes</h1>
<h2>Automatyczne dziedziczenie:</h2>
<CustomInput
class="special-input"
data-testid="mars-input"
placeholder="Wpisz tutaj..."
/>
<h2>inheritAttrs: false + ręczne wiązanie:</h2>
<MultiRoot
class="highlighted"
id="main-section"
data-role="content"
/>
</div>
</template>
<style scoped>
.nova-lab {
background: #0a0e27;
color: #00ff88;
min-height: 100vh;
padding: 20px;
font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 20px; }
h2 { color: #00b4d8; margin: 15px 0 10px; }
.special-input { border-color: #ff9900 !important; }
.highlighted { background: rgba(0, 255, 136, 0.15) !important; }
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Co to są fallthrough attributes w Vue?
Zadania praktyczne w grze
- Układanie w pionie
Uporządkuj kroki ręcznego wiązania attrs:
- Edytor kodu
Wyłącz inheritAttrs i ręcznie bind attrs do konkretnego elementu input.
- Klikanie w kolejności
Ułóż kod dostępu do attrs w script setup:
- Układanie w poziomie
Ułóż ręczne wiązanie attrs w template:
- Edytor kodu
Stwórz komponent z header, main i footer, przypisując $attrs tylko do main.