Resolvendo o Erro No Provider for TemplateRef no Angular
Neste artigo você aprenderá a resolver o erro No Provider for TemplateRef, um problema bem comum em projetos de Angular

Fala programador(a), beleza? Bora aprender mais sobre Angular!
Ao desenvolver aplicações com Angular, é comum encontrar diversos desafios, e um dos erros que podem surgir é o “No Provider for TemplateRef”.
Este erro geralmente ocorre quando tentamos utilizar diretivas estruturais, como ngIf, de maneira incorreta.
Neste artigo, exploraremos como entender e resolver este erro, garantindo que você possa utilizar diretivas estruturais com eficácia em seus projetos Angular.

Black Week do Nexus
A formação de IA mais completa do Brasil
- 7 formações · 112 cursos · 26 mil alunos
Compreendendo o Erro “No Provider for TemplateRef”
O erro “No Provider for TemplateRef” é frequentemente um indicativo de que a diretiva estrutural está sendo usada de maneira inapropriada.
Em Angular, as diretivas estruturais, como ngIf, ngFor, e ngSwitch, são ferramentas poderosas para modificar a estrutura do DOM com base em condições ou conjuntos de dados.
Causas Comuns do Erro
Este erro geralmente ocorre quando:
- A diretiva estrutural está sendo usada sem um
*(asterisco) na frente do seu nome. - Há uma configuração incorreta ou falta de módulos necessários no
NgModule.
Solução do Problema
Vamos explorar as soluções para cada uma dessas causas comuns.

VPS Hostinger para seu sistema
10% OFF extraVPS com SSD NVMe e backups semanais. O cupom MATHEUSHORADECODAR é aplicado automaticamente pelo link.
Ver planos com 10% OFF →Uso Correto de Diretivas Estruturais
Exemplo de Uso Incorreto
Suponha que você tenha o seguinte código em seu template Angular:
<div ngIf="condicao">Conteúdo condicional</div>
Este é um uso incorreto da diretiva ngIf, pois falta o asterisco.
Exemplo de Uso Correto
A forma correta de usar a diretiva ngIf é:
<div *ngIf="condicao">Conteúdo condicional</div>
A adição do asterisco transforma a diretiva em uma diretiva estrutural, permitindo que o Angular processe a condição corretamente.
Verificando a Configuração do NgModule
Outra causa possível do erro é a falta de importação do módulo CommonModule, que contém as diretivas estruturais básicas do Angular.
Exemplo de Importação do CommonModule
No seu módulo (app.module.ts ou outro módulo específico), certifique-se de que o CommonModule está sendo importado:

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.import { CommonModule } from '@angular/common';
@NgModule({
imports: [
CommonModule
// outros módulos...
],
// declarações, provedores, etc...
})
export class MeuModulo { }
Dicas Adicionais
Além dessas soluções, aqui estão algumas dicas adicionais para evitar ou solucionar problemas relacionados a diretivas estruturais:
- Sempre verifique a sintaxe e a ortografia das diretivas.
- Certifique-se de que todas as diretivas estão sendo usadas no contexto correto.
- Entenda a diferença entre diretivas estruturais e diretivas de atributo, e quando usar cada uma.
Quer aprender mais sobre programação? Conheça nosso canal no YouTube:
Conclusão
O erro “No Provider for TemplateRef” é um sinal de que algo está errado com o uso de diretivas estruturais em seu projeto Angular.
Revisar a sintaxe correta para o uso de diretivas como ngIf e garantir que o CommonModule esteja importado no seu módulo são passos essenciais para resolver esse problema.
Compreender e aplicar corretamente as diretivas estruturais é fundamental para o desenvolvimento eficiente e eficaz com o Angular, permitindo criar interfaces dinâmicas e responsivas.
Ao seguir estas diretrizes, você pode garantir que seus projetos Angular sejam robustos, mantíveis e livres de erros comuns relacionados às diretivas.
Está buscando evoluir como Programador? Confira o nossos cursos de programação.
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 30min
Blog | Mais populares

Resolvendo o Erro ng não é reconhecido como um comando interno ou externo
Neste artigo você aprenderá a reoslver o Erro ng não é reconhecido como um comando interno ou externo Fala programador(a), beleza? Bora aprender mais sobre […]

Identificando a Versão do Angular em Seu Projeto
Aprenda neste artigo você pode estar identificando a versão do Angular no seu projeto de maneira simples e fácil Fala programador(a), beleza? Bora aprender mais […]

Solucionando Erros Comuns no NPM Durante a Instalação de Pacotes
Neste artigo você aprenderá a como solucionar erros comuns no NPM durante a instalação de um projeto Angular ou de outras ferramentas Fala programador(a), beleza? […]
