Kurs Vue.js · Moduł 6: Komponenty
Komponenty - Moduły Budowlane Bazy
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.vueKatalog 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. Co to jest komponent w Vue.js?
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.