...
Eroare Angular · Componente, imports și selectoare

NG8003: No directive found with exportAs 'ngForm'.

Pe scurt

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

Greșit
TypeScript
@Component({
  template: `<form #f="ngForm">...</form>`
})
Corect
TypeScript
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

Greșit
TypeScript
<input name="email" ngModel #e="NgModel">
Corect
TypeScript
<input name="email" ngModel #e="ngModel">

Numele din exportAs e sensibil la litere mari și mici: ngModel, nu NgModel.

3Directivă proprie fără exportAs

Greșit
TypeScript
@Directive({ selector: '[tooltip]' })
export class Tooltip {}
// <p tooltip #t="tooltip">
Corect
TypeScript
@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ă tu

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.

Codul care dă eroarea
TypeScript
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.

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ă FormsModule e în imports.
  • Copiază numele exact din documentație: ngForm, ngModel, ngModelGroup.
  • Pentru directivele tale, declară exportAs doar 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

← Toate erorile Angular

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.