Introduzindo a aula e revisando o Figma
Bem-vindos à nossa segunda aula do primeiro módulo. O objetivo desta aula é entender a estrutura do projeto, como ele está organizado e como cada componente se correlaciona. Antes de começarmos a explorar o projeto, vamos revisar o Figma que vimos na aula anterior e detalhá-lo um pouco.
O primeiro ponto é que este Figma é composto por alguns componentes que criamos dentro do projeto que vamos analisar. O primeiro componente que abordaremos é o header. Este header é a estrutura que estamos destacando no Figma, contendo a parte do título e a imagem. Isso é o que definimos como header.
Explorando o componente Header
Para começar a entender como esses componentes são implementados, vamos dar uma olhada no código do componente Header:
import { Image, ImageSourcePropType, Text, View } from "react-native";
import { StarIcon } from "../icons/StarIcon";
type HeaderProps = {
name: string;
image: ImageSourcePropType;
};
export default function Header({ name, image }: HeaderProps) {
return (
<View>
<Text>DEV { name }</Text>
<StarIcon />
<View>
<View></View>
<Image source={ image } />
</View>
</View>
)
}
Este componente Header é construído como uma View, dividida em duas camadas: a primeira camada é o título e o ícone. O ícone é um componente SVG que foi convertido para ser utilizado no projeto.
Analisando o componente InfoText
Em seguida, temos uma segunda estrutura chamada infotext. Este infotext é o componente que vai do título superior até o texto de descrição. Vamos ver como ele é estruturado no código:
import { Text, View } from "react-native";
type InfoTextProps = {
title: string;
highlightTitle?: string;
description: string
}
export default function InfoText({ title, highlightTitle, description }: InfoTextProps) {
return (
<View>
<Text>{ title }</Text>
<Text>{ highlightTitle }</Text>
<Text>{ description }</Text>
</View>
)
}
O InfoText é composto por três textos: um título, um título em destaque e uma descrição, que são passados como parâmetros.
Implementando o PrimaryButton
A seguir, temos um botão chamado primary button, que é o botão em azul claro. Vamos ver como ele é implementado:
import { Pressable, PressableProps, Text } from "react-native";
type PrimaryButtonProps = PressableProps & {
title: string;
}
export default function PrimaryButton({ title, ...rest }: PrimaryButtonProps) {
return (
<Pressable {...rest}>
<Text>{ title }</Text>
</Pressable>
)
}
O PrimaryButton é um componente clicável que recebe um título e outras propriedades de um Pressable.
Construindo o SocialButton
Além disso, temos um social button. Este outro botão, próximo ao primary button, difere em alguns aspectos de raio e cores. Este é o nosso social button. Vamos ver como ele é construído:
import { Pressable, PressableProps, Text } from "react-native";
import { GitHubIcon } from "../icons/GitHub";
import { InstagramIcon } from "../icons/Instagram";
import { LinkedinIcon } from "../icons/Linkedin";
import { TwitchIcon } from "../icons/Twitch";
export enum SocialNetworks { github, instagram, linkedin, twitch }
type SocialButtonProps = PressableProps & {
socialNetwork: SocialNetworks;
};
const icon = (socialNetwork: SocialNetworks) => {
switch (socialNetwork) {
case SocialNetworks.github: return <GitHubIcon />
case SocialNetworks.instagram: return <InstagramIcon />
case SocialNetworks.linkedin: return <LinkedinIcon />
case SocialNetworks.twitch: return <TwitchIcon />
}
}
const title = (socialNetwork: SocialNetworks) => {
switch (socialNetwork) {
case SocialNetworks.github: return 'GitHub'
case SocialNetworks.instagram: return 'Instagram'
case SocialNetworks.linkedin: return 'LinkedIn'
case SocialNetworks.twitch: return 'Twitch'
}
}
export default function SocialButton({ socialNetwork, ...rest }: SocialButtonProps) {
return (
<Pressable {...rest}>
{icon(socialNetwork)}
<Text>{ title(socialNetwork) }</Text>
</Pressable>
)
}
O SocialButton é um componente mais complexo que utiliza um enumerador para determinar qual ícone e título exibir, dependendo da rede social selecionada.
Implementando o Footer
Por fim, temos uma estrutura chamada footer, que é a estrutura final que fala sobre o projeto, quem o desenvolveu e as licenças do projeto. Vamos ver como ele é implementado:
import { Text, View } from "react-native"
export default function Footer() {
return (
<View>
<Text>Desenvolvido por Alura. Projeto fictício sem fins comerciais.</Text>
</View>
)
}
O Footer é uma simples View com um texto informativo.
Explorando a estrutura do projeto
Agora, vamos explorar o projeto. Ao baixá-lo e abri-lo, inicialmente veremos a estrutura de pastas. Por onde começamos? Vamos começar pela pasta "app". Dentro dela, encontraremos um arquivo chamado index.tsx, que é o nosso primeiro arquivo, a primeira tela da nossa aplicação React. Estamos trabalhando com Expo, e esta tela é a primeira que o Expo vai ler.
Como está estruturada esta tela? Temos uma ScrollView, um componente de rolagem do React, para que possamos deslocar nossa tela. Em seguida, temos o componente header, que contém o título e uma imagem. Mais adiante, entenderemos em detalhe o significado de cada parâmetro.
Analisando a tela inicial
Aqui está o código da tela inicial:
import profile from '@/assets/configs/profile.json'
import Footer from '@/components/Footer'
import Header from '@/components/Header'
import InfoText from '@/components/InfoText'
import PrimaryButton from '@/components/PrimaryButton'
import SocialButton, { SocialNetworks } from '@/components/SocialButton'
import { router } from 'expo-router'
import { Linking, ScrollView, Text } from 'react-native'
export default function Home() {
return (
<ScrollView>
<Header name={profile.name} image={require('@/assets/images/profile.png')} />
<InfoText title='Eleve seu negócio digital a outro nível' highlightTitle='com qualidade!' description={profile.description} />
<PrimaryButton title='Sobre mim' onPress={() => router.push('/pages/AboutMe')} />
<PrimaryButton title='Entre em Contato' onPress={() => Linking.openURL(`tel:${profile.phone}`)} />
<Text>Acesse minhas redes:</Text>
<SocialButton socialNetwork={SocialNetworks.github} onPress={() => Linking.openURL(profile.github)} />
<SocialButton socialNetwork={SocialNetworks.linkedin} onPress={() => Linking.openURL(profile.linkedin)} />
<SocialButton socialNetwork={SocialNetworks.instagram} onPress={() => Linking.openURL(profile.instagram)} />
<SocialButton socialNetwork={SocialNetworks.twitch} onPress={() => Linking.openURL(profile.twitch)} />
<Footer />
</ScrollView>
)
}
Este código mostra como os componentes são organizados na tela inicial, utilizando a ScrollView para permitir a rolagem e incluindo todos os componentes que discutimos.
Explorando os componentes e a navegação
Vamos começar a explorar cada um desses componentes. O primeiro deles é o header. Onde estão localizados? Na pasta "components" do nosso projeto, temos alguns componentes que vamos utilizar. Eles estão separados por pastas, e dentro de cada pasta, temos a estrutura criada do componente.
O primeiro deles, o header, é construído como uma View, dividida em duas camadas: a primeira camada é o título e o ícone. Onde está esse ícone? Na pasta "icons", temos vários ícones. Esses ícones são SVGs que foram convertidos e recriados como componentes. O projeto já traz tudo isso para nós.
Não precisamos entender como é feita a conversão de forma direta. No entanto, é importante saber que este ícone é basicamente o SVG que estava no Figma. Não vamos nos aprofundar em como ocorre essa troca, pois não é o objetivo deste curso, e essa conversão pode ser feita de diversas maneiras. Podemos utilizar algumas ferramentas automáticas que fazem a conversão de SVG para um componente React. Neste caso, utilizamos uma ferramenta automática para essa conversão, mas não detalharemos como ela é feita. O importante é que no projeto já está tudo configurado para uso.
Detalhando a estrutura do Header e InfoText
Voltando ao nosso header, do qual estávamos falando, temos uma primeira estrutura de título e ícone, que estão sendo criados aqui. Abaixo, temos uma segunda estrutura, que é a estrutura da nossa imagem. Temos uma View aqui e nossa imagem. O que é essa View? Essa View é justamente a que existe atrás da nossa imagem. Observem que há um detalhe, um acessório atrás, que será feito com essa View. Teremos uma imagem na frente e um detalhe, um acessório, atrás, que será criado através dessa View inicialmente configurada.
Voltando à nossa página, o que mais temos aqui? Temos o InfoText a seguir. Como está estruturado esse InfoText? Basicamente, são três textos: um título, um Highlight Title e uma Description que é enviada via parâmetro. Esses textos são os que estão no Figma. Aqui temos: "leve seu negócio digital a outro nível, com qualidade". Tudo que está em branco é o que chamamos de Title. Em azul, será nosso Highlight Title, e por último, nossa Description. Essa mesma estrutura se repete na tela "Sobre mim". A mesma estrutura está presente aqui, assim como o Header. Vamos reutilizar esses componentes para as duas telas.
Explorando a tela "Sobre mim" e o PrimaryButton
Onde está essa segunda tela "Sobre mim"? Está dentro de "Pages", temos um About Me e um Index, que contém a estrutura da tela "Sobre mim". Falaremos sobre ela com calma em breve. Voltando à nossa estrutura inicial, temos o InfoText e, em seguida, um Primary Button. O que é esse Primary Button? É o botão azul, que temos no "Sobre mim" e no "Contate-me". Como está sendo criado? É um Pressable, ou seja, um componente clicável, com um título dentro. É assim que estamos criando nosso Primary Button.
A seguir, temos um texto comum do React. Nada mais. Apenas um texto React aqui dentro. Depois, temos um Social Button. Este Social Button é o componente mais complexo de entender, pois possui mais estruturas internas. Como está sendo criado? Primeiro, foi criada uma estrutura, um enumerador, onde podemos utilizar alguns casos. Aqui, passamos ou um GitHub, ou um Instagram, ou um LinkedIn, ou um Twitch. Criamos casos de enumerador aqui dentro. Nosso componente recebe um desses casos. Sempre passaremos ou um GitHub, ou um Instagram, ou um LinkedIn, ou um Twitch. Dentro desse componente, temos constantes que verificam o case com o qual estamos trabalhando e nos devolvem essas constantes, indicando qual é o texto, o título, de acordo com o case que estamos lidando, ou qual é o ícone conforme esse case. Onde estão esses ícones? Na pasta "Icon". Segue a mesma estrutura; todos os ícones estão lá dentro e os usamos aqui para construir nosso componente como um todo.
Concluindo com o Footer e próximos passos
Como está sendo construído esse componente? Um Pressable, com um ícone e um texto dentro. Temos as duas estruturas internas com as quais trabalharemos para chegar à estrutura final do botão de rede social.
Por último, temos nosso footer. Como está sendo trabalhado esse footer? Basicamente, uma View e um texto, nada mais. Isso permanecerá assim até o final do projeto? Não, trabalharemos para modificar essa estrutura para que receba o estilo que temos no Figma. Todas as estruturas que estamos vendo aqui são iniciais e sem estilização. Qual é o objetivo do curso? Trabalhar todos esses componentes e estruturas para que possamos alcançar o estilo proposto no Figma. Faremos isso nas próximas aulas, mas antes de começarmos, na próxima aula, vamos discutir de onde vêm os dados, de onde vem cada dado para esta tela e como essas telas estão sendo construídas em termos de navegação. Falaremos sobre isso na próxima aula.
Até a próxima! Obrigado por nos acompanhar até aqui e nos vemos na próxima aula!