Contextualizando o projeto Climap
Vamos contextualizar o projeto que utilizaremos durante nosso curso. Estamos analisando o Climap. Na tela inicial, temos a tela de boas-vindas, onde o projeto é apresentado e podemos entender mais sobre ele. Ao clicar no botão "entrar", somos redirecionados para a tela inicial, como podemos ver na barra de navegação. Nessa tela, podemos visualizar todas as cidades turísticas disponíveis e, de forma resumida, algumas informações sobre cada localidade e destino turístico. Há um campo de busca para procurar pelo nome da cidade e vários destinos. Temos o nome do destino e a temperatura local no momento. Vamos clicar em Florianópolis, por exemplo. Ao clicar, somos redirecionados para outra tela, a tela de detalhes, como aparece na barra de navegação. Nela, temos a barra de detalhes, barra Florianópolis, pois foi a cidade selecionada. Aqui, encontramos informações detalhadas sobre o destino, como o nome da cidade, o nome do estado, informações de temperatura mais detalhadas, incluindo umidade, temperatura mínima e máxima, e previsão para os próximos dias. No lado direito da tela, há uma seção para configuração de notificações. A ideia é que a pessoa usuária possa se inscrever em um boletim informativo para ser atualizada. Sempre que a temperatura do destino mudar, será notificada por e-mail. Além de inserir o e-mail, é possível configurar alertas, como receber a previsão para quatro dias à frente, saber a temperatura atual e futura, receber alertas de chuva, escolher a unidade de temperatura (Celsius ou Fahrenheit) e personalizar conforme suas necessidades.
Essa é nossa aplicação: simples, com três telas, mas bastante completa para o propósito que busca resolver. Agora, vamos ver como essa tela e o projeto estão estruturados no código. Estamos na tela inicial e vamos abrir nosso código para visualizar a estrutura. Estamos com o projeto de front-end em Angular aberto e, ao abrir a pasta src, encontramos outra pasta chamada "app". Dentro dela, há duas pastas importantes: a pasta "data", que contém um arquivo com todas as informações das cidades que vimos. Se quisermos alterar o arquivo cities.ts dentro da pasta "data", veremos essas mudanças refletidas nas telas, ou seja, todas as informações aparecem na nossa aplicação front-end.
Definindo tipos de dados no projeto
Para entender melhor como as informações das cidades são estruturadas, vamos dar uma olhada no tipo de dados que estamos utilizando. Primeiro, definimos os tipos para os dados de previsão e cidade:
export type ForecastDay = {
label: string;
date: string;
min: number;
max: number;
}
export type City = {
id: string;
name: string;
current: number;
condition: string;
humidity: number;
min: number;
max: number;
todayLabel: string;
todayDate: string;
forecast: ForecastDay[];
};
Esses tipos nos ajudam a garantir que os dados que manipulamos estão no formato correto. Agora, vamos ver como esses dados são utilizados na nossa aplicação.
Além da pasta "data", temos a pasta "pages", que é crucial, pois ao abri-la, podemos visualizar as três telas que acabamos de ver: a tela de introdução, onde a pessoa usuária é recebida; a tela inicial, onde é possível visualizar todos os destinos e uma breve informação sobre eles, como a temperatura; e a tela de detalhes, que mostra informações detalhadas do destino. Aqui está a separação de cada uma dessas páginas no código.
Explorando a estrutura do projeto em Angular
Se abrirmos a tela de detalhes, por exemplo, veremos que cada página segue a estrutura padrão do Angular, com três arquivos: HTML, TypeScript e CSS. Todas as pastas do projeto seguem essa estrutura, que é importante para o padrão Angular. Agora que conhecemos a estrutura do projeto, vamos entender o que faremos na aula de hoje. Hoje aprenderemos a utilizar o two-way binding (vinculação bidirecional). Para que serve o two-way binding? Vamos contextualizar: na tela de detalhes, ao clicar na cidade de Florianópolis, temos o campo "escreva seu e-mail" para se inscrever nas atualizações. A questão é: hoje, se escrevemos nosso e-mail e clicamos em enviar, o que acontece? Ao clicar em enviar, aparece "cadastro realizado", mas há um espaço vazio. Esse espaço deveria mostrar o e-mail digitado, como "arielpaixã[email protected]", mas não aparece, pois o campo existe apenas no HTML. Precisamos fazer com que o campo no HTML envie a informação para nosso arquivo TypeScript, para que a informação digitada seja reconhecida.
No front-end, geralmente utilizamos três tecnologias: HTML, CSS e TypeScript. O HTML dá a estrutura da página, o CSS a estética, e o TypeScript dá vida à página, processando e interagindo com a pessoa usuária. Atualmente, o campo de entrada de e-mail está apenas no HTML, mas precisamos transferir a informação digitada para nosso arquivo TypeScript, para que o dado seja utilizado corretamente. Vamos entender como fazer isso. Temos o campo "inscreva-se para atualizações", onde podemos escrever nosso e-mail. Vamos encontrar esse campo no arquivo HTML. Vamos abrir o código, acessar o arquivo details.component.html, já que estamos na tela de detalhes. No arquivo HTML, na linha 67, encontramos o campo. O placeholder "escreva seu e-mail" é o texto que aparece na tela, exatamente o campo que temos na página de detalhes. Identificamos o campo, mas como fazer a comunicação com o details.component.ts, que dará vida ao campo? Nossa classe de detalhes, uma classe Angular normal, já possui uma propriedade chamada email, uma variável onde guardaremos o e-mail digitado. Já temos quase tudo estruturado. O que falta? Falta fazer o binding, o fluxo que transmitirá a informação do HTML para o arquivo TypeScript. Como fazer isso? É simples: no campo de entrada de e-mail, podemos adicionar a seguinte sintaxe de Angular para usar o two-way binding.
Explicação sobre o uso do ngModel no Angular
Vamos discutir o uso do ngModel no Angular. O ngModel é utilizado para vincular dados entre o HTML e o arquivo TypeScript. Para isso, precisamos especificar a propriedade onde queremos armazenar o valor digitado. Por exemplo, se já tivermos uma propriedade chamada email no nosso arquivo TypeScript, podemos utilizá-la para armazenar o valor.
Se estivermos criando uma aplicação do zero e precisarmos de uma nova propriedade, basta adicioná-la na classe do arquivo TypeScript. Suponhamos que estamos desenvolvendo uma aplicação de pedidos de comida. Podemos adicionar uma nova propriedade chamada pedido e inicializá-la conforme necessário. No nosso caso, a propriedade email já foi criada previamente para agilizar o processo.
Agora, voltando ao HTML, na linha 67, dentro do ng-model, adicionamos a propriedade email. Após salvar o código, o ng-model deve funcionar corretamente, desde que o FormsModule esteja importado no arquivo details.component.ts. Caso contrário, o HTML não entenderá o ng-model, pois é uma sintaxe específica do Angular.
Para garantir que tudo funcione, precisamos importar o FormsModule no arquivo details.component.ts. Se não estiver importado, o ng-model não funcionará. No Visual Studio Code, ao digitar FormsMod, ele sugere a importação do FormsModule do @angular/forms. Ao clicar na sugestão, a importação é feita automaticamente.
Com o FormsModule importado, o código deve funcionar corretamente. O ng-model permite o two-way data binding, ou seja, a conexão entre o HTML e o arquivo TypeScript. Quando digitamos algo no campo de entrada no HTML, o Angular, através do ng-model, transmite essa informação para a propriedade email no arquivo TypeScript.
Ao clicar no botão na linha 69, que chama o método subscribe, o método exibe um alerta na tela com a mensagem "cadastro realizado" e o e-mail digitado. Isso demonstra o funcionamento do two-way data binding, onde a informação é transmitida do HTML para o TypeScript.
Para entender por que é chamado de two-way data binding, consideremos que a informação pode fluir em ambos os sentidos. No exemplo, ao preencher o campo de e-mail no HTML, o ng-model envia a informação para o TypeScript. O fluxo contrário ocorre quando, no arquivo details.component.ts, inicializamos a propriedade email com um valor de teste. Ao recarregar a página, o campo de e-mail já aparece preenchido, demonstrando o fluxo de dados do TypeScript para o HTML.
Portanto, o two-way data binding permite a troca de informações entre o HTML e o TypeScript, possibilitando a criação de aplicações dinâmicas e interativas.