Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.0.4

search_autocomplete

Um widget de busca com autocomplete do Flutter com menus suspensos personalizados e suporte a Cubit/BLoC.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
1,3 mil
Curtidas
3
Pontos Pub
150

Instalar pacote

flutter pub add search_autocomplete

Visão geral do pacote

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

Um widget Flutter para implementar funcionalidade de pesquisa com autocomplete, com menus suspenso personalizáveis e integração perfeita com gerenciamento de estado Cubit ou BLoC. Permite que os usuários digitem texto e recebam sugestões em tempo real, melhorando a experiência do usuário em aplicativos com foco em busca. O pacote é compatível com múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, tornando-o versátil para desenvolvimento multiplataforma. Com design limpo e modular, simplifica a criação de interfaces de busca responsivas e interativas.

Casos de uso

  • Busca em tempo real nos aplicativos
  • Filtrando grandes conjuntos de dados
  • Melhorando a experiência de entrada do usuário
  • Listas suspensas de sugestões personalizáveis
  • Interface de pesquisa multiplataforma

Principais recursos

  • UI de menu suspenso personalizável
  • Integração Cubit/BLoC
  • Filtragem em tempo real
  • Suporte multiplataforma
  • API simples para configuração rápida

Indicado para

  • Recursos de busca em aplicativos de comércio eletrônico
  • Filtragem de dados em painéis
  • Campos de entrada amigáveis ao usuário
  • Desenvolvedores usando BLoC/Cubit
  • Projetos Flutter multiplataforma

Considerações

  • Requer conhecimento em gerenciamento de estado
  • Pode ser necessário personalização de estilo
  • O desempenho depende do tamanho dos dados
  • Temas internos limitados
  • Mais adequado para conjuntos de dados de tamanho moderado

README original

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

Search Autocomplete Flutter Package

Video

Buy Me A Pizza

Overview

This Flutter package provides a SearchAutocomplete widget for implementing autocomplete functionality with a dropdown menu. The package offers extensive customization options for the search field, dropdown items, and includes hooks for search logic.

Installation

To use this package, add search_autocomplete as a dependency in your pubspec.yaml file:

dependencies:
  search_autocomplete: ^1.0.3

Features

  • Customizable search field
  • Customizable dropdown items
  • Hooks for search logic
  • Initial value support
  • Placeholder text support
  • Widget to display when the dropdown is empty
State Management Compatibility
  • Designed to work seamlessly with Cubit/Bloc and other orthodox state managers. Since the list updating logic resides higher up in the widget tree, it allows for a clean separation between UI and logic.

Usage

Here's a simple example demonstrating how to use the SearchAutocomplete widget:

Basic example:
SearchAutocomplete<String>(
  options: state.filteredItems, // Like: ['Apple', 'Banana', 'Orange'],
  initValue: state.currentItem, // Like: 'Apple',
  getString: (item) => item,
  onSearch: (query) {
    // Call your Bloc/Cubit/Provider method to filter options based on the query
    context.read<SearchCubit>().search(query);
  },
  onSelected: (item) {
    // Update your Bloc/Cubit/Provider state when an item is selected
    context.read<SearchCubit>().select(item);
  },
  hintText: 'Search fruits...',
)
Customization example:

You can customize both the search field and dropdown items appearance using provided builders:

SearchAutocomplete<String>(
  options: state.filteredItems,
  initValue: state.currentItem,
  getString: (item) => item,

  onSearch: (query) {
    context.read<SearchCubit>().search(query);
  },

  onSelected: (item) {
    context.read<SearchCubit>().select(item);
  },

  fieldBuilder: (controller, onFieldTap, showDropdown, onPressed) {
    return TextFormField(
      controller: controller,
      onTap: onFieldTap,
      decoration: InputDecoration(
        hintText: 'Custom search...',
        suffixIcon: IconButton(
          icon: Icon(
            showDropdown ? Icons.arrow_drop_up : Icons.arrow_drop_down,
          ),
          onPressed: () => onPressed(showDropdown),
        ),
      ),
    );
  },

  dropDownBuilder: (options, onSelected, controller) {
    return ListView.builder(
      itemCount: options.length,
      itemBuilder: (context, index) {
        final option = options[index];
        return ListTile(
          leading: Icon(Icons.star),
          title: Text(option),
          onTap: () => onSelected(option),
        );
      },
    );
  },

  emptyDropDown: (controller, close) {
    return Center(child: Text('No results found.'));
  },
)

License

This package is licensed under the MIT License. See the LICENSE.md file for details.

Categorias

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.