Kurs Vue.js · Moduł 7: Props i zdarzenia

Fallthrough Attributes

3 min czytania ·
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. 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.

  1. PytanieCzym są fallthrough attrs?
  2. Ułóż w kolejnościRęczne wiązanie attrs
  3. Zadanie z kodemPraktyka: Fallthrough attrs
  4. Kliknij w kolejnościSkładnia useAttrs
  5. Ułóż w kolejnościv-bind attrs w template
  6. Zadanie z kodemPraktyka: Multi-root attrs

Przydatne artykuły