...
← Curs Angular: toate lecțiile
Lecția 10 · Template

Referințe în template cu #camp

Uneori ai nevoie direct de un element din pagină, de exemplu de textul scris într-un câmp. Cu o referință de template (#camp) dai un nume elementului și îl poți folosi oriunde în același template, inclusiv în evenimente ca (keyup.enter).

Un nume pentru un element

Scrii # urmat de un nume pe orice element. Din acel moment, numele se referă la elementul HTML însuși:

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

@Component({
  selector: 'app-root',
  template: `
    <input #camp placeholder="Orașul tău">
    <button (click)="salveaza(camp.value)">Salvează</button>
    <p>Oraș salvat: {{ oras() }}</p>
  `
})
export class App {
  oras = signal('nimic');

  salveaza(text: string) {
    this.oras.set(text);
  }
}

camp este câmpul de text, iar camp.value este ce a scris utilizatorul. La click, textul ajunge în signal și apare în paragraf.

Nu confunda

#camp (referință, numele din template) nu are legătură cu id="camp" (atribut HTML pentru CSS și teste). Le poți pune pe amândouă pe același element.

Trimite tot elementul

Poți trimite metodei elementul întreg, nu doar valoarea. Așa metoda poate și goli câmpul după ce l-a citit:

adauga(camp: HTMLInputElement) {
  this.oras.set(camp.value);
  camp.value = '';
}
<input #camp>
<button (click)="adauga(camp)">Adaugă</button>

HTMLInputElement este tipul TypeScript al unui <input>. Golirea câmpului este un detaliu mic care face aplicația plăcută: utilizatorul poate scrie imediat următorul text.

Tasta Enter: (keyup.enter)

Angular are scurtături pentru taste. (keyup.enter) rulează codul doar când se ridică tasta Enter, nu la fiecare literă:

<input #camp (keyup.enter)="adauga(camp)">
  • (keyup.enter): Enter.
  • (keyup.escape): Escape, de exemplu pentru a anula editarea.
  • (keydown.arrowdown): săgeata în jos, pentru liste de sugestii.

Combinând butonul și Enter, utilizatorul poate alege cum adaugă: cu mouse-ul sau direct din tastatură.

Textul la fiecare literă: (input)

Dacă vrei să știi textul în timp ce se scrie (nu doar la Enter), ascultă evenimentul (input) și pune valoarea într-un signal:

<input (input)="text.set($any($event.target).value)">
<p>Ai scris {{ text().length }} caractere</p>

$event.target este câmpul, iar $any(...) îi spune lui Angular să nu verifice tipul expresiei (în template nu putem scrie as HTMLInputElement). Pentru formulare complete există soluții dedicate, pe care le vei învăța în modulul de formulare.

Pas cu pas: adăugarea dintr-un câmp

1
Dai câmpului o referință: <input #camp>.
2
Butonul și Enter apelează aceeași metodă: adauga(camp).
3
Metoda citește camp.value și îl pune într-un signal (de exemplu într-o listă cu update(l => [...l, text])).
4
Metoda golește câmpul: camp.value = ''.
5
Template-ul afișează din signal ce s-a adăugat.
Amintire din TypeScript

[...lista, element] creează o listă nouă cu toate elementele vechi plus cel nou. Cu signals lucrăm mereu așa: nu modificăm lista veche, punem una nouă.

Greșeli frecvente

  • adauga(#camp): diezul se scrie doar pe element; în expresii folosești numele simplu, camp.
  • Referința folosită în alt component: #camp există doar în template-ul în care a fost declarată.
  • (keyup.Enter) cu literă mare: numele tastei se scrie cu litere mici, enter.
  • Uiți să golești câmpul: utilizatorul trebuie să șteargă manual textul vechi.

Unde întâlnești asta

CHATTrimite cu Enter

Mesajul pleacă la Enter, iar câmpul se golește pentru următorul.

SARCINIListă de sarcini

Scrii o sarcină, apeși Enter și apare în listă.

CĂUTAREBara de căutare

Enter pornește căutarea cu textul din câmp.

Exercițiul tău

Adaugă nume într-o listă din câmpul de text: cu butonul #adauga sau cu Enter. După adăugare, câmpul se golește, iar p#ultim arată ultimul nume.

  • Câmpul input#nume are referința #camp.
  • Butonul #adauga și tasta Enter ((keyup.enter)) apelează adauga(camp).
  • Metoda pune camp.value la finalul signal-ului nume și golește câmpul.
  • p#ultim afișează Ultimul: ... cu ultimul nume (signal-ul calculat ultim există deja).
adauga(camp: HTMLInputElement) { this.nume.update(l => [...l, camp.value]); camp.value = ''; }.

Soluția exercițiului

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

@Component({
  selector: 'app-root',
  template: `
    <input id="nume" #camp placeholder="Nume" (keyup.enter)="adauga(camp)">
    <button id="adauga" (click)="adauga(camp)">Adaugă</button>
    <p id="ultim">Ultimul: {{ ultim() }}</p>
    <p>Total: {{ nume().length }}</p>
  `
})
export class App {
  nume = signal<string[]>([]);
  ultim = computed(() => {
    const lista = this.nume();
    return lista.length > 0 ? lista[lista.length - 1] : 'nimeni';
  });

  adauga(camp: HTMLInputElement) {
    this.nume.update(l => [...l, camp.value]);
    camp.value = '';
  }
}
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 10 · Referințe în template (#camp)
Progres 0% 0 din 17
Lecția curentă 10 / 15 Template