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.
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:
-
Para a rota
/, a propriedadehome, se não for nula, é usada. -
Caso contrário, a tabela
routesé usada, se tiver uma entrada para a rota. -
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 porhomenem porroutes. -
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:
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.