Kurs Vue.js · Moduł 6: Komponenty

Komponenty - Moduły Budowlane Bazy

4 min czytania ·
W tej lekcji5

Witaj w Drukarni 3D NOVA LAB! Dr. Nova mówi: tak jak drukarka 3D tworzy modułowe części habitatu marsjańskiego, Ty nauczysz się tworzyć komponenty Vue - wielokrotnego użytku elementy aplikacji.

Do tej pory cały panel mieszkał w jednym pliku App.vue. To wystarcza na jeden ekran, ale baza rośnie: pięć identycznych kart modułów to pięć kopii tego samego HTML-a, a poprawka w jednej karcie wymaga poprawienia wszystkich pięciu. Komponent rozwiązuje ten problem - projektujesz element raz i używasz go dowolnie wiele razy.

Czego się nauczysz

  • tworzyć komponenty i nazywać je zgodnie z konwencją,
  • importować je lokalnie i rejestrować globalnie,
  • składać interfejs z drzewa komponentów,
  • uruchamiać kod w kolejnych fazach życia komponentu,
  • izolować style i wydzielać wspólną logikę do composables.

Czym jest Komponent?

Komponent to wielokrotnego użytku, samodzielna jednostka UI z własnym szablonem, logiką i stylami - jak moduł habitatowy, który można łączyć z innymi. Oto karta modułu zapisana w pliku ModuleCard.vue, najpierw szablon i dane:

<!-- ModuleCard.vue -->
<template>
  <article class="module-card" style="background: #0a0e27; border: 1px solid #00b4d8; color: #00ff88;">
    <div class="module-icon">◆</div>
    <h3>{{ moduleName }}</h3>
    <p>{{ moduleType }}</p>
    <p class="status">{{ status }}</p>
  </article>
</template>

<script setup>
import { ref } from 'vue'

const moduleName = ref('Oxygen Generator Alpha')
const moduleType = ref('Life Support')
const status = ref('ACTIVE')
</script>

Szablon pokazuje nazwę, typ i status modułu, a trzy kontenery ref() przechowują te dane - to ta sama składnia, której używałeś w Strefie Startowej. Nowe jest tylko to, że plik ma własną nazwę i zostanie użyty w innym miejscu. Obudowę karty zapisujemy w tym samym pliku, w sekcji ze stylami ograniczonymi do komponentu:

<style scoped>
.module-card {
  border-radius: 8px;
  padding: 1rem;
  max-width: 300px;
}

.module-icon {
  font-size: 3rem;
  text-align: center;
}

.status {
  color: #00ff88;
  font-weight: bold;
}
</style>

Sekcje ustawiamy w kolejności stosowanej w NOVA LAB od Strefy Startowej: <template>, <script setup>, <style scoped>. W edytorze zobaczysz też pliki z <script setup> na górze - to również poprawne, bo Vue wymaga tylko spójności w projekcie i stylu na końcu.

Używanie Komponentu

Żeby wydrukować kartę w bazie, importujemy plik w App.vue i używamy nazwy importu jak znacznika HTML:

<!-- App.vue -->
<template>
  <div class="production-bay" style="background: #0a0e27;">
    <ModuleCard />
    <ModuleCard />
    <ModuleCard />
  </div>
</template>

<script setup>
import ModuleCard from './components/ModuleCard.vue'
</script>

Każdy znacznik <ModuleCard /> tworzy osobną instancję komponentu z własnymi danymi, więc zmiana statusu w jednej karcie nie dotknie pozostałych. Plik ModuleCard.vue się nie zmienił i nie zmieni się bez względu na liczbę kopii. Na razie wszystkie trzy karty pokazują te same dane - przekazywanie każdej karcie innych wartości, czyli props, poznasz w Stacji Komunikacji. To właśnie główna zaleta architektury komponentowej: kod piszesz raz, używasz wielokrotnie, a poprawkę wprowadzasz w jednym miejscu.

Nazewnictwo Komponentów

Nazwy komponentów piszemy w PascalCase, czyli każde słowo wielką literą, bez spacji i podkreśleń. Tak samo nazywamy pliki: ModuleCard.vue, a nie module_card.vue czy moduleCard.vue:

<script setup>
// PascalCase - zalecane
import ArtworkCard from './ArtworkCard.vue'
import UserProfile from './UserProfile.vue'
import NavigationMenu from './NavigationMenu.vue'

// W template - PascalCase lub kebab-case
</script>

<template>
  <!-- PascalCase -->
  <ArtworkCard />
  <UserProfile />

  <!-- lub kebab-case -->
  <artwork-card />
  <user-profile />
</template>

