Kurs Vue.js · Moduł 2: Składnia szablonów
Renderowanie List z v-for
W tej lekcji5
Jak baza NOVA wyświetla dane z wielu sensorów jednocześnie, v-for renderuje listę elementów.
Stacja ma dziesiątki czujników i ta liczba ciągle się zmienia: technicy montują nowe, zdejmują uszkodzone. Kopiowanie znacznika <li> dla każdego czujnika ręcznie nie wchodzi w grę, bo po każdej zmianie sprzętu trzeba by poprawiać szablon. Dyrektywa v-for powtarza element dla każdej pozycji z danych, a gdy dane się zmienią, lista na hologramie zmieni się razem z nimi.
Podstawowe v-for
Składnia przypomina pętlę z JavaScriptu: w v-for="sensor in sensors" słowo sensor to alias bieżącej pozycji, a sensors to tablica źródłowa. Zapis (sensor, index) daje też numer pozycji liczony od zera. Atrybut :key omówimy za chwilę - na razie wystarczy, że to unikalny identyfikator:
<template>
<div class="sensors-list" style="background: #0a0e27; padding: 1rem;">
<!-- Iteracja po tablicy -->
<ul style="list-style: none; color: #00ff88;">
<li v-for="sensor in sensors" :key="sensor.id"
style="border-left: 2px solid #00b4d8; padding: 0.5rem; margin: 0.5rem 0;">
{{ sensor.name }} - {{ sensor.value }}{{ sensor.unit }}
</li>
</ul>
<!-- Z indeksem -->
<div v-for="(sensor, index) in sensors" :key="sensor.id"
style="color: #00b4d8;">
[{{ index + 1 }}] {{ sensor.name }}: {{ sensor.value }}
</div>
</div>
</template>Na ekranie pojawią się trzy elementy li i trzy div z numerami od 1, bo do indeksu dodajemy jedynkę dla ludzi. Alias sensor istnieje tylko wewnątrz elementu z v-for. Zamiast in możesz też napisać of, bliżej składni iteratorów JavaScriptu.
Dane to tablica obiektów w refie:
<script setup>
import { ref } from 'vue'
const sensors = ref([
{ id: 1, name: 'Oxygen Level', value: 21.5, unit: '%' },
{ id: 2, name: 'Temperature', value: 22, unit: '°C' },
{ id: 3, name: 'Pressure', value: 101.3, unit: 'kPa' }
])
</script>Vue wykrywa metody zmieniające tablicę, takie jak push(), splice() czy sort(), więc nowy czujnik dodany przez push od razu pojawi się na liście. Metody filter() czy slice() zwracają nową tablicę i nie ruszają starej - wynik trzeba przypisać do sensors.value.
Iteracja po Obiektach
v-for przechodzi też po właściwościach obiektu. Aliasy to kolejno wartość, klucz i indeks, a kolejność odpowiada wynikowi Object.values():
<template>
<div class="module-specs" style="background: #0a0e27; padding: 1rem;">
<!-- Wartości -->
<div v-for="value in moduleDetails" :key="value" style="color: #00ff88;">
{{ value }}
</div>
<!-- Klucz i wartość -->
<div v-for="(value, key) in moduleDetails" :key="key"
style="color: #00b4d8; border-bottom: 1px solid #00ff8833; padding: 0.25rem;">
<strong>{{ key }}:</strong> {{ value }}
</div>
<!-- Klucz, wartość i indeks -->
<div v-for="(value, key, index) in moduleDetails" :key="key">
{{ index }}. {{ key }}: {{ value }}
</div>
</div>
</template>Ostatnia pętla wypisze na przykład 0. name: Reactor Core Alpha. W pierwszej wartość służy za klucz tylko dlatego, że wszystkie wartości są tu różne - bezpieczniej użyć nazwy właściwości. Sam obiekt jest zwykłym obiektem reaktywnym:
<script setup>
import { reactive } from 'vue'
const moduleDetails = reactive({
name: 'Reactor Core Alpha',
type: 'Plasma Fusion',
output: '500 MW',
location: 'Central Hub, Mars Base'
})
</script>Dlaczego :key jest ważny?
Bez klucza Vue aktualizuje listę strategią w miejscu: gdy kolejność danych się zmieni, nie przesuwa elementów, tylko poprawia zawartość każdego na jego pozycji. Dla samego tekstu to wystarcza, ale pole formularza albo komponent ze stanem zostaną wtedy przy złej pozycji. Unikalny :key nadaje każdemu elementowi tożsamość. Porównaj trzy warianty, z których każdy pokazuje sam znacznik otwierający:
<template>
<!-- DOBRZE - unikalne ID -->
<div v-for="item in items" :key="item.id">
<!-- ŹLE - indeks jako key (problemy przy sortowaniu/filtrowaniu) -->
<div v-for="(item, index) in items" :key="index">
<!-- ŹLE - brak key -->
<div v-for="item in items">
</template>Indeks jako klucz działa jak brak klucza, bo po sortowaniu ten sam numer dostaje inny czujnik. Brak klucza nie wywoła w Vue błędu ani ostrzeżenia w konsoli - wychwyci go dopiero linter (reguła vue/require-v-for-key z eslint-plugin-vue). Przy powtórzonych kluczach Vue w trybie deweloperskim ostrzega podczas aktualizacji listy. Klucz powinien być napisem lub liczbą, najlepiej identyfikatorem z danych.
v-for z v-if
Gdy chcesz pokazać tylko aktywne czujniki, kusi dopisanie v-if do elementu z v-for. W Vue 3 v-if ma jednak wyższy priorytet, więc nie widzi zmiennej sensor i render kończy się błędem. Są dwa poprawne wyjścia:
<template>
<div class="active-sensors">
<!-- DOBRZE - template wrapper -->
<template v-for="sensor in sensors" :key="sensor.id">
<div v-if="sensor.isActive" style="color: #00ff88;">
{{ sensor.name }}
</div>
</template>
<!-- LUB - filtr w computed -->
<div v-for="sensor in activeSensors" :key="sensor.id"
style="color: #00ff88; border-left: 2px solid #00ff88; padding: 0.5rem;">
{{ sensor.name }}
</div>
</div>
</template>Obie wersje pokażą te same nazwy. Przy <template v-for> klucz stoi na znaczniku <template>, a nie na dziecku - inaczej kompilator zgłosi błąd. Druga wersja korzysta z computed:
<script setup>
import { ref, computed } from 'vue'
const sensors = ref([
{ id: 1, name: 'Oxygen Level', isActive: true },
{ id: 2, name: 'Dust Filter', isActive: false },
{ id: 3, name: 'Pressure', isActive: true }
])
const activeSensors = computed(() =>
sensors.value.filter(s => s.isActive)
)
</script>Oryginalna tablica się nie zmienia - computed zwraca nową, przefiltrowaną. Dokumentacja Vue zaleca właśnie ten sposób i ja też go wybieram: szablon zostaje prosty, a filtr ma nazwę.
Zakres Liczb
v-for przyjmuje też liczbę całkowitą i powtarza element tyle razy. Uwaga: n zaczyna się od 1, nie od 0:
<template>
<div class="power-bars">
<!-- Renderuj 10 razy -->
<span v-for="n in 10" :key="n"
style="display: inline-block; width: 20px; height: 20px; background: #00ff88; margin: 2px;">
</span>
<!-- Wynik: 10 zielonych kwadratów -->
</div>
</template>Dziesięć kwadratów tworzy wskaźnik mocy, a z :class mógłbyś zapalać tylko te, dla których n nie przekracza poziomu energii. W następnej lekcji sięgniesz bezpośrednio po element takiej listy przez template refs.
Zapamiętaj: v-for to linia montażowa czujników, a :key to numer seryjny, po którym Vue rozpoznaje każdy egzemplarz.
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
const crewMembers = ref([
{ id: 1, name: 'Dr. Elena Rodriguez', role: 'Dowódca', specialization: 'Astrobiologia', status: 'active' },
{ id: 2, name: 'James Chen', role: 'Inżynier', specialization: 'Systemy mechaniczne', status: 'active' },
{ id: 3, name: 'Sarah Johnson', role: 'Naukowiec', specialization: 'Geologia', status: 'on-mission' },
{ id: 4, name: 'Marcus Williams', role: 'Pilot', specialization: 'Nawigacja', status: 'active' },
{ id: 5, name: 'Dr. Yuki Tanaka', role: 'Lekarz pokładowy', specialization: 'Medycyna kosmiczna', status: 'active' }
])
const missionLogs = ref([
{ id: 101, sol: 42, type: 'discovery', message: 'Znaleziono próbki lodowego rdzenia' },
{ id: 102, sol: 43, type: 'maintenance', message: 'Serwis paneli słonecznych zakończony' },
{ id: 103, sol: 44, type: 'research', message: 'Analiza składu mineralnego skał' },
{ id: 104, sol: 45, type: 'communication', message: 'Kontakt z Centrum Kontroli Misji' }
])
const equipment = ref([
{ id: 'eq1', name: 'Rover Explorer-1', status: 'operational', battery: 85 },
{ id: 'eq2', name: 'System wiertniczy', status: 'operational', battery: 92 },
{ id: 'eq3', name: 'Stacja meteorologiczna', status: 'maintenance', battery: 45 },
{ id: 'eq4', name: 'Zespół anten łączności', status: 'operational', battery: 100 }
])
const modules = ref([
{
id: 'm1',
name: 'Moduł mieszkalny',
sections: ['Kwatery załogi', 'Laboratorium', 'Szklarnia']
},
{
id: 'm2',
name: 'Moduł badawczy',
sections: ['Laboratorium chemiczne', 'Laboratorium biologiczne', 'Laboratorium geologiczne']
},
{
id: 'm3',
name: 'Moduł magazynowy',
sections: ['Magazyn żywności', 'Magazyn sprzętu', 'Zbiorniki wody']
}
])
function addCrewMember() {
const newId = Math.max(...crewMembers.value.map(m => m.id)) + 1
crewMembers.value.push({
id: newId,
name: 'Nowy rekrut',
role: 'Kadet',
specialization: 'Ogólna',
status: 'training'
})
}
function removeCrewMember(id) {
crewMembers.value = crewMembers.value.filter(member => member.id !== id)
}
function addLog() {
const newId = Math.max(...missionLogs.value.map(l => l.id)) + 1
const currentSol = Math.max(...missionLogs.value.map(l => l.sol)) + 1
missionLogs.value.unshift({
id: newId,
sol: currentSol,
type: 'info',
message: 'Nowy wpis w dzienniku misji'
})
}
</script>
<template>
<div class="mission-base">
<h1>Baza NOVA - Lista Zasobów</h1>
<!-- v-for z tablicą obiektów + :key -->
<section class="crew-section">
<div class="section-header">
<h2>Załoga ({{ crewMembers.length }} osób)</h2>
<button @click="addCrewMember" class="btn btn-add">+ Dodaj członka</button>
</div>
<div class="crew-grid">
<div
v-for="member in crewMembers"
:key="member.id"
class="crew-card"
:class="'status-' + member.status"
>
<div class="crew-header">
<h3>{{ member.name }}</h3>
<span class="role-badge">{{ member.role }}</span>
</div>
<p class="specialization">{{ member.specialization }}</p>
<div class="crew-footer">
<span class="status-badge" :class="member.status">
{{ member.status }}
</span>
<button @click="removeCrewMember(member.id)" class="btn-remove">×</button>
</div>
</div>
</div>
</section>
<!-- v-for z indeksem -->
<section class="logs-section">
<div class="section-header">
<h2>Dziennik Misji</h2>
<button @click="addLog" class="btn btn-add">+ Nowy wpis</button>
</div>
<div class="logs-list">
<div
v-for="(log, index) in missionLogs"
:key="log.id"
class="log-entry"
:class="'log-' + log.type"
>
<span class="log-number">#{{ index + 1 }}</span>
<span class="log-sol">Sol {{ log.sol }}</span>
<span class="log-type">{{ log.type }}</span>
<span class="log-message">{{ log.message }}</span>
</div>
</div>
</section>
<!-- v-for z zagnieżdżonymi pętlami -->
<section class="modules-section">
<h2>Moduły Bazy</h2>
<div class="modules-grid">
<div
v-for="module in modules"
:key="module.id"
class="module-card"
>
<h3>{{ module.name }}</h3>
<ul class="sections-list">
<li
v-for="(section, sectionIndex) in module.sections"
:key="module.id + '-' + sectionIndex"
class="section-item"
>
<span class="section-number">{{ sectionIndex + 1 }}.</span>
{{ section }}
</li>
</ul>
</div>
</div>
</section>
<!-- v-for po sprzęcie ze stylami zależnymi od stanu -->
<section class="equipment-section">
<h2>Sprzęt</h2>
<div class="equipment-list">
<div
v-for="item in equipment"
:key="item.id"
class="equipment-card"
>
<div class="equipment-name">{{ item.name }}</div>
<div class="equipment-status" :class="item.status">
{{ item.status }}
</div>
<div class="battery-container">
<div class="battery-label">Bateria:</div>
<div class="battery-bar">
<div
class="battery-fill"
:style="{ width: item.battery + '%' }"
:class="{
'battery-low': item.battery < 50,
'battery-medium': item.battery >= 50 && item.battery < 80,
'battery-high': item.battery >= 80
}"
>
{{ item.battery }}%
</div>
</div>
</div>
</div>
</div>
</section>
<div class="info-box">
<h3>v-for - Renderowanie List</h3>
<ul>
<li><strong>v-for="item in items"</strong> - iteracja po tablicy</li>
<li><strong>v-for="(item, index) in items"</strong> - z indeksem</li>
<li><strong>:key="item.id"</strong> - ZAWSZE używaj unikalnego klucza</li>
<li><strong>Zagnieżdżone pętle</strong> - możesz zagnieżdżać v-for</li>
<li><strong>v-for z :class/:style</strong> - dynamiczne stylowanie elementów listy</li>
</ul>
</div>
</div>
</template>
<style scoped>
.mission-base {
background: linear-gradient(135deg, #0a0e27 0%, #1a1e3f 100%);
min-height: 100vh;
padding: 2rem;
color: #ffffff;
font-family: 'Courier New', monospace;
}
h1 {
text-align: center;
color: #00ff88;
text-shadow: 0 0 20px rgba(0, 255, 136, 0.5);
margin-bottom: 3rem;
}
h2 {
color: #00b4d8;
margin-bottom: 1.5rem;
}
section {
background: rgba(0, 255, 136, 0.05);
border: 2px solid #00ff88;
border-radius: 10px;
padding: 1.5rem;
margin-bottom: 2rem;
}
.section-header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 1.5rem;
flex-wrap: wrap;
gap: 1rem;
}
.btn-add {
background: #00ff88;
color: #0a0e27;
border: none;
padding: 0.75rem 1.5rem;
border-radius: 5px;
font-weight: bold;
cursor: pointer;
font-family: 'Courier New', monospace;
transition: all 0.3s ease;
}
.btn-add:hover {
transform: scale(1.05);
box-shadow: 0 5px 15px rgba(0, 255, 136, 0.4);
}
.crew-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
gap: 1.5rem;
}
.crew-card {
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
border-radius: 8px;
padding: 1.5rem;
transition: all 0.3s ease;
}
.crew-card:hover {
transform: translateY(-5px);
box-shadow: 0 10px 30px rgba(0, 180, 216, 0.3);
}
.crew-card.status-on-mission {
border-color: #ffb400;
background: rgba(255, 180, 0, 0.1);
}
.crew-header {
display: flex;
justify-content: space-between;
align-items: start;
margin-bottom: 0.5rem;
}
.crew-header h3 {
color: #00ff88;
margin: 0;
font-size: 1.1rem;
}
.role-badge {
background: #00b4d8;
color: #ffffff;
padding: 0.25rem 0.75rem;
border-radius: 12px;
font-size: 0.8rem;
font-weight: bold;
}
.specialization {
color: #ffffff;
margin: 0.5rem 0;
font-size: 0.9rem;
}
.crew-footer {
display: flex;
justify-content: space-between;
align-items: center;
margin-top: 1rem;
}
.status-badge {
padding: 0.25rem 0.75rem;
border-radius: 12px;
font-size: 0.8rem;
font-weight: bold;
text-transform: uppercase;
}
.status-badge.active {
background: rgba(0, 255, 136, 0.3);
color: #00ff88;
}
.status-badge.on-mission {
background: rgba(255, 180, 0, 0.3);
color: #ffb400;
}
.status-badge.training {
background: rgba(0, 180, 216, 0.3);
color: #00b4d8;
}
.btn-remove {
background: #ff0055;
color: #ffffff;
border: none;
width: 30px;
height: 30px;
border-radius: 50%;
font-size: 1.5rem;
cursor: pointer;
display: flex;
align-items: center;
justify-content: center;
transition: all 0.3s ease;
}
.btn-remove:hover {
transform: scale(1.1);
box-shadow: 0 0 10px rgba(255, 0, 85, 0.5);
}
.logs-list {
display: flex;
flex-direction: column;
gap: 0.75rem;
}
.log-entry {
display: grid;
grid-template-columns: auto auto auto 1fr;
gap: 1rem;
padding: 1rem;
background: rgba(0, 180, 216, 0.1);
border-left: 4px solid #00b4d8;
border-radius: 5px;
align-items: center;
transition: all 0.3s ease;
}
.log-entry:hover {
background: rgba(0, 180, 216, 0.2);
transform: translateX(5px);
}
.log-entry.log-discovery {
border-left-color: #00ff88;
}
.log-entry.log-maintenance {
border-left-color: #ffb400;
}
.log-number {
color: #00b4d8;
font-weight: bold;
font-size: 0.9rem;
}
.log-sol {
color: #00ff88;
font-weight: bold;
}
.log-type {
background: rgba(0, 255, 136, 0.2);
color: #00ff88;
padding: 0.25rem 0.75rem;
border-radius: 12px;
font-size: 0.8rem;
text-transform: uppercase;
}
.log-message {
color: #ffffff;
}
.modules-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
gap: 1.5rem;
}
.module-card {
background: rgba(0, 255, 136, 0.1);
border: 2px solid #00ff88;
border-radius: 8px;
padding: 1.5rem;
}
.module-card h3 {
color: #00ff88;
margin-top: 0;
margin-bottom: 1rem;
}
.sections-list {
list-style: none;
padding: 0;
margin: 0;
}
.section-item {
padding: 0.75rem;
background: rgba(0, 180, 216, 0.1);
border-radius: 5px;
margin-bottom: 0.5rem;
color: #ffffff;
transition: all 0.3s ease;
}
.section-item:hover {
background: rgba(0, 180, 216, 0.2);
transform: translateX(5px);
}
.section-number {
color: #00b4d8;
font-weight: bold;
margin-right: 0.5rem;
}
.equipment-list {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
gap: 1.5rem;
}
.equipment-card {
background: rgba(0, 180, 216, 0.1);
border: 2px solid #00b4d8;
border-radius: 8px;
padding: 1.5rem;
}
.equipment-name {
color: #00ff88;
font-weight: bold;
font-size: 1.1rem;
margin-bottom: 0.5rem;
}
.equipment-status {
padding: 0.25rem 0.75rem;
border-radius: 12px;
font-size: 0.8rem;
font-weight: bold;
display: inline-block;
margin-bottom: 1rem;
text-transform: uppercase;
}
.equipment-status.operational {
background: rgba(0, 255, 136, 0.3);
color: #00ff88;
}
.equipment-status.maintenance {
background: rgba(255, 180, 0, 0.3);
color: #ffb400;
}
.battery-container {
margin-top: 1rem;
}
.battery-label {
color: #ffffff;
font-size: 0.9rem;
margin-bottom: 0.5rem;
}
.battery-bar {
background: rgba(255, 255, 255, 0.1);
border-radius: 10px;
height: 30px;
overflow: hidden;
}
.battery-fill {
height: 100%;
display: flex;
align-items: center;
justify-content: center;
font-weight: bold;
font-size: 0.9rem;
transition: all 0.3s ease;
}
.battery-low {
background: linear-gradient(90deg, #ff0055, #ff6600);
}
.battery-medium {
background: linear-gradient(90deg, #ffb400, #ffd700);
color: #0a0e27;
}
.battery-high {
background: linear-gradient(90deg, #00ff88, #00b4d8);
color: #0a0e27;
}
.info-box {
background: rgba(0, 255, 136, 0.05);
border: 2px solid #00ff88;
border-radius: 10px;
padding: 1.5rem;
margin-top: 2rem;
}
.info-box h3 {
color: #00ff88;
margin-top: 0;
}
.info-box ul {
list-style: none;
padding: 0;
}
.info-box li {
padding: 0.5rem 0;
color: #ffffff;
border-left: 3px solid #00b4d8;
padding-left: 1rem;
margin: 0.5rem 0;
}
.info-box strong {
color: #00b4d8;
}
</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 iterować po tablicy w Vue?
2. Dlaczego :key jest ważny w v-for?
3. Jak uzyskać indeks elementu w v-for?
4. Jak w v-for odczytać jednocześnie wartość i klucz każdej właściwości obiektu?
5. Która praktyka jest zalecana gdy chcesz filtrować elementy listy?
Zadania praktyczne w grze
- Edytor kodu
Użyj v-for do renderowania listy sensorów z :key i indeksem.
- Klikanie w kolejności
Ułóż składnię v-for z :key (najpierw v-for, potem :key):
- Układanie w pionie
Uporządkuj argumenty v-for po obiekcie od wartości do indeksu:
- Układanie w poziomie
Ułóż poprawną składnię v-for z :key:
- Edytor kodu
Użyj v-for do iteracji po właściwościach obiektu (value, key, index).
- Układanie w pionie
Ułóż od najlepszego do najgorszego sposobu ustawiania :key:
- Klikanie w kolejności
Ułóż poprawne użycie template wrapper z v-for i v-if:
Zadania po tej lekcji
- PytanieSkładnia v-for
- PytanieAtrybut :key w v-for
- Zadanie z kodemPraktyka: v-for lista
- Kliknij w kolejnościSkładnia v-for z key
- Pytaniev-for z indeksem
- Ułóż w kolejnościArgumenty v-for po obiekcie
- Ułóż w kolejnościSkładnia v-for z key
- Pytaniev-for po właściwościach obiektu
- Zadanie z kodemPraktyka: v-for po obiekcie
- Ułóż w kolejnościPoprawne użycie :key
- Pytaniev-for z v-if - dobra praktyka
- Kliknij w kolejnościSkładnia v-for z template wrapper