TemplateRef e ViewContainerRef
Renderize modelos dinamicamente.
TemplateRef e ViewContainerRef é uma aula grátis de Angular Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Angular Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Angular Academy inclui 4 aulas no total.
Renderização imperativa
Às vezes, você precisa renderizar conteúdo programaticamente, em vez de declarativamente. O Angular disponibiliza TemplateRef e ViewContainerRef para esse controle de baixo nível.
TemplateRef
Um TemplateRef é uma referência para um <ng-template>. Ele representa uma marcação que pode ser instanciada posteriormente.
tpl = viewChild.required<TemplateRef<unknown>>('tpl');ViewContainerRef
Um ViewContainerRef é um local no DOM onde você pode anexar visualizações. Injete-o para controlar o que será renderizado nesse local.
private vcr = inject(ViewContainerRef);createEmbeddedView
Combine os dois: createEmbeddedView instancia um TemplateRef em um ViewContainerRef.
this.vcr.createEmbeddedView(this.tpl());Passando o contexto
Você pode passar um objeto de contexto como segundo argumento, acessível por meio de variáveis let-.
this.vcr.createEmbeddedView(this.tpl(), {
$implicit: 'Hello',
count: 3
});Limpando visualizações
ViewContainerRef.clear() remove todas as visualizações que ele criou. É assim que você ativa e desativa conteúdo dinâmico.
this.vcr.clear();Uma diretiva estrutural personalizada
Esse padrão dá suporte a diretivas estruturais personalizadas. A diretiva injeta ambas as referências e renderiza condicionalmente.
@Directive({ selector: '[appUnless]' })
export class UnlessDirective {
private tpl = inject(TemplateRef<unknown>);
private vcr = inject(ViewContainerRef);
}Reagindo à entrada
Um configurador na entrada da diretiva controla create/clear para que a visualização apareça ou desapareça.
@Input() set appUnless(condition: boolean) {
if (!condition) {
this.vcr.createEmbeddedView(this.tpl);
} else {
this.vcr.clear();
}
}Inserindo em um índice
createEmbeddedView aceita um índice para controlar a ordem de inserção entre visualizações irmãs.
this.vcr.createEmbeddedView(this.tpl(), {}, 0);createComponent
ViewContainerRef também pode instanciar componentes dinamicamente com createComponent, o substituto moderno de ComponentFactoryResolver.
const ref = this.vcr.createComponent(WidgetComponent);
ref.setInput('title', 'Hi');Limpando recursos
As visualizações criadas imperativamente precisam ser limpas. Destruir o componente hospedeiro limpa automaticamente seu ViewContainerRef, mas chame clear() ao alternar manualmente.
Verificação rápida
Teste sua compreensão da renderização imperativa.
Recapitulação
Você aprendeu que TemplateRef é uma referência para a marcação de um modelo, ViewContainerRef é um ponto de inserção no DOM, e createEmbeddedView renderiza um no outro. Juntos, eles dão suporte a diretivas estruturais personalizadas e componentes dinâmicos.
Perguntas Frequentes
A aula “TemplateRef e ViewContainerRef” é grátis?
Sim — o texto completo de “TemplateRef e ViewContainerRef” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Angular Academy, atualize para CoddyKit PRO. O curso de Angular Academy inclui 4 aulas no total.
O que vou aprender em “TemplateRef e ViewContainerRef”?
Renderize modelos dinamicamente. Você pratica Angular Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Angular Academy?
Nenhuma experiência prévia é necessária. Angular Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “TemplateRef e ViewContainerRef”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Angular Academy?
Sim. Cada aula de Angular Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Projeção de conteúdo em um único espaço
- Projeção em vários espaços com select
- ng-template e ng-container
- TemplateRef e ViewContainerRef