...
← Curs Angular: toate lecțiile
Lecția 2 · Primii pași

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
ParteCe face
importaduce Component din pachetul @angular/core
@Component({ ... })spune lui Angular cum se numește componenta în HTML și ce afișează
export class Appcodul și datele componentei; export o face vizibilă în afara fișierului
Amintire din TypeScript

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.

Bine de știut

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

SITEAntetul unui site

Logo-ul, titlul și meniul de navigare stau de obicei într-o singură componentă afișată pe toate paginile.

MAGAZINBara de categorii

Un nav cu linkurile Laptopuri, Telefoane, Accesorii este primul lucru pe care îl construiești într-un magazin.

ECHIPĂProiecte mari

Fiecare programator lucrează la componentele lui, iar selectorul este „adresa” prin care sunt puse cap la cap.

Exercițiul tău

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.
<nav><a href="#">Acasă</a> <a href="#">Produse</a> <a href="#">Contact</a></nav> sub h1, totul în header.

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 {}
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 2 · Anatomia unei componente
Progres 0% 0 din 17
Lecția curentă 2 / 15 Primii pași