side_header_list_view

Visão geral do pacote

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

Um pacote Flutter que implementa uma ListView com cabeçalhos laterais fixos, semelhante aos aplicativos de contatos e calendário do Android. Permite aos usuários rolar por uma lista mantendo os cabeçalhos das seções visíveis ao lado, melhorando a navegação e a organização visual. Os cabeçalhos permanecem fixos enquanto o usuário rola, aumentando a usabilidade em listas longas agrupadas por categorias ou períodos de tempo. Projetado para interfaces limpas e intuitivas em aplicativos que exigem exibição de dados categorizados.

Casos de uso

Lista de contatos com agrupamento alfabético
Visualização de calendário com cabeçalhos de data
Listagens de produtos categorizados
Seções do perfil do usuário com rótulos
Conteúdo longo com cabeçalhos de tópico

Principais recursos

Cabeçalhos laterais aderentes
Agrupamento de cabeçalhos alfabético ou personalizado
Rolagem suave com alinhamento de cabeçalho
Estilo de cabeçalho personalizável
Renderização eficiente para grandes conjuntos de dados

Indicado para

Aplicativos com dados categorizados
Aplicativos de contatos ou diretório
Exibição de dados baseada em tempo
UIs que precisam de separação clara de seções
Desenvolvedores procurando design de lista estilo Android

Considerações

Limitado a listas verticais
A posição do cabeçalho pode exigir ajustes de layout
Mais adequado para larguras de tela estreitas a médias
Pode ser necessário estilização adicional para o modo escuro
Não ideal para cenários de rolagem horizontal

README original

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

Listview with sticky headers like the Android contact page

alt text

Usage

  new SideHeaderListView(
    // Set how many items the list has
    itemCount: items.length,
    
    // Set the height of the item widgets. For now this has to be a fixed height
    itemExtend: 150.0,
    
    // Set the header builder, this needs to return the widget for the side header
    headerBuilder: (BuildContext context, int index){
      return new HeaderWidget(items[index].startDate);
    },
    
    // Set the item builder, this is everything in the row without the header
    itemBuilder: (BuildContext context, int index){
      return new ListItem(items[index]);
    },
    
    // HasSameHeader will be used to know whether the header has to be shown for a position 
    hasSameHeader: (int a, int b){
      return items[a].day == items[b].day;
    },
  );

Buscar pacotes, repositórios e categorias de apps