Anatomia unei componente Angular
În lecția trecută ai scris prima componentă. Acum o desfacem bucată cu bucată: ce face decoratorul @Component, ce înseamnă selectorul, cum scrii un template pe mai multe rânduri și unde stau datele componentei.
Cele trei părți ale unei componente
Orice componentă Angular are aceleași trei piese, mereu în aceeași ordine: importul, decoratorul și clasa.
import { Component } from '@angular/core'; // 1. importul
@Component({ // 2. decoratorul
selector: 'app-root',
template: `<h1>Salut!</h1>`
})
export class App {} // 3. clasa
| Parte | Ce face |
|---|---|
| import | aduce Component din pachetul @angular/core |
| @Component({ ... }) | spune lui Angular cum se numește componenta în HTML și ce afișează |
| export class App | codul și datele componentei; export o face vizibilă în afara fișierului |
Un decorator este o funcție scrisă cu @ deasupra unei clase. Nu schimbă codul clasei, ci îi adaugă informații. @Component îi atașează clasei selectorul și template-ul, iar Angular le citește când construiește pagina.
Selectorul: numele tagului
selector: 'app-root' înseamnă: oriunde apare în pagină tagul <app-root>, Angular pune acolo componenta. Pagina index.html a unui proiect real conține doar atât în body:
<body> <app-root></app-root> </body>
În laborator, tagul <app-root> este creat automat. Selectoarele componentelor tale încep de obicei cu un prefix (app-), ca să nu se confunde cu tagurile HTML obișnuite: app-header, app-produs, app-cos.
- Selectorul este scris cu litere mici și cratimă: app-meniu-principal.
- Trebuie să conțină o cratimă: așa cer standardele web pentru elemente proprii.
- Două componente nu pot avea același selector în aceeași aplicație.
Template pe mai multe rânduri
Template-ul este HTML. Pentru că îl scrii între backtick-uri, poate avea câte rânduri vrei, cu indentare, exact ca într-un fișier HTML:
import { Component } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<header>
<h1>Cafeneaua Aroma</h1>
<p>Deschis zilnic între 8 și 20</p>
</header>
`
})
export class App {
constructor() {
console.log('Pagina cafenelei este gata');
}
}
Pagina cafenelei este gata
În previzualizare vezi titlul și paragraful. Mesajul din constructor apare în consolă o singură dată, când Angular creează componenta.
Clasa ține datele
Deocamdată clasele noastre au fost goale sau au avut doar un constructor. De fapt, clasa este locul unde stau datele componentei (câmpuri) și comportamentul ei (metode):
export class App {
numeMagazin = 'Magazinul meu'; // un câmp (o dată)
produse = 120; // alt câmp
}
În lecția următoare vei afișa aceste câmpuri în template cu {{ }}. Până atunci reține împărțirea muncii: template-ul spune cum arată componenta, clasa spune ce date are și ce face.
Obiectul din @Component mai poate avea și alte chei: imports, styles, templateUrl, styleUrl. Le vei folosi pe rând în lecțiile următoare.
Greșeli frecvente
- Selector fără cratimă (selector: 'root'): Angular nu îl poate folosi ca element propriu.
- Selectorul scris cu ghilimelele greșite sau fără virgulă după el: eroare de sintaxă, cu linia exactă.
- Decoratorul pus departe de clasă, cu alt cod între ele: @Component se aplică doar clasei care urmează imediat.
- Uiți să închizi un tag în template (<nav> fără </nav>): primești „Eroare în șablon” cu rândul din template.
Unde întâlnești asta
Logo-ul, titlul și meniul de navigare stau de obicei într-o singură componentă afișată pe toate paginile.
Un nav cu linkurile Laptopuri, Telefoane, Accesorii este primul lucru pe care îl construiești într-un magazin.
Fiecare programator lucrează la componentele lui, iar selectorul este „adresa” prin care sunt puse cap la cap.
Construiește antetul unui magazin: un h1 și o bară de navigare cu trei linkuri.
- Componenta App are selectorul app-root.
- În template pune un header care conține un h1 cu textul Magazinul meu.
- Sub titlu adaugă un nav cu trei linkuri a: Acasă, Produse, Contact (atributul href poate fi #).
- Scrie template-ul pe mai multe rânduri, între backtick-uri.
Soluția exercițiului
import { Component } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<header>
<h1>Magazinul meu</h1>
<nav>
<a href="#">Acasă</a>
<a href="#">Produse</a>
<a href="#">Contact</a>
</nav>
</header>
`
})
export class App {} 