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

Provide / Inject

4 min czytania ·
W tej lekcji5

Gdy NOVA LAB nadaje komunikat dla całej kolonii, nie przesyła go przez każdy moduł z osobna - używa systemu broadcast. W Vue ten mechanizm to provide/inject - przekazywanie danych przez wiele poziomów bez prop drilling.

Weźmy motyw kolorystyczny paneli. Ustawia go centrala w komponencie App, a potrzebuje go przycisk głęboko w pasku bocznym. Z samymi props motyw musiałby przejść przez Layout, Page i Sidebar, choć żaden z nich go nie używa - każdy tylko podaje go dalej. To właśnie prop drilling: kod pośredników puchnie, a zmiana nazwy propsa oznacza poprawki na każdym piętrze stacji.

Problem Prop Drilling

Bez provide/inject musisz przekazywać props przez każdy poziom, nawet jeśli pośrednicy wcale ich nie potrzebują:

App → Layout → Page → Sidebar → DeepChild
(theme)  (theme)  (theme)  (theme)  (theme)

Z provide/inject przodek nadaje wartość raz, a odbiera ją tylko ten potomek, który naprawdę jej potrzebuje:

App (provide theme) → ... → DeepChild (inject theme)

Pośrednicy zostają nietknięci: nie deklarują propsa theme i nawet nie wiedzą, że sygnał przez nich przechodzi.

Podstawy Provide/Inject

Funkcja provide(klucz, wartość) wywołana w przodku udostępnia wartość całemu jego poddrzewu, a funkcja inject(klucz) w dowolnym potomku ją odbiera. Kluczem jest napis albo Symbol, a drugi argument inject to wartość domyślna na wypadek, gdyby żaden przodek niczego nie nadał. Obie funkcje importujesz z vue i wywołujesz synchronicznie w <script setup>:

<!-- Provider (przodek) -->
<script setup>
import { provide, ref } from 'vue'

const theme = ref('dark')
provide('theme', theme)
provide('labName', 'NOVA LAB Alpha')
</script>

<!-- Consumer (dowolny potomek) -->
<script setup>
import { inject } from 'vue'

const theme = inject('theme')
const labName = inject('labName')

// Z domyślną wartością
const mode = inject('mode', 'standard')
</script>

Jeśli potomek poprosi o klucz, którego nikt nie udostępnił, i nie poda wartości domyślnej, dostanie undefined, a Vue wypisze w konsoli ostrzeżenie. Dlatego mode ma tu wartość domyślną 'standard', a pozostałe dwa klucze pochodzą od przodka.

Reaktywne Provide

provide przekazuje wartość dosłownie. Zwykły napis dotrze do potomka jako napis i nie pokaże późniejszych zmian. Przekazuj ref() lub reactive(), aby dane były reaktywne - potomek dostanie wtedy ten sam obiekt i zobaczy każdą zmianę. Funkcja readonly opakowuje go w wersję tylko do odczytu:

<!-- Provider -->
<script setup>
import { provide, ref, readonly } from 'vue'

const count = ref(0)

// Readonly - potomek nie może modyfikować
provide('count', readonly(count))

// Akcje do modyfikacji
provide('increment', () => count.value++)
</script>

<!-- Consumer -->
<script setup>
import { inject } from 'vue'

const count = inject('count')       // readonly ref
const increment = inject('increment') // funkcja
</script>

Potomek czyta count i odświeża się razem z nim, ale próba przypisania skończy się ostrzeżeniem w konsoli, a wartość się nie zmieni. Zmiany idą przez udostępnioną funkcję increment, więc mutacja stanu zostaje u dostawcy. W szablonie ref rozpakuje się sam, a w skrypcie odczytasz go przez count.value.

App-level Provide

Globalne provide w main.ts udostępnia wartość wszystkim komponentom aplikacji. Metodę provide ma sam obiekt aplikacji zwrócony przez createApp:

const app = createApp(App)
app.provide('apiUrl', 'https://mars-api.novalab.space')
app.mount('#app')

Wywołanie stoi przed app.mount, tak jak rejestracja wtyczek. Z tego mechanizmu korzystają zresztą same wtyczki, bo nie mają własnego komponentu, w którym mogłyby wywołać provide.

