NG8003: No directive found with exportAs 'ngForm'.
O variabilă de șablon de forma #f="ngForm" (sau #c="ngModel") cere directiva exportată cu acel nume, dar directiva nu e importată. Adaugă FormsModule (sau directiva respectivă) în imports.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O variabilă de șablon simplă, #f, primește elementul DOM. Forma #f="ngForm" cere altceva: instanța directivei care se exportă sub numele ngForm (prin exportAs). Pentru ngForm și ngModel, directivele vin din FormsModule; pentru ngModelGroup tot de acolo; pentru directivele tale, din clasa care are exportAs: 'nume'.
Dacă nicio directivă importată nu se exportă cu acel nume, compilatorul AOT oprește build-ul cu NG8003: No directive found with exportAs 'ngForm'. În modul JIT poți primi NG0301 („Export of name 'ngForm' not found!”) sau, mai rău, nimic: variabila rămâne fără valoare și f.valid e undefined, așa că butoanele și mesajele care depind de ea nu funcționează.
Aproape mereu lipsește FormsModule din imports sau numele din ghilimele e scris greșit (ngform, NgForm).
De ce apare: cauzele frecvente
1FormsModule neimportat
@Component({
template: `<form #f="ngForm">...</form>`
})import { FormsModule } from '@angular/forms';
@Component({
imports: [FormsModule],
template: `<form #f="ngForm">...</form>`
})Directiva NgForm, care se exportă ca ngForm, vine din FormsModule.
2Nume scris greșit
<input name="email" ngModel #e="NgModel"><input name="email" ngModel #e="ngModel">Numele din exportAs e sensibil la litere mari și mici: ngModel, nu NgModel.
3Directivă proprie fără exportAs
@Directive({ selector: '[tooltip]' })
export class Tooltip {}
// <p tooltip #t="tooltip">@Directive({ selector: '[tooltip]', exportAs: 'tooltip' })
export class Tooltip {}
// <p tooltip #t="tooltip">Ca să poată fi referită după nume, directiva trebuie să declare exportAs.
Repară eroarea, direct în pagină
Formularul de abonare folosește #f="ngForm", iar #stare trebuie să afișeze „Formular valid” după ce scrii un e-mail în câmpul obligatoriu #email. Starter-ul nu importă directiva care se exportă ca ngForm (la build: NG8003). Repară importurile.
import { Component } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<form #f="ngForm">
<input id="email" name="email" ngModel required>
</form>
<p id="stare">{{ f.valid ? 'Formular valid' : 'Completează e-mailul' }}</p>
`
})
export class App {}Indiciu
NgForm și NgModel vin din FormsModule.
Reparația
import { Component } from '@angular/core';
import { FormsModule } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [FormsModule],
template: `
<form #f="ngForm">
<input id="email" name="email" ngModel required>
</form>
<p id="stare">{{ f.valid ? 'Formular valid' : 'Completează e-mailul' }}</p>
`
})
export class App {}De ce merge
#f="ngForm" cere directiva care se exportă cu numele ngForm, adică NgForm din FormsModule. Fără import, nu există o astfel de directivă: la build primești NG8003, iar aici f.valid rămâne fără valoare, deci mesajul nu se schimbă niciodată.
Cu FormsModule importat, NgForm se atașează formularului, ngModel înregistrează câmpul obligatoriu, iar după completare f.valid devine true.
Alte forme ale mesajului
error NG8003: No directive found with exportAs 'ngModel'.NG0301: Export of name 'ngForm' not found!Export of name 'ngModel' not found
Cum o eviți pe viitor
- Când folosești
#x="ngForm"sau#x="ngModel", verifică căFormsModulee înimports. - Copiază numele exact din documentație:
ngForm,ngModel,ngModelGroup. - Pentru directivele tale, declară
exportAsdoar dacă vrei să le referi din șablon. - Pentru formulare noi, ia în calcul formularele reactive sau Signal Forms, care nu folosesc variabile de șablon pentru stare.
Întrebări frecvente
Ce diferență e între #f și #f="ngForm"?
#f singur e elementul <form> din DOM. #f="ngForm" e obiectul Angular care știe dacă formularul e valid, ce valori are și dacă a fost atins.
De ce în browser nu primesc nicio eroare, dar formularul nu merge?
În modul JIT, fără verificarea strictă de la build, variabila poate rămâne fără directivă. f.valid devine undefined, deci condițiile din șablon sunt mereu false. La ng build ai fi primit NG8003.
Erori înrudite
NG0304: 'app-card' is not a known element (used in the 'App' component template) Șablonul folosește tagul <app-card>, dar componenta care are acest selector nu e în imports-ul componentei curente (sau selectorul e scris diferit). Importă clasa și adaug-o în imports: [Card] din @Component. NG0303: Can't bind to 'nume' since it isn't a known property of 'app-card' (used in the 'App' component template). Șablonul trimite [nume] către <app-card>, dar componenta Card nu are un input cu acest nume (îl cheamă altfel, nu e declarat cu input(), sau componenta nu e importată). Folosește exact numele input-ului: [titlu]="...". The "LeiPipe" type, imported from "App", must be a standalone component / directive / pipe or an NgModule. Did you forget to add the required @Component / @Directive / @Pipe or @NgModule annotation? În imports-ul componentei e o clasă care nu are decorator Angular: un pipe fără @Pipe, o directivă fără @Directive, un serviciu sau o clasă oarecare. Adaugă decoratorul lipsă sau scoate clasa din imports (serviciile nu se importă acolo). Învață Angular de la zero, cu exerciții la fiecare lecție
Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
