Buscar pacotes, repositórios e categorias de apps

Capa de find_dropdown
Detalhes do pacotev1.0.0

find_dropdown

FindDropdown simples e robusto com recurso de pesquisa de itens, permitindo o uso de uma lista de itens offline ou URL de filtragem para personalização fácil.

Downloads em 30 dias
143
Curtidas
82
Pontos Pub
70

Instalar pacote

flutter pub add find_dropdown

Visão geral do pacote

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

FindDropdown é um pacote leve e confiável do Flutter que fornece um widget de seleção com busca, permitindo que os usuários filtrem itens de uma lista local ou de uma URL remota. Suporta comportamento de pesquisa personalizável e se integra perfeitamente em formulários ou interfaces de seleção. O pacote foi projetado para simplicidade e desempenho, oferecendo experiência do usuário suave com configuração mínima. Ideal para aplicações que exigem seleção eficiente de itens com filtragem em tempo real.

Casos de uso

  • Campos de formulário com opções pesquisáveis
  • Seleção de dados off-line
  • Filtragem dinâmica a partir de URLs
  • Menus suspensores amigáveis ao usuário
  • Lógica de pesquisa personalizável

Principais recursos

  • Funcionalidade de busca em tempo real
  • Suporta fontes de dados online e offline
  • Personalização fácil da interface e do comportamento
  • Leve e eficiente
  • Debounce embutido para eficiência de busca

Indicado para

  • Desenvolvedores criando formulários com listas grandes de opções
  • Aplicativos que precisam de menus suspensores rápidos e responsivos
  • Projetos que exigem design first offline
  • Equipes priorizando integração simples

Considerações

  • Requer manipulação manual da busca de dados assíncronos
  • Opções limitadas de estilo embutido
  • Sem suporte nativo para dados aninhados complexos
  • Pode ser necessário validação adicional para casos de borda
  • Não otimizado para conjuntos de dados extremamente grandes sem paginação

README original

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

Buy Me A Coffee

FindDropdown package - [ver em português]

Simple and robust FindDropdown with item search feature, making it possible to use an offline item list or filtering URL for easy customization.

ATTENTION

If you use rxdart in your project in a version lower than 0.23.x, use version 0.1.7+1 of this package. Otherwise, you can use the most current version!

Versions

Null Safety Version: 1.0.0 or more

Non Null Safety Version: 0.2.3 or less

RxDart 0.23.x or less: 0.1.7+1

packages.yaml

find_dropdown: <lastest version>

Import

import 'package:find_dropdown/find_dropdown.dart';

Simple implementation

FindDropdown(
  items: ["Brasil", "Itália", "Estados Unidos", "Canadá"],
  label: "País",
  onChanged: (String item) => print(item),
  selectedItem: "Brasil",
);

Multiple selectable items

FindDropdown<String>.multiSelect(
  items: ["Brasil", "Itália", "Estados Unidos", "Canadá"],
  label: "País",
  onChanged: (List<String> items) => print(items),
  selectedItems: ["Brasil"],
);

Validation

FindDropdown(
  items: ["Brasil", "Itália", "Estados Unidos", "Canadá"],
  label: "País",
  onChanged: (String item) => print(item),
  selectedItem: "Brasil",
  validate: (String item) {
    if (item == null)
      return "Required field";
    else if (item == "Brasil")
      return "Invalid item";
    else
      return null; //return null to "no error"
  },
);

Endpoint implementation (using Dio package)

FindDropdown<UserModel>(
  label: "Nome",
  onFind: (String filter) async {
    var response = await Dio().get(
        "http://5d85ccfb1e61af001471bf60.mockapi.io/user",
        queryParameters: {"filter": filter},
    );
    var models = UserModel.fromJsonList(response.data);
    return models;
  },
  onChanged: (UserModel data) {
    print(data);
  },
);

Clear selected items

var countriesKey = GlobalKey<FindDropdownState>();

Column(
  children: [
    FindDropdown<String>(
      key: countriesKey,
      items: ["Brasil", "Itália", "Estados Unidos", "Canadá"],
      label: "País",
      selectedItem: "Brasil",
      showSearchBox: false,
      onChanged: (selectedItem) => print("country: $selectedItem"),
    ),
    RaisedButton(
      child: Text('Limpar Países'),
      color: Theme.of(context).primaryColor,
      textColor: Theme.of(context).primaryIconTheme.color,
      onPressed: () => countriesKey.currentState?.clear(),
    ),
  ],
)

Change selected items

var countriesKey = GlobalKey<FindDropdownState>();

Column(
  children: [
    FindDropdown<UserModel>(
      label: "Nome",
      onFind: (String filter) => getData(filter),
      searchBoxDecoration: InputDecoration(
        hintText: "Search",
        border: OutlineInputBorder(),
      ),
      onChanged: (UserModel data) {
        print(data);
        countriesKey.currentState.setSelectedItem("Brasil");
      },
    ),
    FindDropdown<String>(
      key: countriesKey,
      items: ["Brasil", "Itália", "Estados Unidos", "Canadá"],
      label: "País",
      selectedItem: "Brasil",
      showSearchBox: false,
      onChanged: (selectedItem) => print("country: $selectedItem"),
    ),
  ],
)
MORE EXAMPLES

Layout customization

You can customize the layout of the FindDropdown and its items. EXAMPLE

To customize the FindDropdown, we have the dropdownBuilder property, which takes a function with the parameters:

  • BuildContext context: current context;
  • T item: Current item, where T is the type passed in the FindDropdown constructor.

To customize the items, we have the dropdownItemBuilder property, which takes a function with the parameters:

  • BuildContext context: current context;
  • T item: Current item, where T is the type passed in the FindDropdown constructor.
  • bool isSelected: Boolean that tells you if the current item is selected.

Attention

To use a template as an item type, you need to implement toString, equals and hashcode, as shown below:

class UserModel {
  final String id;
  final DateTime createdAt;
  final String name;
  final String avatar;

  UserModel({this.id, this.createdAt, this.name, this.avatar});

  @override
  String toString() => name;

  @override
  operator ==(o) => o is UserModel && o.id == id;

  @override
  int get hashCode => id.hashCode^name.hashCode^createdAt.hashCode;

}

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.