Typowane Klucze (InjectionKey)

W dużej aplikacji dwa zespoły mogą nieświadomie użyć tego samego klucza tekstowego. Dokumentacja poleca wtedy klucze typu Symbol, eksportowane z jednego pliku. W TypeScript typ InjectionKey dopina do symbolu typ przesyłanej wartości. Fragmenty Provider i Consumer poniżej pochodzą z dwóch różnych komponentów:

import type { InjectionKey, Ref } from 'vue'

export const themeKey: InjectionKey<Ref<string>> = Symbol('theme')

// Provider
provide(themeKey, ref('dark'))

// Consumer - TypeScript wie, że to Ref<string> | undefined
const theme = inject(themeKey)

Wynik inject ma w typie dopisek undefined, bo kompilator nie ma pewności, że któryś przodek wywołał provide. Wystarczy podać wartość domyślną, na przykład inject(themeKey, ref('light')), a typ zawęzi się do Ref<string>. Z kolei provide(themeKey, 'dark') z samym napisem zostanie odrzucone już przy kompilacji.

Moja rada: provide i inject rezerwuj dla danych potrzebnych całemu poddrzewu - motywu, zalogowanego członka załogi, konfiguracji. Dla relacji rodzic-dziecko props pozostają czytelniejsze. Mutacje zawsze trzymaj u dostawcy: stan udostępniaj przez readonly, a zmiany przez funkcje. W edytorze poniżej MissionControl stoi pośrodku i nie przekazuje żadnych props, a DeepChild i tak odbiera motyw. Ten wzorzec rozwiniesz w lekcji o zaawansowanych wzorcach komunikacji.

Zapamiętaj: provide to nadajnik rozgłoszeniowy stacji, a inject to odbiornik, który zamontujesz na dowolnym piętrze poniżej.

Kod do tej lekcji: App.vue
<script setup>
import { provide, ref, readonly } from 'vue'
import MissionControl from './MissionControl.vue'

const theme = ref('dark')
const missionMode = ref('eksploracja')

// Provide reaktywnych danych (readonly)
provide('theme', readonly(theme))
provide('missionMode', readonly(missionMode))

// Provide akcji do modyfikacji
provide('toggleTheme', () => {
  theme.value = theme.value === 'dark' ? 'light' : 'dark'
})
provide('setMission', (mode) => {
  missionMode.value = mode
})
</script>

<template>
  <div class="nova-lab" :class="theme">
    <h1>Demo: provide / inject</h1>
    <p>Motyw: {{ theme }} | Misja: {{ missionMode }}</p>

    <button @click="theme = theme === 'dark' ? 'light' : 'dark'">
      Przełącz motyw
    </button>

    <MissionControl />
  </div>
</template>

<style scoped>
.nova-lab {
  min-height: 100vh;
  padding: 20px;
  font-family: monospace;
}
.nova-lab.dark {
  background: #0a0e27;
  color: #00ff88;
}
.nova-lab.light {
  background: #f0f4f8;
  color: #1a1a2e;
}
h1 { margin-bottom: 15px; }
button {
  background: #00b4d8;
  color: #0a0e27;
  border: none;
  padding: 8px 16px;
  cursor: pointer;
  margin: 10px 5px;
  font-family: monospace;
}
</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. Do czego służy provide/inject w Vue?

  2. 2. Jak zapewnić reaktywność w provide/inject?

Zadania praktyczne w grze

  • Układanie w pionie

    Uporządkuj kroki użycia provide/inject:

  • Edytor kodu

    Użyj provide/inject do przekazania theme (dark/light) w całej aplikacji.

  • Klikanie w kolejności

    Ułóż kod reaktywnego provide:

  • Edytor kodu

    Stwórz provider z reaktywnym stanem marsWeather (ref) i metodą updateWeather.

  1. PytanieCel provide/inject
  2. Ułóż w kolejnościPrzepływ provide/inject
  3. Zadanie z kodemPraktyka: Provide/Inject
  4. PytanieReaktywne provide
  5. Kliknij w kolejnościSkładnia provide z reactive
  6. Zadanie z kodemPraktyka: Reactive provide

Przydatne artykuły