Pakete, Repositories und App-Kategorien suchen

Cover von find_dropdown
Paketdetailsv1.0.0

find_dropdown

Einfaches und zuverlässiges FindDropdown mit Suchfunktion für Elemente, sodass eine Offline-Elementliste oder Filter-URL zur einfachen Anpassung verwendet werden kann.

30-Tage-Downloads
143
Likes
82
Pub-Punkte
70

Paket installieren

flutter pub add find_dropdown

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

FindDropdown ist ein leichtgewichtiges und zuverlässiges Flutter-Paket, das ein durchsuchbares Dropdown-Widget bereitstellt, mit dem Benutzer Elemente aus einer lokalen Liste oder einer entfernten URL filtern können. Es unterstützt anpassbare Suchverhalten und lässt sich nahtlos in Formulare oder Auswahlinterfaces integrieren. Das Paket wurde für Einfachheit und Leistung entwickelt und bietet eine reibungslose Benutzererfahrung mit minimalem Setup. Ideal für Anwendungen, die eine effiziente Elementauswahl mit Echtzeitfilterung erfordern.

Anwendungsfälle

  • Formularingaben mit durchsuchbaren Optionen
  • Offline-Datenauswahl
  • Dynamische Filterung über URLs
  • Benutzerfreundliche Dropdown-Menüs
  • Anpassbare Suchlogik

Hauptmerkmale

  • Echtzeit-Suchfunktion
  • Unterstützt Offline- und Online-Datenquellen
  • Einfache Anpassung von UI und Verhalten
  • Leichtgewichtig und leistungsstark
  • Eingebaute Debounce-Funktion zur Sucheffizienz

Geeignet für

  • Entwickler, die Formulare mit großen Optionslisten erstellen
  • Apps, die schnelle, reaktionsfähige Dropdowns benötigen
  • Projekte, die einen Offline-first-Entwurf erfordern
  • Teams, die einfache Integration priorisieren

Hinweise

  • Benötigt manuelle Handhabung der asynchronen Datenabruf
  • Begrenzte integrierte Stiloptionen
  • Keine native Unterstützung für komplexe verschachtelte Daten
  • Kann zusätzliche Überprüfung für Randfälle benötigen
  • Nicht für extrem große Datensätze ohne Pagination optimiert

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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;

}

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.