Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.2.1-prerelease

riverpod_navigation

Gerenciando navegação do Flutter com riverpod

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
14
Curtidas
27
Pontos Pub
120

Instalar pacote

flutter pub add riverpod_navigation

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

RiverpodNavigation é um pacote Flutter que simplifica a gestão de navegação ao se integrar perfeitamente com o sistema de gerenciamento de estado Riverpod. Ele oferece uma abordagem reativa e segura por tipo para lidar com rotas e eventos de navegação, permitindo que desenvolvedores gerenciem a navegação do aplicativo de forma declarativa e eficiente. Ao aproveitar a injeção de dependência e o gerenciamento de estado do Riverpod, ele permite uma separação clara de responsabilidades entre a lógica de roteamento e os componentes da interface. O pacote suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, tornando-o ideal para aplicações multiplataforma.

Casos de uso

  • Gerenciamento declarativo de rotas
  • Navegação multiplataforma
  • Fluxos de navegação reativos
  • roteamento impulsionado por estado
  • Integração com o estado Riverpod
  • Manipulação de rota dinâmica

Principais recursos

  • Navegação impulsionada pelo Riverpod
  • Definições de rota seguras por tipo
  • Atualizações de navegação reativas
  • Design agnóstico de plataforma
  • Separação clara da lógica de roteamento
  • Suporte para navegadores aninhados

Indicado para

  • Desenvolvedores usando Riverpod
  • Aplicativos Flutter multiplataforma
  • Cenários complexos de navegação
  • Aplicativos que exigem roteamento consciente de estado
  • Equipes priorizando código mantido
  • Projetos com requisitos de rota dinâmica

Considerações

  • Requer conhecimento sobre Riverpod
  • Pode aumentar o código boilerplate para aplicativos simples
  • Curva de aprendizado para novos usuários
  • Documentação limitada em comparação com alternativas
  • Não adequado para projetos não-Riverpod
  • Sobrecarga de desempenho potencial em navegadores grandes

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Navigation for Riverpod

Managing Flutter navigation with riverpod.

Usage

Bootstrap

Replace your root ProviderScope with a RiverpodNavigation widget with your routing hierarchy and give the provided delegate and parser to your MaterialApp.router factory.

  final routes = RouteDefinition(
      template: UriTemplate.parse('/'),
      builder: (context, entry) => MaterialPage(
        child: HomeLayout(),
      ),
      next: [
        RouteDefinition(
          template: UriTemplate.parse('/articles/:id'),
          builder: (context, entry) => MaterialPage(
            child: ArticleLayout(
              id: entry.parameters['id']!,
            ),
          ),
        ),
      ],
    );
    return RiverpodNavigation( // Replaces your root ProviderScope
      routes: routes,
      builder: (context, delegate, parser) => MaterialApp.router(
        title: 'Flutter Demo',
        routerDelegate: delegate,
        routeInformationParser: parser,
      ),
    );
Navigate
From a provider

A navigationProvider is exposed and can be used to read the current navigation state.

To access the underlying notifier that allows various actions, use the navigationProvider.notifier provider.

final myProvider = Provider<MyState>((ref) {
        final navigation = ref.watch(navigationProvider.notifier);
        return MyState(
            navigateToArticles: () {
                navigation.navigate(Uri.parse('/articles'))
            },
            pop: () {
                navigation.pop();
            }
        );
    },
);
From a BuildContext

The notifier can be accessed with the navigation extension method from the BuildContext.

@override
Widget build(BuildContext context) {
    return TextButton(
        child: Text('Articles'),
        onPressed: () {
            context.navigation.navigate(Uri.parse('/articles'))
        }
    );
}
Pop behaviour

To customize the behaviour of pops when navigating back, a PopBehavior callback can be provided to the RiverpodNavigation instance. The result indicates whether the current pop action should be updated, cancelled or auto (default behavior which simply replace the route with the parent one).

 RiverpodNavigation(
    popBehaviour: (notifier, stack) {
        if (stack.lastRoute?.key == Key('share-article')) {
          return PopResult.update(Uri.parse('/'));
        }
        return PopResult.auto();
      },
    // ...
 )
URI rewriting

The uri can be modified before they are processed by the router with the uriRewriter property. This can be useful for redirecting or normalizing uris.

 RiverpodNavigation(
    uriRewriter: (notifier, uri) {
        if (uri == Uri.parse('/home')) {
            return Uri.parse('/');
        }
        const publicPrefix = 'https://example.com';
        final stringUri = uri.toString();
        if (stringUri.startsWith(publicPrefix)) {
            return Uri.parse(stringUri.substring(publicPrefix.length);
        }
        return uri;
    },
    // ...
);

Categorias

Dependências

Lista de dependências 4 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.