...
← Curs Angular: toate lecțiile
Lecția 12 · Control flow

Liste cu @for și track

Aproape orice aplicație afișează liste: produse, mesaje, comenzi. Cu blocul @for repeți o bucată de HTML pentru fiecare element dintr-o listă, iar track îl ajută pe Angular să știe care element este care.

Blocul @for

@for (element of lista; track ...) { ... } creează conținutul dintre acolade o dată pentru fiecare element:

import { Component, signal } from '@angular/core';

@Component({
  selector: 'app-root',
  template: `
    <ul>
      @for (oras of orase(); track oras) {
        <li>{{ oras }}</li>
      }
    </ul>
  `
})
export class App {
  orase = signal(['București', 'Cluj', 'Timișoara']);
}

Rezultatul este o listă cu trei li: București, Cluj, Timișoara. Variabila oras există doar în interiorul blocului și are pe rând valoarea fiecărui element.

De ce este track obligatoriu

Când lista se schimbă (adaugi, ștergi, reordonezi), Angular nu vrea să refacă toată lista din pagină. track îi spune după ce recunoaște un element: dacă ID-ul există deja, reutilizează elementul din pagină; dacă e nou, îl creează.

Tipul listeiCe pui la track
obiecte cu idtrack p.id (cea mai bună alegere)
texte unicetrack oras
fără nimic unictrack $index (ultima variantă)
Important

Dacă uiți track, primești o eroare de șablon: Angular modern îl cere întotdeauna. În codul vechi cu *ngFor era opțional (trackBy) și mulți îl uitau, de aceea a devenit obligatoriu.

Liste de obiecte și $index

De obicei elementele sunt obiecte. În interiorul blocului ai și câteva variabile speciale:

import { Component, signal } from '@angular/core';

interface Carte { id: number; titlu: string; }

@Component({
  selector: 'app-root',
  template: `
    <ol>
      @for (c of carti(); track c.id; let i = $index) {
        <li>{{ i + 1 }}. {{ c.titlu }} @if ($last) { (ultima) }</li>
      }
    </ol>
  `
})
export class App {
  carti = signal<Carte[]>([
    { id: 1, titlu: 'Moromeții' },
    { id: 2, titlu: 'Enigma Otiliei' }
  ]);
}
  • $index: poziția, de la 0 (de aceea afișăm $index + 1). Îl poți folosi direct sau îi dai alt nume cu let i = $index.
  • $first / $last: adevărat pentru primul / ultimul element.
  • $count: câte elemente are lista.
  • $even / $odd: poziție pară / impară, utile pentru rânduri colorate alternativ.

Lista goală: @empty

Ce afișezi când nu e nimic de afișat? Blocul @empty vine imediat după @for și apare doar când lista are 0 elemente:

@for (m of mesaje(); track m.id) {
  <li>{{ m.text }}</li>
} @empty {
  <li class="gol">Nu ai niciun mesaj.</li>
}

Un mesaj pentru lista goală face aplicația mult mai clară: utilizatorul înțelege că nu e o eroare, ci pur și simplu nu există date încă.

Schimbarea listei

Lista stă într-un signal, așa că o schimbi punând o listă nouă. Pentru a scoate ultimul element, slice(0, -1) din TypeScript întoarce o listă nouă fără el:

stergeUltimul() {
  this.produse.update(lista => lista.slice(0, -1));
}
1
Click pe buton: metoda apelează update.
2
Funcția primește lista veche și întoarce una nouă, mai scurtă.
3
Angular compară noua listă cu cea veche după track și scoate din pagină doar li-ul care lipsește.

Greșeli frecvente

  • Lipsește track: eroare de șablon „@for fără track”.
  • @for (p in produse()): cuvântul corect este of, nu in.
  • @for (p of produse; ...): fără () la signal, lista nu este citită.
  • lista.push(x) pe lista din signal: modifici lista veche, iar Angular nu află. Folosește update(l => [...l, x]).
  • track $index la o listă care se reordonează: Angular confundă elementele; folosește un id.

Unde întâlnești asta

MAGAZINCatalogul de produse

Fiecare card de produs este un element din @for, recunoscut după id.

EMAILInbox-ul

Lista de mesaje, cu „Nu ai mesaje noi” în @empty.

CLASAMENTTopul jucătorilor

Poziția din clasament vine din $index + 1.

Exercițiul tău

Afișează o listă numerotată de produse cu @for, cu mesaj pentru lista goală și un buton care scoate ultimul produs.

  • Lista produse (signal) are deja 4 produse cu id, nume, pret.
  • Afișează fiecare produs într-un li sub forma 1. Pâine - 5 lei (folosește $index + 1), cu track p.id.
  • Adaugă @empty cu li.gol și textul Lista e goală.
  • Butonul #sterge-ultimul scoate ultimul produs din listă.
@for (p of produse(); track p.id) { <li>{{ $index + 1 }}. {{ p.nume }} - {{ p.pret }} lei</li> } @empty { <li class="gol">Lista e goală</li> }.

Soluția exercițiului

import { Component, signal } from '@angular/core';

interface Produs { id: number; nume: string; pret: number; }

@Component({
  selector: 'app-root',
  template: `
    <ul>
      @for (p of produse(); track p.id) {
        <li>{{ $index + 1 }}. {{ p.nume }} - {{ p.pret }} lei</li>
      } @empty {
        <li class="gol">Lista e goală</li>
      }
    </ul>
    <button id="sterge-ultimul" (click)="stergeUltimul()">Șterge ultimul</button>
  `
})
export class App {
  produse = signal<Produs[]>([
    { id: 1, nume: 'Pâine', pret: 5 },
    { id: 2, nume: 'Ouă', pret: 12 },
    { id: 3, nume: 'Lapte', pret: 8 },
    { id: 4, nume: 'Brânză', pret: 25 }
  ]);

  stergeUltimul() {
    this.produse.update(lista => lista.slice(0, -1));
  }
}
Excelent! Continuă cu lecția următoare →
app.tsAngular (TypeScript)
Previzualizare
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu Angular Lecția 12 · Liste cu @for și track
Progres 0% 0 din 17
Lecția curentă 12 / 15 Control flow