Kurs Vue.js · Moduł 6: Komponenty
Rejestracja i Import Komponentów
W tej lekcji4
Dr. Nova wyjaśnia: "W NOVA LAB każdy moduł habitatu musi być oficjalnie zarejestrowany w systemie stacji, zanim będzie mógł funkcjonować. Podobnie komponenty Vue muszą być zaimportowane lub zarejestrowane, aby można ich było użyć w szablonie."
Co się stanie, gdy wpiszesz w szablonie <StatusBar />, ale nie powiesz Vue, skąd wziąć ten komponent? Vue nie odgadnie ścieżki do pliku. W konsoli pojawi się ostrzeżenie "Failed to resolve component: StatusBar", a na stronie zostanie pusty, nieznany przeglądarce element. Rejestracja to właśnie ta informacja: jaki komponent kryje się pod daną nazwą.
Import w <script setup>
Najczęstszy i zalecany sposób to import lokalny w bloku <script setup>. Zaimportowany komponent jest automatycznie dostępny w szablonie - nie trzeba go nigdzie rejestrować! Zobacz panel dowodzenia, który składa się z trzech modułów:
<!-- MissionControl.vue -->
<template>
<div class="control-panel">
<ModuleCard />
<StatusBar />
<AlertPanel />
</div>
</template>
<script setup>
// Wystarczy zaimportować - komponent jest od razu dostępny w template!
import ModuleCard from './components/ModuleCard.vue'
import StatusBar from './components/StatusBar.vue'
import AlertPanel from './components/AlertPanel.vue'
</script>Plik .vue udostępnia swój komponent jako eksport domyślny, dlatego importujemy go bez klamer, a nazwa nadana w imporcie staje się nazwą znacznika w szablonie. Ścieżka zaczyna się od ./, więc jest względna. Równie dobrze możesz użyć aliasu z konfiguracji Vite: @/components/StatusBar.vue.
Zwróć uwagę: w Options API (bez <script setup>) musielibyśmy dodatkowo rejestrować komponenty w opcji components: {}. W Composition API z <script setup> ten krok jest zbędny - Vue automatycznie rozpoznaje zaimportowane komponenty. Porównaj oba zapisy:
<!-- Options API - wymaga ręcznej rejestracji -->
<script>
import ModuleCard from './components/ModuleCard.vue'
export default {
components: {
ModuleCard // Konieczna rejestracja!
}
}
</script>
<!-- Composition API <script setup> - auto-rejestracja -->
<script setup>
import ModuleCard from './components/ModuleCard.vue'
// Gotowe! Nie trzeba nic więcej.
</script>Import wygląda identycznie w obu wersjach - różnica tkwi w tym, co dzieje się po nim. Kompilator <script setup> sam zauważa, że ModuleCard jest używany w szablonie, i podpina go za Ciebie. Starszy zapis spotkasz w dokumentacji i w istniejących projektach, dlatego warto go rozpoznawać.
Rejestracja Globalna
Jeśli komponent jest używany w wielu miejscach aplikacji (np. przycisk, ikona), możesz go zarejestrować globalnie w pliku main.js, w tej samej sekwencji zapłonu, którą poznałeś w Strefie Startowej:
// main.js
import { createApp } from 'vue'
import App from './App.vue'
import BaseButton from './components/common/BaseButton.vue'
import BaseIcon from './components/common/BaseIcon.vue'
const app = createApp(App)
// Rejestracja globalna - dostępne wszędzie bez importu
app.component('BaseButton', BaseButton)
app.component('BaseIcon', BaseIcon)
app.mount('#app')Metoda app.component() przyjmuje nazwę i komponent, a jej wywołania stoją przed mount(), tak jak wywołania app.use(). Po rejestracji globalnej komponent jest dostępny w każdym szablonie bez konieczności importowania:
<!-- Dowolny komponent w aplikacji -->
<template>
<BaseButton>Uruchom moduł</BaseButton>
<BaseIcon name="rocket" />
</template>
<script setup>
// Nie trzeba importować BaseButton ani BaseIcon!
</script>Szablon wygląda tak samo jak przy imporcie lokalnym - zniknęła tylko linia import. Wygoda ma jednak cenę, którą pokazuje tabela.
Lokalne vs Globalne - Kiedy Co Wybrać?
| Cecha | Import lokalny | Rejestracja globalna |
|---|---|---|
| Dostępność | Tylko w komponencie, który importuje | Wszędzie w aplikacji |
| Tree-shaking | Tak - nieużywane komponenty są usuwane z buildu | Nie - zawsze w bundlu |
| Czytelność | Widać zależności w <script setup> | Ukryte zależności |
| Zastosowanie | Większość komponentów | Bazowe, często używane (Base*, App*) |
Dokumentacja Vue wskazuje dwie wady rejestracji globalnej: narzędzie budujące nie usunie nieużywanego komponentu z paczki, a w dużej aplikacji trudniej prześledzić, skąd komponent pochodzi. Dlatego import lokalny traktuj jako domyślny. Globalnie rejestruj tylko komponenty bazowe używane naprawdę często - to moja rekomendacja dla całej bazy.
PascalCase vs kebab-case w Szablonie
Vue pozwala używać obu konwencji nazewnictwa w szablonach. Komponent zaimportowany jako ModuleCard możesz zapisać także jako module-card:
<script setup>
import ModuleCard from './ModuleCard.vue'
import StatusBar from './StatusBar.vue'
</script>
<template>
<!-- PascalCase (zalecane w SFC) -->
<ModuleCard />
<StatusBar />
<!-- kebab-case (też działa) -->
<module-card />
<status-bar />
</template>Oba zapisy wstawią te same komponenty. PascalCase jest zalecane w Single File Components (.vue), bo:
- Łatwiej odróżnić komponenty Vue od natywnych elementów HTML
<ModuleCard />to komponent,<div>to HTML- Lepsza czytelność i spójność z nazwą pliku
Wyjątek dotyczy szablonów pisanych bezpośrednio w pliku HTML: przeglądarka ignoruje tam wielkość liter, więc trzeba użyć kebab-case i pełnego znacznika zamykającego. W plikach .vue tej pułapki nie ma, a samozamykający <ModuleCard /> działa bez problemu.
W edytorze poniżej App.vue importuje trzy komponenty: StatusPanel, ControlBar i InfoCard. Usuń jeden z importów i zobacz, że jego część panelu znika z podglądu.
Zapamiętaj: komponent jest jak moduł w rejestrze stacji - import lokalny wpisuje go do jednego panelu, a app.component() do całej bazy, więc sięgaj po rejestrację globalną tylko wtedy, gdy moduł naprawdę pracuje wszędzie.
Kod do tej lekcji: App.vue
<script setup>
import StatusPanel from './StatusPanel.vue'
import ControlBar from './ControlBar.vue'
import InfoCard from './InfoCard.vue'
// W <script setup> importowane komponenty sa automatycznie zarejestrowane
// Nie trzeba ich dodawac do components: {} - Vue robi to za nas!
</script>
<template>
<div class="registration-lab">
<div class="header">
<h1>Rejestracja Komponentow - NOVA LAB</h1>
<p class="subtitle">Import i auto-rejestracja w script setup</p>
</div>
<div class="info-panel">
<h3>Importowanie komponentow</h3>
<p>W <strong>script setup</strong> wystarczy zaimportowac komponent - Vue automatycznie go zarejestruje</p>
<p>Kazdy komponent to osobny plik <strong>.vue</strong> z wlasnym template, script i style</p>
</div>
<div class="components-grid">
<StatusPanel />
<ControlBar />
<InfoCard />
</div>
<div class="code-note">
<h3>Jak to dziala?</h3>
<p>1. Tworzymy plik komponentu (np. StatusPanel.vue)</p>
<p>2. Importujemy go: import StatusPanel from './StatusPanel.vue'</p>
<p>3. Uzywamy w template: <StatusPanel /></p>
<p>To wszystko! Zadnej dodatkowej rejestracji nie potrzeba.</p>
</div>
</div>
</template>
<style scoped>
.registration-lab {
background: linear-gradient(135deg, #0a0e27 0%, #1a1e3f 100%);
min-height: 100vh;
padding: 2rem;
color: #ffffff;
font-family: 'Courier New', monospace;
}
.header {
text-align: center;
margin-bottom: 2rem;
padding-bottom: 1rem;
border-bottom: 2px solid #00ff88;
}
.header h1 {
font-size: 2rem;
color: #00ff88;
text-shadow: 0 0 20px rgba(0, 255, 136, 0.5);
margin: 0;
}
.subtitle {
color: #00b4d8;
font-size: 1.1rem;
margin-top: 0.5rem;
}
.info-panel {
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
border-radius: 10px;
padding: 1.5rem;
margin-bottom: 2rem;
}
.info-panel h3 {
color: #00b4d8;
margin-top: 0;
}
.info-panel strong {
color: #00ff88;
}
.components-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
gap: 1.5rem;
margin-bottom: 2rem;
}
.code-note {
background: rgba(0, 0, 0, 0.4);
border-left: 4px solid #00ff88;
padding: 1.5rem;
border-radius: 8px;
}
.code-note h3 {
color: #00ff88;
margin-top: 0;
}
.code-note p {
color: #00b4d8;
margin: 0.5rem 0;
}
</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. Jak zaimportować komponent w <script setup>?
2. Jak użyć zaimportowanego komponentu w template?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Zaimportuj MarsModule i użyj go w App.vue.
- Układanie w pionie
Ułóż kroki importu komponentu w script setup: