Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.0.3

flutter_sticky_widgets

Implemente widgets do Flutter que se comportam como position sticky no CSS.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
1,6 mil
Curtidas
91
Pontos Pub
160

Instalar pacote

flutter pub add flutter_sticky_widgets

Visão geral do pacote

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

Um pacote Flutter que permite que widgets se comportem como o CSS 'position: sticky' — eles permanecem visíveis durante o rolagem até atingirem um limite especificado. Ideal para cabeçalhos, barras de navegação ou qualquer elemento da interface que deva permanecer na tela enquanto o conteúdo é rolando. O pacote funciona em todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, fornecendo um comportamento consistente sem exigir código específico da plataforma nativa. Integra-se suavemente em layouts existentes do Flutter com configuração mínima.

Casos de uso

  • Cabeçalhos deslizantes em listas
  • Barras de navegação aderentes
  • Botões de ação persistentes
  • Painéis laterais fixos em visualizações roláveis
  • Elementos de layout dinâmicos que seguem a rolagem do usuário
  • Barras de ferramentas flutuantes em formulários

Principais recursos

  • Posicionamento aderente semelhante ao CSS
  • Compatibilidade multiplataforma
  • Configuração mínima
  • Detecção automática de limite
  • Suporta visualizações de rolagem aninhadas
  • Transição suave durante o scroll

Indicado para

  • Desenvolvedores construindo interfaces roláveis
  • Designers que precisam de elementos de interface fixos
  • Aplicativos com listas ou formulários longos
  • Aplicativos web e móveis que exigem layouts responsivos
  • Equipes que desejam comportamento consistente de fixação entre plataformas

Considerações

  • Pode afetar o desempenho em listas grandes
  • Requer aninhamento cuidadoso de layout
  • Não adequado para cenários complexos de sobreposição
  • Personalização limitada além do comportamento básico de aderência
  • Melhor usado com contextos de rolagem única
  • Pode entrar em conflito com outros controladores de rolagem se não forem geridos corretamente

README original

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

Build Status

With flutter_sticky_widgets you can use a widget as if it is position: sticky; in CSS.

Sticky widgets is an UI pattern where we want widgets to scroll along with the UI upto a certain point, and then stick to the screen instead of scrolling off the screen.

(Green play button in first image, and shuffle play button in second image are examples for position: sticky)

Getting started

import 'package:flutter_sticky_widgets/flutter_sticky_widgets.dart';
StickyContainer(
    stickyChildren: [
        StickyWidget(
            initialPosition: StickyPosition(bottom: 20, right: 20),
            finalPosition: StickyPosition(
                bottom: MediaQuery.of(context).size.height - 80, right: 20),
            controller: _controller,
            child: Container(
            width: 40,
            height: 40,
            decoration: const BoxDecoration(
                shape: BoxShape.circle,
                color: Colors.green,
            ),
            child: const Center(child: Icon(Icons.pause)),
            ),
        ),
    ],
    child: ListView.builder(
    controller: _controller,
    itemCount: 50,
    itemBuilder: (context, index) {
        return ListTile(
            title: Text("Tile $index"),
        );
    }),
);
StickyWidget

Widget used to implement the sticky pattern.

  • initialPosition (StickyPosition): indicates the position of the widget before the scrolling has started. Position is represented by a custom class StickyPosition.

  • finalPosition (StickyPosition): indicates the position of the widget where it will remain sticky after sufficient amount of scrolling. Widget will return to its initial position if scrolled in reverse direction.

  • controller (ScrollController): used by StickyWidget to detect scrolling. Same ScrollController must be attached to your Scrollable (ListView, SingleChildScrollView, CustomScrollView, ...) for StickyWidgets to work. It is also used to determine if the scroll axis is vertical or horizontal.

  • callback (Function(double)?) (optional): An optional callback function, which gets called on every scroll. It receives scrolloffset as parameter which can be used to animate the StickyWidget.

StickyContainer

It must be the parent element of the Scrollable widget used. StickyContainer's size is used as reference size by StickWidgets to position themselves. So make sure StickyContainer's size is same as the size of the Scrollable widget.

  • child (Widget): ideally Scrollable widget should be supplied for this parameter, if not you have to make sure StickyContainer's size is same as Scrollable's size.

  • stickyChildren (List<StickyWidget>): you can supply one or more StickyWidgets.

  • displayOverFlowContent (bool) (optional): true if you want to display the StickyWidgets overflowing outside of the StickyContainer's bounds.

StickyPosition

A Custom class used to represent initial and final positions of StickyWidget. It takes 4 parameters (top, bottom, left, right). But you should supply only 2 of them (top / bottom, right / left)

Note: Make sure to pass same set of parameters for StickyPosition used in initialPosition and finalPosition

Eg:

Correct ✅
initialPosition: StickyPosition(top: .., left: ..)
finalPosition: StickyPosition(top: .., left: ..)

Wrong ❌
(should supply top instead of bottom for finalPosition also)

initialPosition: StickyPosition(top: .., left: ..)
finalPosition: StickyPosition(bottom: .., left: ..)

Categorias

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.