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.
#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
[...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
Mesajul pleacă la Enter, iar câmpul se golește pentru următorul.
Scrii o sarcină, apeși Enter și apare în listă.
Enter pornește căutarea cu textul din câmp.
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).
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 = '';
}
} 