Skip to content

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:

Image

  • 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:

Image

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:

1
2
3
4
deliverable/
├── examples-angular/          the 25 small Angular examples
├── rdvmedecins-nestjs-json/   the RdvMedecins JSON server (the "black box")
└── rdvmedecins-angular/       the Angular client of the case study

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:

examples-angular/
├── 01-first-application/
├── 02-signals/
├── ...
├── 25-server-errors/
├── common/              code shared by examples 24 and 25
├── node_modules/
├── angular.json         the description of the twenty-five applications
├── package.json
├── proxy.conf.json      the proxy to the JSON server (examples 22 to 25)
└── tsconfig.json

Instale as bibliotecas uma única vez, em um console aberto na pasta [examples-angular] (no [VS Code]: menu Terminal / Novo Terminal):

npm install

Em seguida, execute um exemplo digitando seu nome:

npm start 01-first-application

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.