Reactive forms vs Template-driven forms: qual escolher? | Alura Cursos Online
Reactive forms vs Template-driven forms: qual escolher?
18 min18 minutos de leitura
18 min18 minutos de leitura
Fala, Dev!
Autor(a)
Rafaela Petelin Silvério
Sou Bacharela em Sistemas de Informação, Técnica em Desenvolvimento de Sistemas pela ETEC e atuo como Analista de Suporte Educacional na Alura, onde respondo as dúvidas que surgem no fórum, principalmente na área de Front-end.
Sou apaixonada por tecnologia e busco sempre aprender coisas novas. Meus hobbies favoritos são ler, estudar novos idiomas e assistir séries de comédia.
Inscreva-se em nossa Newsletter
Fique por dentro de conteúdos, insights e oportunidades do universo tech. Receba novidades e lançamentos direto no seu e-mail.
Se você está entrando no mundo Angular e chegou o momento de construir formulários, saiba que nesse framework temos duas principais abordagens: template-driven forms e reactive forms.
Ambas fazem o “arroz com feijão” dos formulários, ou seja: capturar e validar dados do usuário. Mas cada uma segue seu próprio método: uma prioriza a simplicidade do HTML e, a outra, o controle do TypeScript.
Escolher entre elas não vai depender só do seu gosto, porque essa decisão impacta diretamente a manutenção, complexidade e até os testes da sua aplicação.
Neste artigo, vamos comparar essas duas abordagens utilizando um projeto simples como exemplo: um formulário de cadastro, para você sair daqui dominando as características dessas abordagens:
Pronto para essa aventura?
O que são reactive forms e template-driven forms?
O que é template-driven forms?
O template-driven forms (em português, “formulário orientado a template") é uma abordagem do Angular em que o formulário é feito através do template, ou seja, no arquivo HTML.
Aqui, para fazer a vinculação bidirecional (*two-way data binding*) entre os campos e o modelo de dados, usamos diretivas, por exemplo, o `[(ngModel)]`.
O `[(ngModel)]` é uma sintaxe conhecida como "banana in a box"(banana na caixa, em português), que combina property binding `([ ])` e event binding `(( ))`.
Isso permite uma comunicação de mão dupla:
Quando o usuário digita algo no campo, o valor é atualizado automaticamente no modelo (componente).
Quando o valor do modelo muda no componente, a view (o HTML) também é atualizada automaticamente.
Por exemplo:
```
<input [(ngModel)]="usuario.nome">
```
Neste caso, qualquer mudança no input será refletida em `usuario.nome`, e qualquer alteração feita em `usuario.nome` também será refletida no campo.
É uma abordagem é ideal para formulários simples, pois exige menos código no arquivo TypeScript.
Como usar template-driven forms?
Vamos entender melhor, aplicando essa abordagem na criação de um formulário de cadastro de usuário com os seguintes campos e validações:
Nome (obrigatório, mínimo de 3 caracteres);
Email (obrigatório, formato de email válido);
Tipo de conta (obrigatório – comum ou admin);
Data de nascimento (obrigatório);
Receber newsletter (opcional).
O objetivo é chegar ao resultado abaixo:
Vamos configurar esse formulário orientado a template?
Configuração inicial do projeto
Para começarmos, criei um projeto Angular na versão 19 e dentro dele criei dois componentes:
`FormTemplateComponent`, no qual desenvolveremos nosso formulário template-driven, que vamos manipular agora;
`FormReativoComponent`, onde vamos construir o formulário reativo mais à frente.
Você pode seguir os comandos apresentados abaixo ou baixar essa base de projeto, já com os componentes criados e estilizações CSS inclusos [através desse link].
Se quiser testar os códigos apresentados, mas sem fazer a instalação do Angular CLI 19 e a configuração do projeto diretamente em sua máquina, utilize a ferramenta [IDX](https://idx.google.com/).
Para criar o projeto, usei o comando a seguir no terminal, dentro da pasta desejada:
```bash
ng new forms
```
Ao longo da criação do projeto, receberemos 3 perguntas:
A primeira pergunta se desejamos usar o formato CSS (respondi que sim);
A segunda questiona se queremos habilitar o *Server-Side Rendering* (SSR) e o Static Site Generation (SSG/Prerendering) (marquei Yes, visando a melhorar performance e SEO);
E a terceira pergunta se queremos utilizar as APIs de Server Routing e App Engine (Developer Preview); escolhi Yes para as APIs de servidor, garantindo suporte completo ao backend.
Recomendo seguir essas escolhas para evitar incompatibilidades, exceto na escolha de estilo, que fica conforme a sua preferência.
Em seguida, abrimos nosso projeto:
```bash
cd forms
ng version # Para confirmar a versão (deve ser 19)
```
Obs.: Certifique-se de que o Angular CLI 19 está instalado. Se precisar instalar essa versão específica:
```bash
npm install -g@angular/cli@19
```
Utilize os seguintes comandos para criar os componentes:
```bash
ng generate component form-template
ng generate component form-reativo
```
Com a base pronta, vamos configurar nosso projeto no arquivo `main.ts`, como pode observar a seguir:
```
import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './app/app.component';
import { importProvidersFrom } from '@angular/core';
import { FormsModule, ReactiveFormsModule } from '@angular/forms';//módulos para formulário
import { provideRouter } from '@angular/router';
import { FormTemplateComponent } from './app/form-template/form-template.component';
import { FormReativoComponent } from './app/form-reativo/form-reativo.component';
bootstrapApplication(AppComponent, {
providers: [
importProvidersFrom(FormsModule, ReactiveFormsModule),
provideRouter([
{ path: 'template', component: FormTemplateComponent },
{ : , component: FormReativoComponent },
]),
],
});
```
Nesse arquivo, importei os módulos que precisaremos para os formulários.
Observe que, para nosso formulário *template-driven*, usaremos o `FormsModule`.
Também já me adiantei e adicionei o módulo `ReactiveFormsModule`, para o formulário reativo (a outra abordagem que conheceremos melhor mais à frente).
Também criei duas rotas, uma para cada formulário em nossa aplicação. Feito isso, podemos preparar nosso formulário template-driven.
Configuração do formulário Template-Driven
Agora, vamos criar o HTML do componente `FormTemplateComponent`, no arquivo `form-template.component.html`.
Perceba que essa abordagem é mais declarativa. A lógica de validação e o estado do formulário são gerenciados principalmente no template HTML, no qual precisaremos utilizar a diretiva `[(ngModel)]` para fazer *data binding bidirecional* entre o `input` e o modelo de dados.
Para as validações, podemos usar os próprios atributos HTML nativos como `required`, `minlength`, ou `type="email"`. As mensagens de erro são exibidas condicionalmente com `*ngIf` se determinada condição de validação não é atendida.
Além disso, cada campo do formulário pode ter sua própria referência local (como `#nome="ngModel"`) para acessarmos seu estado de validação diretamente no template.
E quanto ao envio do formulário, o botão só ficará habilitado quando `formulario.valid `for verdadeiro, ou seja, quando todos os campos estiverem válidos.
Em código, teremos o seguinte:
```html
<h2>Cadastro - Template-Driven</h2><form #formulario="ngForm" (ngSubmit)="aoEnviar()"novalidate><label>
Nome:
< = [()]= = #= />
Nome é obrigatório.
Mínimo de 3 caracteres.
Email:
Email é obrigatório.
Formato inválido.
Tipo de conta:
Selecione
Comum
Admin
Tipo de conta é obrigatório.
Data de nascimento:
Data de nascimento é obrigatória.
Deseja receber nossa newsletter?
Enviar
```
No arquivo TypeScript, precisamos importar o `FormsModule` para habilitar todas as funcionalidades do formulário e definir o modelo de dados que será vinculado ao template, neste caso, `usuario`. E podemos definir quantas funções forem necessárias para lidar com o formulário, como a função de envio `aoEnviar()`:
E nosso formulário template-driven está pronto e funcional:
Observando esse padrão, já dá pra imaginar algumas vantagens e desvantagens de usá-lo, não é mesmo? Listei esses pontos a seguir.
Quais as vantagens do template-driven forms?
Entre as vantagens do template-driven forms, cabe-se citar:
Menor curva de aprendizado, ou seja, mais amigável para iniciantes;
Configuração rápida, o que favorece a criação de formulários mais simples;
Código mais enxuto no TypeScript.
Quais as desvantagens do template-driven forms?
Entre as desvantagens, é possível notar que:
É mais difícil testar a lógica no formulário, por estar acoplado ao template, como discutiremos mais à frente;
Menor controle das validações, que precisam ser adicionadas no template;
O código fica mais espalhado entre os arquivos HTML e TS.
Vamos continuar nosso projeto reproduzindo esse formulário, agora na abordagem Reativa?
Reactive forms
Agora que já conhecemos o formulário Template-Driven, podemos conhecer o outro lado dessa batalha: na abordagem dos Reactive forms, o controle do formulário é construído através do componente TypeScript.
Para fazer isso, usamos as APIs `FormGroup`, `FormControl` e `FormBuilder` para montar o formulário direto no TypeScript, onde vamos definir os campos e todas as suas regras, como as validações, por exemplo.
Para entender melhor, continuaremos nosso projeto. Nesse caso, o arquivo TypeScript assume a maior parte das responsabilidades. Vamos ver?
Configuração do formulário reativo
No arquivo `form-reativo.component.ts`, criei o seguinte código, onde primeiro importamos os recursos necessários para trabalhar com formulários reativos no Angular, como `FormBuilder`, `FormGroup` e `Validators`, além dos módulos `ReactiveFormsModule` e `CommonModule`.
Em seguida, injetamos o `FormBuilder` no construtor da classe para facilitar a criação do formulário. Dentro do método `ngOnInit`, utilizamos o `fb.group()` para construir o `FormGroup`, definindo cada campo (`nome`, `email`, `tipoConta`, `dataNascimento` e `receberNewsletter`) com seus valores iniciais e validadores apropriados, como `Validators.required` e `Validators.email`.
Por fim, criamos a função `aoEnviar()`, que é acionada ao enviar o formulário e exibe um alerta com o nome preenchido, acessando os dados através de `this.formularioUsuario.value`.
Além disso, para tornar o código mais organizado, foi criada uma interface `Usuario`, que define claramente os campos do formulário e seus respectivos tipos. Isso permite garantir, em tempo de desenvolvimento, que os dados manipulados pelo formulário estejam corretos e sigam uma estrutura bem definida.
Além disso, para melhorar a leitura do template e evitar repetições desnecessárias no HTML, foram implementados métodos `getters` no componente. Assim, o acesso aos controles do formulário se torna mais direto, melhorando a legibilidade e a manutenção do código.
O template utilizado (arquivo `form-reativo.component.html`) define a estrutura do formulário no HTML. Nele, usamos a diretiva `[formGroup]="formularioUsuario"` para conectar o formulário visual ao `FormGroup` criado no TypeScript. Cada campo (como `nome`, `email`, `tipoConta` e `dataNascimento`) é associado ao seu controle específico usando `formControlName`.
As validações são gerenciadas pelo Angular: o código TypeScript define as regras e, no HTML, mostramos mensagens de erro de forma condicional usando `*ngIf`, que verifica se o campo está inválido (`invalid`) e foi tocado (`touched`).
Dessa forma, as mensagens só aparecem depois que o usuário interage com os campos. O botão de envio é controlado pela propriedade `[disabled]`, ficando desabilitado enquanto o formulário for considerado inválido. Segue o código abaixo:
```
<h2>Cadastro - Formulário Reativo</h2><form [formGroup]="formularioUsuario" (ngSubmit)="aoEnviar()"novalidate><label>
Nome:
<inputformControlName="nome" />< *=>
Nome é obrigatório.
Mínimo de 3 caracteres.
Email:
Email é obrigatório.
Formato inválido.
Tipo de conta:
Selecione
Comum
Admin
Tipo de conta é obrigatório.
Data de nascimento:
Data de nascimento é obrigatória.
Deseja receber nossa newsletter?
Enviar
```
Temos nosso formulário Reativo pronto também:
Dicas extras – outras possibilidades com formulários reativos
Adicionando validações customizadas
Além das validações padrão, como `required` e `email`, também é possível criar validações personalizadas no Angular para atender regras específicas de negócio.
Aqui, implementamos uma validação para o campo "Data de nascimento", que garante que o usuário não possa selecionar uma data no futuro.
Essa validação foi feita por meio de um método estático dentro do próprio componente, chamado `validarData()`. Essa função recebe o valor do controle, transforma em um objeto `Date` e compara com a data atual. Se a data for futura, ela retorna um erro no formato `{ dataFutura: true }`. Caso contrário, retorna `null`, indicando que o valor é válido.
A aplicação da validação no campo ocorre da seguinte forma:
No template, também foi adicionada uma mensagem específica para esse erro personalizado, garantindo uma comunicação clara com quem preenche o formulário:
```
<small *ngIf="dataNascimento?.errors?.['dataFutura']">
A data de nascimento não pode ser no futuro.
</small>
```
A função da validação personalizada fica assim:
```
staticvalidarData(control: AbstractControl): ValidationErrors | null {
const data = new Date(control.value);
const hoje = new Date();
return data > hoje ? { dataFutura: true } : null;
}
```
Como ficou o trecho no template, com a validação de data vazia e de data futura:
```
<label>
Data de nascimento:
<inputtype="date"formControlName="dataNascimento" /><div *ngIf="dataNascimento?.invalid && dataNascimento?.touched"><small *ngIf="dataNascimento?.errors?.['required']">
Data de nascimento é obrigatória.
</small><small *ngIf="dataNascimento?.errors?.['dataFutura']">
A data de nascimento não pode ser no futuro.
</small></div></label>
```
Com a validação implementada, o código completo do arquivo ts ficou assim:
O resultado é uma validação de data que "reclama” se a data inserida for após a data atual:
Trabalhando com FormArray no Angular
Nem sempre sabemos de antemão quantos itens um formulário precisa capturar. Existem situações em que o usuário pode querer informar uma quantidade variável de dados, como telefones, dependentes, documentos ou habilidades.
Nesses casos, usamos o FormArray, que permite gerenciar dinamicamente uma lista de controles dentro de um formulário reativo no Angular.
Por que usar FormArray?
O `FormArray` permite que a gente crie, de forma dinâmica, um conjunto de campos que representam um array de informações, sem precisar definir manualmente quantos campos existirão.
No contexto desse formulário de cadastro, queremos permitir que a pessoa cadastre mais de um telefone e possa adicionar ou remover números conforme desejar. Isso torna o formulário mais flexível e adaptável às necessidades de quem está preenchendo.
Como aplicamos no formulário
1. No `FormGroup`, adicionamos o campo `telefones` como um FormArray vazio inicialmente:
```ts
telefones: this.fb.array([]),
```
2. Criamos dois métodos no componente:
- `adicionarTelefone()` – Adiciona um novo controle (`FormControl`) ao array `telefones`. Cada telefone deve ser preenchido e conter apenas números, então adicionamos os validadores `required` e `pattern`.
3. No template, usamos a diretiva `*ngFor` para percorrer os controles do array `telefones` e exibir um campo `<input>` para cada um deles. Também adicionamos botões para adicionar ou remover telefones.
Como ficou no template:
```html
<divformArrayName="telefones"><h3>Telefones</h3><div *ngFor="let telefone of telefones.controls; let i = index"><input [formControlName]="i"placeholder="Telefone" /><buttontype="button" (click)="removerTelefone(i)">Remover</button><div *ngIf="telefone.invalid && telefone.touched"><small *ngIf="telefone.errors?.['required']">Telefone é obrigatório.</small>
Digite apenas números.
Adicionar Telefone
```
Código completo do componente após as alterações com FormArray:
Essa configuração resulta em campos de telefone com quantidade personalizável:
Assim como os formulários Template-Driven, os também tem suas forças e fraquezas:
Vantagens:
É mais fácil ter o controle sobre os estados e as validações
Essa abordagem é muito mais fácil de testar
Simplifica a criação de formulários complexos
Desvantagens:
Mais verboso se compararmos com o Template-Driven.
Como é necessário conhecer as APIs reativas e saber usá-las, pode ser menos amigável para iniciantes
Agora que você já conhece cada uma das abordagens de formulários no Angular, você pode estar se perguntando: qual eu devo escolher?
Para te tirar dessa dúvida cruel, vamos explorar sobre como e onde usar cada tipo de formulário.
Aplicações e usos dos diferentes tipos de formulários
Nem todo formulário vai exigir o mesmo nível de controle ou ter a mesma complexidade. Então ao se perguntar sobre qual abordagem utilizar, repetiremos a clássica palavra que ouvimos sempre no mundo da tecnologia: depende… Aqui vamos decidir sobre a melhor abordagem com base no cenário da aplicação e do formulário que você precisa construir.
Quando optamos por Template-driven forms?
Vamos usar essa abordagem quando estamos em um cenário simples, com poucas regras de negócio. Como a configuração é feita no template HTML, o código fica mais declarativo e fácil de entender, sendo mais indicado em formulários básicos.
Reactive forms:
Se você já tem um cenário mais complexo, como um formulário com muitas validações, partes que são dinâmicas ou serão renderizadas de acordo com condicionais ou se precisa de testes mais elaborados, essa vai ser a abordagem ideal. Como a configuração será feita no código TypeScript, é possível ter um controle mais personalizado dos campos.
Para te auxiliar na escolha da abordagem ideal, construímos um fluxograma para que faça sua própria comparação:
Um detalhe importante: Testes
Um detalhe que precisamos nos atentar ao escolher nossa abordagem é a testabilidade. A escrita e execução dos testes muda bastante de acordo com a abordagem escolhida. Vamos entender melhor como os testes funcionam em cada um dos casos:
Testes em template-driven forms:
Os testes em formulários template-driven podem ser mais complicados, isso porque a lógica fica diretamente no HTML e isso acaba dificultando no momento de simular e verificar estados de controle (como `valid`, `touched`, `dirty`, etc.). Assim, os testes acabam ficando mais superficiais.
Testes em reactive forms:
Essa abordagem é bem mais testável e o que permite isso é o controle no componente (arquivo TypeScript) via `FormGroup`. Você pode verificar e alterar o estado do formulário diretamente no componente.
Considerações Finais
Chegamos ao fim de mais uma jornada onde exploramos as duas principais abordagens para criar formulários no Angular: template-driven forms e reactive forms. Cada uma tem suas particularidades, vantagens e desvantagens, e nessa batalha, a escolha entre elas deve ser baseada no contexto do seu projeto.
Aprendemos que os template-driven forms são ideais para formulários simples, com configuração rápida e menos código no TypeScript. São ótimos para iniciantes ou cenários onde a simplicidade é prioritária.
Enquanto isso, os reactive forms oferecem maior controle, facilitam a criação de formulários complexos e dinâmicos. Eles também dão um show quando o assunto é testabilidade. São a escolha certa para aplicações com validações customizadas ou lógicas avançadas.
Próximos passos
Agora que você já conhece as diferenças, experimente ambas as abordagens em projetos reais para dominar ainda mais o universo de formulários no Angular! Para continuar se aprimorando, que tal dar uma olhada na Formação Angular 19?
E agora, Dev? Qual abordagem você vai usar no seu próximo projeto? Compartilhe com a Alura nas redes sociais!
Busque conhecimento 👽! Continue firme nos estudos e até a próxima :)
