Criando uma Página de Erro Personalizada com React Router

Entenda como criar uma página de erro personalizada em aplicações React utilizando o React Router.

Criando uma Página de Erro Personalizada com React Router

No desenvolvimento de aplicações web, é comum nos depararmos com rotas que não existem ou que não podem ser acessadas. Uma boa prática é redirecionar o usuário para uma página de erro personalizada, que pode fornecer informações úteis ou opções de navegação. Neste tutorial, vamos aprender como implementar essa funcionalidade utilizando o React Router.

O que é o React Router?

React Router é uma biblioteca que permite a navegação entre diferentes componentes em uma aplicação React, facilitando a criação de aplicações de página única (SPA). Ele gerencia as rotas e permite que você defina quais componentes devem ser renderizados em cada URL.

Passo 1: Instalando o React Router

Primeiro, precisamos instalar o React Router em nosso projeto. Abra o terminal e execute o seguinte comando:

npm install react-router-dom

Esse comando instalará a biblioteca necessária para gerenciar nossas rotas.

Passo 2: Criando a Estrutura Básica

Agora, vamos criar uma estrutura básica para nossa aplicação. Crie um arquivo App.js e adicione o seguinte código:

import React from 'react';
import { BrowserRouter as Router, Route, Switch } from 'react-router-dom';
import Home from './Home';
import NotFound from './NotFound';

function App() {
    return (
        <Router>
            <Switch>
                <Route exact path='/' component={Home} />
                <Route component={NotFound} />
            </Switch>
        </Router>
    );
}

export default App;

Neste código, estamos utilizando o BrowserRouter para gerenciar as rotas. O Switch renderiza a primeira Route que corresponder ao caminho, e, se nenhuma rota for encontrada, renderiza o componente NotFound.

Passo 3: Criando a Página de Erro Personalizada

Agora, vamos criar o componente NotFound.js que será exibido quando o usuário acessar uma rota inexistente. Crie um arquivo NotFound.js e adicione o seguinte código:

import React from 'react';

function NotFound() {
    return (
        <div>
            <h2>404 - Página Não Encontrada</h2>
            <p>Desculpe, a página que você está procurando não existe.</p>
            <a href='/'>Voltar para a Home</a>
        </div>
    );
}

export default NotFound;

Esse componente renderiza uma mensagem informando que a página não foi encontrada e oferece um link para retornar à página inicial.

Passo 4: Testando a Aplicação

Agora que temos tudo configurado, vamos testar nossa aplicação. Execute o comando:

npm start

Acesse a URL http://localhost:3000/ para ver a página inicial e tente acessar uma URL inexistente como http://localhost:3000/some-non-existing-page. Você deverá ser redirecionado para a nossa página de erro personalizada.

Conclusão

Neste tutorial, aprendemos como implementar uma página de erro personalizada no React Router. Essa prática não apenas melhora a experiência do usuário, mas também ajuda a direcioná-los de volta para o conteúdo relevante da aplicação. Com o React Router, você pode facilmente gerenciar suas rotas e criar uma navegação mais amigável.

Dicas Finais:

  • Personalize a sua página de erro de acordo com a identidade visual da sua aplicação.
  • Considere adicionar links para as páginas mais populares ou um formulário de contato para feedback.

A implementação de uma página de erro é um passo importante para garantir que seu aplicativo seja robusto e amigável ao usuário.

Ter uma página de erro personalizada é essencial para qualquer aplicação web. Isso não apenas melhora a experiência do usuário, mas também ajuda a manter a navegação fluida, mesmo quando o usuário tenta acessar uma rota que não existe. Ao adaptar mensagens de erro, você pode guiar os usuários de volta ao caminho certo, minimizando frustrações e potenciais abandonos da aplicação. Uma página de erro eficaz pode incluir links úteis, informações de contato ou até mesmo sugestões de conteúdos relacionados, criando um ambiente mais acolhedor e informativo para os visitantes.

Algumas aplicações:

  • Melhorar a experiência do usuário ao navegar em sua aplicação.
  • Reduzir a taxa de abandono de usuários, direcionando-os para conteúdos relevantes.
  • Manter a identidade visual da aplicação, mesmo em páginas de erro.
  • Oferecer suporte ao usuário através de links úteis e informações de contato.

Dicas para quem está começando

  • Sempre teste suas rotas para garantir que a página de erro aparece quando necessário.
  • Mantenha a mensagem de erro clara e amigável.
  • Inclua links que ajudem o usuário a voltar à navegação normal.
  • Considere adicionar um formulário de feedback na página de erro.

Contribuições de Gabriel Nogueira

Compartilhe este tutorial: Como carregar uma página de erro personalizada para rotas inacessíveis no React Router?

Compartilhe este tutorial

Continue aprendendo:

Como definir regras de acesso para diferentes níveis de usuário no React Router?

Entenda como implementar regras de acesso para diferentes níveis de usuário utilizando o React Router.

Tutorial anterior

Como implementar um sistema de 'favoritos' baseado na URL no React Router?

Tutorial completo sobre a implementação de um sistema de favoritos no React Router.

Próximo tutorial