Quickstarters
Como construir um frontend Nuxt.js e conectá-lo a um backend?
36 min
neste tutorial, você construirá um aplicativo de lista de tarefas usando nuxt js e o conectará a um serviço de backend gerenciado alimentado pelo back4app este guia é feito para você se quiser dominar operações crud essenciais (criar, ler, atualizar, excluir) e criar uma interface dinâmica e responsiva usando nuxt js ao final deste tutorial, seu aplicativo interagirá perfeitamente com um backend que gerencia armazenamento de dados, autenticação e muito mais desenvolver um aplicativo full stack pode ser desafiador devido à configuração do backend e ao gerenciamento de banco de dados para simplificar seu processo, usamos o back4app— um poderoso backend como serviço —permitindo que você se concentre no desenvolvimento de um frontend rico em recursos com nuxt js o back4app fornece um banco de dados nosql totalmente gerenciado, autenticação de usuários, cloud code para lógica personalizada e sdks para integração sem esforço isso permite que você construa e implante aplicativos escaláveis sem lidar com a infraestrutura do servidor principais conclusões ao seguir este tutorial, você irá inicializar um projeto moderno de nuxt js usando o nuxt cli integrar um serviço de backend para gerenciar os dados do seu aplicativo implementar operações crud essenciais para uma lista de tarefas dinâmica implantar seu aplicativo totalmente funcional usando fluxos de trabalho em contêiner no back4app pré requisitos antes de começar, certifique se de que você tem node js e npm instalados em sua máquina confirme as instalações com node v e npm v conhecimento básico de nuxt js , incluindo componentes, páginas e busca de dados assíncrona uma conta back4app para gerenciar seus serviços de backend inscreva se em back4app https //www back4app com/ se você ainda não tiver com esses pré requisitos em ordem, você está pronto para começar a construir seu projeto configuração do projeto comece configurando seu ambiente de desenvolvimento local e inicializando um novo projeto nuxt js certifique se de que você tem node js (versão lts) instalado se não, baixe o de nodejs org https //nodejs org/ crie seu projeto nuxt js usando o nuxt cli npx nuxi init todo app navegue até o diretório do seu projeto cd todo app instale as dependências necessárias npm install inicie o servidor de desenvolvimento para verificar a configuração npm run dev abra a url fornecida no seu navegador para ver seu aplicativo nuxt js em ação com seu frontend pronto, prossiga para criar seu backend no back4app criando o backend todo back4app oferece um serviço de backend totalmente gerenciado, alimentado por parse , que inclui um banco de dados nosql, autenticação, cloud code e apis geradas automaticamente siga estas etapas para configurar seu backend faça login na sua painel do back4app https //www back4app com/ e clique "criar um novo app " nomeie seu app (por exemplo, todoapp ) e selecione nodejs/parse como o tipo de backend navegue até "banco de dados" > "navegador" , clique "criar uma classe" , e escolha "personalizado" nomeie a classe tarefa e defina suas permissões para permitir leitura e escrita públicas (você pode refinar essas configurações mais tarde) na classe tarefa , adicione os seguintes campos título (string) – o título da tarefa descrição (string) – detalhes sobre a tarefa concluída (boolean) – status de conclusão da tarefa datadevencimento (data) – o prazo para a tarefa clique "salvar" para criar o esquema integrando o back4app com nuxt js você usará o parse javascript sdk para conectar seu aplicativo nuxt js ao backend do back4app instale o sdk parse npm install parse configure o sdk criando um módulo dedicado por exemplo, crie plugins/parse client js com o seguinte conteúdo import parse from 'parse/dist/parse min js'; const parse app id = 'your application id'; const parse js key = 'your javascript key'; const parse server url = 'https //parseapi back4app com/'; parse initialize(parse app id, parse js key); parse serverurl = parse server url; export default parse; em seguida, registre este plugin em seu nuxt config ts (ou nuxt config js ) export default { plugins \[ { src ' /plugins/parse client js', mode 'client' } ] } agora você pode importar o parse em suas páginas ou componentes para interagir com o backend desenvolvendo o frontend sua aplicação nuxt js consistirá em páginas e componentes para adicionar, exibir, atualizar e excluir tarefas aproveite o roteamento baseado em arquivos do nuxt e a busca de dados assíncrona para criar uma lista de tarefas dinâmica estruturando seus componentes crie uma components pasta em seu projeto para organizar seus componentes de ui mkdir components você irá criar os seguintes componentes taskform vue – para adicionar novas tarefas tasklist vue – para exibir a lista de tarefas taskitem vue – para representar tarefas individuais taskform vue este componente renderiza um formulário que captura os detalhes da tarefa e os envia para o back4app \<template> \<form @submit prevent="handlesubmit"> \<input type="text" placeholder="task title" v model="title" required /> \<input type="text" placeholder="description" v model="description" required /> \<button type="submit">add task\</button> \</form> \</template> \<script> import parse from 'parse/dist/parse min js'; export default { name 'taskform', data() { return { title '', description '' }; }, methods { async handlesubmit() { try { const task = parse object extend('task'); const task = new task(); task set('title', this title); task set('description', this description); task set('completed', false); await task save(); this $emit('refresh'); this title = ''; this description = ''; } catch (error) { console error('error adding task ', error); } } } }; \</script> taskitem vue este componente representa uma tarefa individual e fornece botões para alternar seu status de conclusão ou excluir a tarefa \<template> \<div \ class="\['task item', { completed task completed }]"> \<div> \<h3>{{ task title }}\</h3> \<p>{{ task description }}\</p> \</div> \<div> \<button @click="togglecomplete"> {{ task completed ? 'undo' 'complete' }} \</button> \<button @click="deletetask">delete\</button> \</div> \</div> \</template> \<script> import parse from 'parse/dist/parse min js'; export default { name 'taskitem', props \['task'], methods { async togglecomplete() { try { const query = new parse query('task'); const tasktoupdate = await query get(this task id); tasktoupdate set('completed', !this task completed); await tasktoupdate save(); this $emit('refresh'); } catch (error) { console error('error updating task ', error); } }, async deletetask() { try { const query = new parse query('task'); const tasktodelete = await query get(this task id); await tasktodelete destroy(); this $emit('refresh'); } catch (error) { console error('error deleting task ', error); } } } }; \</script> tasklist vue este componente exibe a lista de tarefas iterando sobre um array e renderizando cada tarefa usando o componente taskitem \<template> \<div> \<p v if="tasks length === 0">no tasks available\</p> \<taskitem v for="task in tasks" \ key="task id" \ task="task" @refresh="refreshtasks" /> \</div> \</template> \<script> import taskitem from ' /taskitem vue'; export default { name 'tasklist', props \['tasks'], methods { refreshtasks() { this $emit('refresh'); } }, components { taskitem } }; \</script> integração de página na sua página principal (por exemplo, pages/index vue , gerencie o estado das tarefas e integre seus componentes \<template> \<div class="container"> \<h1>to do list\</h1> \<taskform @refresh="fetchtasks" /> \<tasklist \ tasks="tasks" @refresh="fetchtasks" /> \</div> \</template> \<script> import taskform from ' /components/taskform vue'; import tasklist from ' /components/tasklist vue'; import parse from 'parse/dist/parse min js'; export default { components { taskform, tasklist }, data() { return { tasks \[] }; }, methods { async fetchtasks() { try { const task = parse object extend("task"); const query = new parse query(task); const results = await query find(); this tasks = results map((task) => ({ id task id, task tojson() })); } catch (error) { console error("error fetching tasks ", error); } }, }, mounted() { this fetchtasks(); } }; \</script> estilizando a aplicação crie uma folha de estilo global (por exemplo, assets/css/main css ) para adicionar estilos básicos container { max width 600px; margin 40px auto; padding 0 20px; text align center; font family sans serif; } h1 { margin bottom 20px; } form { display flex; flex direction column; align items center; gap 10px; margin bottom 20px; } form input\[type="text"] { width 80%; max width 400px; padding 8px; box sizing border box; font size 1rem; } form button { padding 8px 16px; cursor pointer; font size 1rem; border none; background color #eaeaea; transition background color 0 2s ease; } form button\ hover { background color #ccc; } task item { display flex; flex direction column; align items center; justify content center; gap 12px; border 1px solid #ccc; border radius 6px; padding 15px; margin 10px 0; background color #fafafa; text align center; transition background color 0 2s ease; } task item completed h3, task item completed p { text decoration line through; color #888; } task item h3 { margin 0; font size 1 1rem; } task item p { margin 0; font size 1rem; } task item button { padding 6px 12px; border none; background color #eaeaea; cursor pointer; font size 0 9rem; } task item button\ hover { background color #ccc; } @media (min width 600px) { task item { flex direction row; } } inclua esta folha de estilo na sua configuração nuxt adicionando a ao array css em nuxt config ts export default { css \[' /assets/css/main css'] } implantando o frontend na implantação web do back4app a implantação web do back4app oferece um ambiente containerizado para hospedar sua aplicação nuxt js configurando o nuxt js para produção atualize seu nuxt config ts se necessário para definir o caminho base para a implantação export default { router { base ' /' } } gere o build de produção npm run build npm run generate criando um dockerfile crie um dockerfile na raiz do seu projeto com o seguinte conteúdo # stage 1 build the nuxt js app from node 18 alpine as build workdir /app copy package json package lock json / run npm install copy run npm run build run npm run generate \# stage 2 serve the app using nginx from nginx\ alpine copy from=build /app/dist /usr/share/nginx/html expose 80 cmd \["nginx", " g", "daemon off;"] testando o contêiner docker localmente construa sua imagem docker docker build t todo frontend execute o contêiner docker run p 8080 80 todo frontend abra http //localhost 8080 no seu navegador para verificar se seu aplicativo nuxt js está sendo servido corretamente implantando no back4app inicialize um repositório git, adicione seus arquivos de projeto e faça um commit git init git add git commit m "initial commit for back4app deployment" git branch m main git remote add origin \<your github repository url> git push u origin main faça login no back4app web deployment https //www back4app com/containers clique "criar novo app" , forneça o nome do seu projeto e selecione seu repositório do github autorize o back4app e escolha implantação dockerfile confirme as configurações de build e clique "implantar" para iniciar a implantação monitorando sua implantação após a implantação, use o painel do back4app para ver logs para depuração monitorar o desempenho do contêiner e o uso de recursos acionar reconstruções em novos commits configurar domínios personalizados, se necessário acesse seu aplicativo ao vivo em https //todoapp ku5ofg8s b4a run/ https //todoapp ku5ofg8s b4a run/ https //todoapp ku5ofg8s b4a run/ testes e depuração após a implantação, confirme que seu frontend nuxt js se comunica corretamente com o backend back4app verificação da api use as ferramentas de desenvolvedor do seu navegador (f12 → rede) para inspecionar chamadas de api operações de tarefas adicione, complete e exclua tarefas pela interface do usuário e verifique as atualizações no navegador de banco de dados back4app tratamento de erros verifique os logs do console em busca de erros e teste casos extremos, como envios vazios teste de desempenho simule condições de rede lentas usando ferramentas do navegador para avaliar a capacidade de resposta melhores práticas para usar back4app com nuxt js para otimizar seu aplicativo requisições eficientes use operações em lote para lidar com várias tarefas const tasks = \[task1, task2, task3]; parse object saveall(tasks); consultas otimizadas recupere apenas os campos necessários query select('title', 'completed'); gerenciamento de ambiente armazene chaves sensíveis em variáveis de ambiente nuxt public parse app id=your app id nuxt public parse js key=your js key segurança use acls para restringir o acesso task setacl(new parse acl(parse user current())); descarregamento de backend utilize cloud code para lógica complexa para reduzir a exposição da api conclusão você agora construiu uma aplicação de lista de tarefas full stack criando um frontend em nuxt js, integrando o com o backend do back4app e implantando o usando fluxos de trabalho em contêiner este tutorial guiou você por cada etapa—desde o desenvolvimento local até a implantação na nuvem—garantindo uma interação perfeita entre sua interface nuxt js e os serviços de backend olhando para o futuro, considere melhorias como atualizações em tempo real, autenticação aprimorada e integrações de terceiros para mais aprendizado, visite a documentação do back4app https //www back4app com/docs e explore recursos da comunidade