1. Introdução
O PDF do documento está AQUI.
Os códigos do documento estão AQUI.
Este documento é um produto da IA Claude, da Anthropic. Ele segue o curso “Introdução passo a passo ao framework web NestJS”, do qual muda a perspectiva:
- no curso [NestJS], o servidor gera as páginas HTML (engine de views [Handlebars]); o navegador apenas as exibe;
- neste curso, as páginas são geradas no navegador por uma aplicação [Angular]; o servidor, agora reduzido a um simples servidor JSON, fornece apenas dados.
As páginas da aplicação, no entanto, permanecem as mesmas: são as da aplicação [RdvMedecins] já apresentada com os outros frameworks (login com CAPTCHA, agenda do médico, janela de consulta, portal do paciente, gerenciamento de médicos e clientes, criação de conta, francês e inglês).
Este documento segue a mesma estrutura de seus predecessores: primeiro, vários exemplos curtos, cada um focado em um conceito específico do [Angular], seguidos de um estudo de caso completo — o cliente [Angular] da aplicação [RdvMedecins] —, com todos os arquivos anotados. Ele segue o roteiro do curso “Introdução passo a passo ao framework Vue.js”: quem conhece o [Vue.js] encontrará os mesmos exemplos, escritos no estilo do [Angular]. Como o [Angular] é um framework com mais recursos, há mais exemplos: 25 em vez de 20.
Já existe um curso sobre este tema: Um exemplo cliente/servidor com Angular/NestJS (2026), que abrange tanto o servidor quanto o cliente. Este documento difere em sua abordagem: o servidor é tratado como uma caixa-preta, e nos interessam apenas a API e o JSON, e aprendemos o [Angular] passo a passo antes de abordar o cliente completo.
1.1. O papel do Angular em uma aplicação web
A aplicação tem duas partes, que se comunicam entre si apenas por meio de requisições:

- 1: A aplicação [Angular], executada no navegador, envia uma requisição HTTP ao servidor, por exemplo, [GET /api/schedule?doctorId=1&day=2026-10-05];
- 2: O servidor responde com dados JSON: a agenda desse médico para aquele dia. Ele não gera nenhuma página;
- 3: Com esses dados, o [Angular] atualiza a página exibida no navegador sem recarregá-la.
O diagrama a seguir compara as duas arquiteturas:

O navegador carrega apenas uma única página HTML, quase vazia, na inicialização. Todo o resto é gerado por código [JavaScript]: é o que chamamos de aplicação de página única (SPA, de [Single Page Application]). Quando o usuário clica em um link interno, nenhuma página é solicitada ao servidor: o roteador do [Angular] altera a URL exibida e substitui o conteúdo da página.
[Angular] é um framework criado pelo Google. Sua primeira versão, o [AngularJS] (2010), foi completamente reescrita em 2016: é essa reescrita, em [TypeScript], que hoje se chama simplesmente [Angular], e que lança uma nova versão principal a cada seis meses. Ele se baseia em três ideias:
- componentes: a interface é dividida em peças reutilizáveis (uma barra de navegação, um campo de formulário, uma janela de confirmação etc.). Um componente é uma classe [TypeScript] associada a um template HTML e a um estilo CSS;
- Reatividade, baseada em signals: os dados de um componente são armazenados em signals. Quando um deles muda, o [Angular] atualiza automaticamente as partes da página que o exibem. Nunca escrevemos código que modifique diretamente a página;
- Injeção de dependência: os componentes não criam por conta própria os objetos de que precisam (acesso ao servidor, usuário logado, idioma etc.); eles os solicitam, e o [Angular] os fornece. Esse é o mecanismo que o curso [NestJS] já apresentou no lado do servidor — o [NestJS] , aliás, foi inspirado nele.
Ao contrário do [Vue.js], o [Angular] é um framework “tudo em um”: roteador, formulários, cliente HTTP, animações e testes são fornecidos pela própria equipe do [Angular], juntamente com diretrizes de uso recomendadas.
Usaremos o [Angular] 22, com seus recursos mais recentes: componentes standalone ([standalone]), signals, a nova sintaxe de template ([@if], [@for]), formulários baseados em signals e detecção de mudanças sem [zone.js] ([zoneless]), que é o comportamento padrão no [Angular] 22.
1.2. Ferramentas utilizadas
Os exemplos foram escritos e testados com as seguintes ferramentas (a instalação delas é descrita no apêndice):
- [Node.js] 24 (ou, no mínimo, 22.22.3: esse é o requisito do [Angular] 22) e seu gerenciador de pacotes [npm];
- o editor [Visual Studio Code], com a extensão [Angular Language Service];
- um navegador recente ([Chrome], [Firefox], [Edge]), se possível com a extensão [Angular DevTools];
- a ferramenta de linha de comando [curl], que exibe as respostas HTTP brutas;
- o SGBD [MySQL] (ou [MariaDB]), por exemplo, o do [Laragon] no [Windows]: ele é necessário para o servidor JSON, conforme descrito no capítulo que o apresenta.
As bibliotecas são as dos arquivos [package.json]: [Angular] 22.2 (o núcleo, o roteador, os formulários, o cliente HTTP), a ferramenta de linha de comando [Angular CLI] (comando [ng]), [RxJS] 7.8 (observables), [ngx-translate] 18 (idiomas), [TypeScript] 6.0 e [Bootstrap] 5.3.
1.3. Exemplos
Os códigos do documento estão organizados em três pastas:
A pasta de exemplos é um workspace [Angular] ([workspace]): ela contém vinte e cinco pequenas aplicações — uma por exemplo — que compartilham as mesmas bibliotecas:
Instale as bibliotecas uma única vez, em um console aberto na pasta [examples-angular] (no [VS Code]: menu Terminal / Novo Terminal):
Em seguida, execute um exemplo digitando seu nome:
O servidor de desenvolvimento do [Angular] compila o exemplo e o serve na porta 4200: abra-o em http://localhost:4200/. Esse servidor não precisa ser reiniciado quando você modifica um arquivo: cada arquivo salvo é recompilado imediatamente, e a página do navegador é atualizada automaticamente. Interrompa-o com [Ctrl-C] no console antes de executar o próximo exemplo (apenas um exemplo por vez pode ocupar a porta 4200).
Os exemplos 22 a 25 consultam o servidor JSON do [RdvMedecins]: é preciso tê-lo instalado e em execução, conforme explicado no capítulo dedicado a ele.
1.4. Conteúdo do documento
Capítulo | Conteúdo | Exemplos |
Primeiros passos | Um workspace Angular, signals, templates, eventos, formulários (ngModel, formulários baseados em signals, formulários reativos), validação, pipes | 01–09 |
Componentes | Inputs, outputs, `model()`, projeção de conteúdo, ciclo de vida, serviços e injeção de dependência, diretivas, caixa de diálogo de confirmação | 10–16 |
Roteamento | o roteador, guards de navegação | 17 e 18 |
Observables e estado compartilhado | RxJS, serviços com signals | 19 e 20 |
Internacionalização | Uma aplicação em francês e inglês | 21 |
O servidor, uma caixa-preta | Instalação do servidor JSON, sua API, exemplos de curl | - |
Comunicação com o servidor | HttpClient, login e cookies, interceptor, camada de acesso à API, httpResource, erros do servidor | 22 a 25 |
Estudo de caso | O cliente Angular da aplicação RdvMedecins | - |
Implantação | O cliente compilado, servido pelo servidor JSON | - |
Cada exemplo é apresentado com seu código completo, comentado linha por linha, e uma captura de tela de sua execução. O próprio código é amplamente comentado: esses comentários fazem parte do curso.