flutter_search_bar

Visão geral do pacote

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

Um pacote Flutter que fornece uma barra de pesquisa integrada a um AppBar com configuração mínima. Ele gerencia automaticamente a entrada de pesquisa, filtragem e atualizações da interface, sendo ideal para adicionar funcionalidades de busca em aplicativos com pouca quantidade de código repetitivo. A barra de pesquisa suporta filtragem em tempo real e pode ser personalizada para atender diversas necessidades de design. Foi projetada para funcionar perfeitamente dentro do AppBar, oferecendo uma experiência de usuário limpa e intuitiva. O pacote é mantido no GitHub e é adequado para desenvolvedores que buscam uma solução simples para implementar recursos de busca em seus aplicativos Flutter.

Casos de uso

Implementando busca em visualizações de lista
Filtrando dados em tempo real
Melhorando a navegação do aplicativo com busca
Integrando a pesquisa na barra de aplicativos
Construindo filtros de conteúdo dinâmicos

Principais recursos

Estado de pesquisa gerenciado automaticamente
Filtragem em tempo real
Integração do AppBar
Configuração mínima
Interface do usuário personalizável
Suporta filtragem assíncrona

Indicado para

Desenvolvedores construindo aplicativos com foco em busca
Aplicativos que exigem implementação de busca rápida
Projetos com foco em UI que precisam de barras de pesquisa limpas
Iniciantes do Flutter explorando recursos de busca
Projetos com fontes de dados dinâmicas

Considerações

Personalização específica de plataforma limitada
Sem sugestões ou autocomplete embutidos
Requer manipulação manual de resultados assíncronos
Não otimizado para conjuntos de dados muito grandes
Depende de gerenciamento externo de estado para lógica complexa

README original

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

Archive Notice

This repository is archived. 3.0.0 is the last version that I will publish.

The SearchBar still works and it's pretty simple if you'd like to fork it. I just don't have the time to maintain it.

A simple and mostly automatic material search bar for flutter (dart).

Note: use flutter_search_bar and not search_bar -- I own both packages but I'm just a tad bit locked out of search_bar, so it won't be updated.

Screenshots

Normal state (search is not active yet, only title and actions are set, with the only action being a search button)

inBar set to false (background white, back button inherited):

inBar set to true (background inherited):

Usage

A simple usage example:

class _MyHomePageState extends State<MyHomePage> {
  SearchBar searchBar;
  
  AppBar buildAppBar(BuildContext context) {
    return new AppBar(
      title: new Text('My Home Page'),
      actions: [searchBar.getSearchAction(context)]
    );
  }  
  
  _MyHomePageState() {
    searchBar = new SearchBar(
      inBar: false,
      setState: setState,
      onSubmitted: print,
      buildDefaultAppBar: buildAppBar
    );
  }
  
  @override
  Widget build(BuildContext context) {
    return new Scaffold(
      appBar: searchBar.build(context)
    );
  }
}

This will create an AppBar with a search button as its only action, and on press the AppBar will turn white and have a TextField inside, allowing user input. Once the user has input something and pressed the "enter" button on their keyboard, it will close and the value will be printed to the debugger.

Using SearchBar

Essentially, this class returns two different app bars based on whether search is active.

The setState callback you pass the search bar can technically be any VoidCallback.

Features and bugs

Please file feature requests and bugs at the issue tracker.

We've recently added support for null-safety in 3.0.0 -- if you find any issues, please report them there!

Buscar pacotes, repositórios e categorias de apps