Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Detalhes do pacotev0.1.8

snaplist

Uma pequena biblioteca que permite criar listas com encaixe em itens.

pub.dev Documentação da API Código-fonte
Downloads em 30 dias
46
Curtidas
33
Pontos Pub
40

Instalar pacote

flutter pub add snaplist

Visão geral do pacote

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

SnapList é um pacote leve do Flutter que permite o comportamento de encaixe suave em listas, permitindo que os usuários rolem pelos itens e sejam automaticamente alinhados ao limite do item mais próximo. Ele aprimora a experiência do usuário em galerias de imagens ou interfaces semelhantes a carrosséis, fornecendo alinhamento preciso e feedback visual durante o deslizamento. Desenvolvido com simplicidade em mente, integra-se perfeitamente às estruturas de lista existentes sem exigir configurações complexas. Ideal para criar interações intuitivas e amigáveis ao toque em listas.

Casos de uso

  • carrosséis de imagens
  • Grade de produtos rolável
  • Controles deslizantes interativos
  • Telas de onboarding
  • Listas de encaixe vertical/horizontal

Principais recursos

  • Animação suave de encaixe
  • Intervalos de snap personalizáveis
  • Configuração mínima
  • Suporta rolagem vertical e horizontal
  • Opções de alinhamento embutidas

Indicado para

  • Desenvolvedores construindo interfaces de lista interativas
  • Designers focados na navegação baseada em gestos
  • Aplicativos com conteúdo pesado em imagens
  • Aplicações com foco em dispositivos móveis com entrada por toque

Considerações

  • Limitado à lógica básica de encaixe
  • Sem indicadores de paginação embutidos
  • Requer manipulação manual de eventos de rolagem
  • Não otimizado para conjuntos de dados muito grandes
  • Sem suporte para curvas de easings personalizadas

README original

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

awesome flutter pub package

snaplist

A small cozy library that allows you to make snappable list views.

Issues and Pull Requests are really appreciated!

Snaplist supports different and even dynamically sized children to be listed and correctly snapped.

Showcase

Showscase gif

Include to your project

In your pubspec.yaml root add:

dependencies:
  snaplist: ^0.1.8

Include

The library does provide StatefulWidget which is called SnapList.

Include the widget like this: import 'package:snaplist/snaplist.dart';

Usage

Use it as you'd use any widget:

Widget build(BuildContext context) {
  return SnapList(
    sizeProvider: (index, data) => Size(100.0, 100.0),
    separatorProvider: (index, data) => Size(10.0, 10.0),
    builder: (context, index, data) => SizedBox(),
    count: 1,
  );
}

Snaplist uses gesture detection for swiping the list, so, please, be sure that the gestures you apply to the widgets inside are not overlapping for best user experience.

Properties

There are 4 required fields:

  • sizeProvider is a provider of each widget size. The library will wrap each built widget to a sized box of specified size. This is required so snapping calculations will work correctly.
  • separatorProvider is similar to sizeProvider, but this size will be used to build the list separators.
  • builder works like a regular Flutter builder all of us are familiar with. It will pass you the context, current item index and some additional data.
  • count - Children count as in a ListView.

The data which is provided to each provider and the builder is a combination of three fields:

  • center - is the position which is now displayed and referenced as the center widget.
  • next - is the position which the user is scrolling to. It is -1 if idle.
  • progress - is the scroll and snip progress. The values are from 0 to 100.

Snaplist defaults to horizontal scrolling. You can set axis to Axis.vertical for vertical scrolling.

Categorias

ImagemLista

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.