Um pacote que fornece um invólucro simples para envolver seus widgets roláveis, permitindo exibir uma mensagem de retorno ao topo ao usuário quando ele rolar.
Orientação gerada a partir de informações públicas. Apenas para referência.
Um pacote leve do Flutter que envolve widgets roláveis para exibir automaticamente um indicador 'rolar para o topo' quando o usuário rola para baixo. Ele melhora a experiência do usuário ao fornecer uma maneira intuitiva de retornar ao topo de listas longas ou visualizações roláveis. O pacote é fácil de integrar e funciona perfeitamente com qualquer conteúdo rolável, como ListView, CustomScrollView ou SingleChildScrollView. Suporta personalização da aparência e comportamento do botão.
Casos de uso
Adicionando um botão de rolagem para o topo em listas longas
Melhorando a UX em painéis com rolagem
Melhorando a acessibilidade em aplicativos com conteúdo intenso
Fornecendo feedback visual durante o rolagem
Simplificando a navegação em visualizações de rolagem aninhadas
Principais recursos
Visibilidade automática com base na posição de rolagem
Botão de ação flutuante personalizável
Configuração mínima com widget wrapper
Funciona com todos os widgets rolagens
Suporta modo escuro e integração de tema
Indicado para
Aplicativos com conteúdo longo e rolável
Designers de interface do usuário priorizando UX
Desenvolvedores procurando implementação rápida de rolagem para o topo
Projetos com dependências mínimas
Aplicativos móveis com telas ricas em conteúdo
Considerações
Pode não funcionar com visualizações de rolagem aninhadas complexas sem configuração adicional
Requer o tratamento manual do controlador de rolagem se não estiver usando o padrão
Opções limitadas de personalização além da estilização básica
Não adequado para widgets não roláveis
Depende do comportamento específico da plataforma para rolagem
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
flutter_scroll_to_top
A wrapper to show a scroll to top prompt to the user on ScrollView widgets.
Installing
Add the following dependency to your pubspec.yaml file:
If the child ScrollView has different properties for scrollController, scrollDirection,
primary or reverse parameters than the default values, you need to pass them to the ScrollWrapper
widget as it requires the same parameters. It provides a ScrollViewProperties object in the builder
callback that you can use to access the properties in the ScrollView widget.
You can pass the following parameters to customise the prompt accordingly
enabledAtOffset - At what scroll offset to enable the prompt on.
alwaysVisibleAtOffset - If the prompt is to be always visible at the provided offset. Setting this to false only shows the prompt when the user starts scrolling upwards. Default value is false.
scrollOffsetUntilVisible - Offset should the user scroll in the opposite direction before the prompt becomes visible.
scrollOffsetUntilHide - Offset should the user scroll before the prompt hides itself, if visible.
promptAlignment - Where on the widget to align the prompt.
promptDuration - Duration it takes for the prompt to come into view/vanish.
promptAnimationCurve - Animation Curve that the prompt will follow when coming into view.
promptAnimationType - PromptAnimation that the prompt follows when animating. Has three options, fade, scale and size.
scrollToTopDuration - Duration it takes for the page to scroll to the top on prompt button press.
scrollToTopCurve - Animation Curve for scrolling to the top.
promptTheme - You can pass PromptButtonTheme to modify the prompt button further. It has the following parameters:
padding - Padding around the prompt button.
iconPadding - Padding around the icon inside the button.