Tratando 404: erro de página não encontrada no Flutter

Aprenda a tratar erros 404 e criar uma página personalizada de página não encontrada no seu app web Flutter.

A página 404 do Flutter combina uma mensagem de página ausente com links para a página inicial, a documentação e outros recursos.

O Flutter lançou suporte para web, que permite criar sites dinâmicos. O Flutter oferece suporte ao tratamento de qualquer erro que possa surgir no uso da web, como erros 404. Mas como criar uma página 404 personalizada para o seu app Flutter?

Este artigo descreve como criar páginas personalizadas que são exibidas sempre que um usuário navega para uma página que não existe.

Como redirecionar clientes para uma página 404 personalizada no Flutter

Todo mundo já encontrou um “404: página não encontrada” ao navegar na internet. O Flutter lida com esse problema redirecionando você automaticamente para a rota inicial. Normalmente, é a página inicial do seu app. Mas e se você quiser ter uma página 404 sofisticada como as da Airbnb, do GitHub ou até mesmo do site do Flutter? Você pode fazer isso facilmente com o Flutter.

Para criar uma página 404 personalizada, seu app precisa usar o widget MaterialApp, CupertinoApp ou WidgetsApp. A maioria dos apps usa um desses três widgets; é o primeiro widget que você chama ao criar um app Flutter.

O MaterialApp configura o Navigator de nível superior para procurar rotas na seguinte ordem:

  1. Para a rota /, a propriedade home , se não for nula, é usada.

  2. Caso contrário, a tabela routes é usada, se tiver uma entrada para a rota.

  3. Caso contrário, onGenerateRoute é chamado, se fornecido. Ele deve retornar um valor não nulo para qualquer rota válida que não seja tratada por home nem por routes.

  4. Por fim, se nada mais funcionar, onUnknownRoute é chamado.

Se a sua rota não for tratada em nenhuma dessas tabelas, ela usa a propriedade onUnknownRoute para tratar a navegação. Esse callback normalmente é usado para tratamento de erros. Por exemplo, essa função pode sempre gerar uma página de “não encontrado” que descreve a rota que não foi encontrada. Rotas desconhecidas podem surgir de erros no app ou de requisições externas para abrir rotas, como intents do Android.

O exemplo a seguir demonstra como definir uma função anônima para a propriedade onUnknownRoute , que recebe um RouteFactory, um método de fábrica que recebe um RouteSettings function como entrada e retorna um Route. O trecho a seguir mostra como é simples definir a propriedade onUnknownRoute:

dart
onUnknownRoute: (settings) {
​
  return MaterialPageRoute(builder: (_) => PageNotFound());
​
},

PageNotFound é um widget personalizado que cria a página 404. Esta página pode explicar o que aconteceu e redirecionar o usuário para a página inicial, mas você pode ser tão criativo quanto quiser ao criar sua página 404.

Considerações finais

Ao criar um app Flutter, é importante tratar quaisquer problemas que possam surgir. Usar a propriedade onUnknownRoute dentro de MaterialApp, CupertinoApp ou WidgetApp permite que você trate os inevitáveis erros de “página não encontrada” no seu site.

Para saber mais sobre rotas no Flutter, veja o post do blog “Navegando por URLs usando rotas nomeadas”.

Sobre o autor: Jose se formou na universidade recentemente e agora trabalha no Material, um design system que ajuda equipes a criar experiências digitais de alta qualidade. A equipe de Jose mantém a biblioteca material do Flutter. Para saber mais, visite as páginas de Jose no GitHub, LinkedIn, YouTube e Instagram.

Mais do Flutter