W szablonach plików .vue działają obie formy znacznika, ale polecam PascalCase - od razu widać, że <UserProfile /> to komponent, a <div> to zwykły HTML. Druga zasada z oficjalnego przewodnika stylu mówi, że nazwa komponentu powinna mieć co najmniej dwa słowa. Wszystkie elementy HTML mają nazwy jednowyrazowe, więc komponent Card mógłby zderzyć się z przyszłym znacznikiem przeglądarki, a ModuleCard nie zderzy się nigdy. Wyjątkiem jest komponent główny App, a komponenty bazowe dostają przedrostek, na przykład BaseButton.

Organizacja Plików

Gdy komponentów przybywa, grupujemy je w podkatalogach src/components/ według roli, jaką pełnią w bazie:

src/
├── components/
│   ├── common/
│   │   ├── BaseButton.vue
│   │   ├── BasePanelCard.vue
│   │   └── BaseInput.vue
│   ├── modules/
│   │   ├── ModuleCard.vue
│   │   ├── ModuleList.vue
│   │   └── ModuleDetail.vue
│   └── layout/
│       ├── MissionHeader.vue
│       ├── ControlFooter.vue
│       └── NavSidebar.vue

Katalog common/ trzyma komponenty bazowe, modules/ karty i listy modułów, a layout/ elementy ramy ekranu. Komponenty wielokrotnego użytku zawsze trafiają do src/components/, a całe ekrany podpinane pod nawigację do znanego ze struktury projektu katalogu src/views/.

W edytorze poniżej App.vue używa komponentu PrinterStatusPanel trzy razy. Zobaczysz w nim defineProps i defineEmits - to kanały komunikacji ze Stacji Komunikacji, a dziś wystarczy, że panel jest osobnym plikiem zaimportowanym i użytym jak znacznik.

Zapamiętaj: komponent to wydrukowany moduł habitatu - projektujesz go raz, w pliku o wielowyrazowej nazwie w PascalCase, i montujesz w bazie tyle razy, ile potrzebujesz.

Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
import PrinterStatusPanel from './PrinterStatusPanel.vue'

const printers = ref([
  {
    id: 'p1',
    name: '3D Printer Alpha',
    status: 'printing',
    progress: 67,
    material: 'PLA Composite',
    temperature: 210
  },
  {
    id: 'p2',
    name: '3D Printer Beta',
    status: 'idle',
    progress: 0,
    material: 'Carbon Fiber',
    temperature: 25
  },
  {
    id: 'p3',
    name: '3D Printer Gamma',
    status: 'error',
    progress: 45,
    material: 'Titanium Alloy',
    temperature: 185
  }
])

function handlePrinterAction(printerId, action) {
  const printer = printers.value.find(p => p.id === printerId)
  if (printer) {
    console.log(`Action ${action} on ${printer.name}`)
    if (action === 'start') {
      printer.status = 'printing'
    } else if (action === 'stop') {
      printer.status = 'idle'
      printer.progress = 0
    } else if (action === 'pause') {
      printer.status = 'paused'
    }
  }
}
</script>

<template>
  <div class="printing-lab">
    <div class="header">
      <h1>Drukarnia 3D - NOVA LAB</h1>
      <p class="subtitle">Panel kontrolny drukarek 3D na Marsie</p>
    </div>

    <div class="info-panel">
      <h3>Definiowanie komponentów z props i emits</h3>
      <p>Komponenty przyjmują dane przez <strong>props</strong> i komunikują się przez <strong>emits</strong></p>
    </div>

    <div class="printers-grid">
      <PrinterStatusPanel
        v-for="printer in printers"
        :key="printer.id"
        :printer-id="printer.id"
        :printer-name="printer.name"
        :status="printer.status"
        :progress="printer.progress"
        :material="printer.material"
        :temperature="printer.temperature"
        @action="handlePrinterAction"
      />
    </div>
  </div>
</template>

<style scoped>
.printing-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: 2.5rem;
  color: #00ff88;
  text-shadow: 0 0 20px rgba(0, 255, 136, 0.5);
  margin: 0;
}

.subtitle {
  color: #00b4d8;
  font-size: 1.2rem;
  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;
}

.printers-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(350px, 1fr));
  gap: 1.5rem;
}
</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 jest komponent w Vue.js?

  2. 2. Jaka jest główna zaleta komponentowej architektury w Vue?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Utwórz komponent MarsModule.vue z sekcjami template, script setup i style scoped.

  • Klikanie w kolejności

    Ułóż sekcje Single File Component w kolejności stosowanej w NOVA LAB:

  • Edytor kodu

    Stwórz komponent StatusPanel.vue z ref() dla statusu i temperatury wyświetlanymi w template.

  1. PytanieCzym jest komponent Vue?
  2. PytanieZalety architektury komponentowej
  3. Zadanie z kodemPraktyka: Pierwszy komponent
  4. PytanieKonwencja nazewnictwa komponentów
  5. Kliknij w kolejnościStruktura Single File Component
  6. Zadanie z kodemPraktyka: Komponent z danymi

Przydatne artykuły