Kurs Vue.js · Moduł 6: Komponenty

Rejestracja i Import Komponentów

4 min czytania ·
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ć?

CechaImport lokalnyRejestracja globalna
DostępnośćTylko w komponencie, który importujeWszędzie w aplikacji
Tree-shakingTak - nieużywane komponenty są usuwane z builduNie - zawsze w bundlu
CzytelnośćWidać zależności w <script setup>Ukryte zależności
ZastosowanieWiększość komponentówBazowe, 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: &lt;StatusPanel /&gt;</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. 1. Jak zaimportować komponent w <script setup>?

  2. 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:

  1. PytanieImport komponentu w script setup
  2. PytanieUżycie komponentu w template
  3. Zadanie z kodemPraktyka: Import i użycie komponentu
  4. Ułóż w kolejnościKroki importu komponentu
  5. PytanieAuto-rejestracja w script setup

Przydatne artykuły