Pakete, Repositories und App-Kategorien suchen

Paketdetailsv0.12.3

textfield_search

Ein neues Flutter-Paket, das ein TextField verwendet, um einen Wert aus einer einfachen Liste zu suchen und auszuwählen.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
3390
Likes
140
Pub-Punkte
150

Paket installieren

flutter pub add textfield_search

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Paket, das Benutzern ermöglicht, Werte aus einer einfachen Liste mithilfe eines TextFields zu suchen und auszuwählen. Es bietet eine intuitive Autovervollständigungserfahrung, bei der die Optionen in Echtzeit gefiltert werden, während der Benutzer tippt. Das Paket ist leichtgewichtig und einfach zu integrieren und eignet sich daher ideal für Formulare oder Eingabefelder, die eine schnelle Auswahl aus vordefinierten Daten erfordern. Es unterstützt mehrere Plattformen, darunter Android, iOS, Web, macOS, Windows und Linux.

Anwendungsfälle

  • Formularingaben mit durchsuchbaren Optionen
  • Schnellauswahl aus großen Listen
  • Benutzerfreundliche Dropdown-Alternativen
  • Dynamische Filterung in mobilen und Web-Anwendungen
  • Einfache Dateneingabeprozesse

Hauptmerkmale

  • Echtzeit-Suchfilterung
  • Einfache Integration mit TextField
  • Unterstützt mehrere Plattformen
  • Leichtgewichtig und minimale Abhängigkeiten
  • Anpassbare Benutzeroberfläche und Styling

Geeignet für

  • Entwickler, die Formulare mit durchsuchbaren Eingaben erstellen
  • Apps, die eine schnelle Datenauswahl benötigen
  • Plattformübergreifende Anwendungen
  • Projekte, die Einfachheit und Leistung priorisieren

Hinweise

  • Beschränkt auf grundlegende Listen-Suchvorgänge
  • Keine Unterstützung für Remote-Datenquellen
  • Benötigt manuelle Behandlung ausgewählter Werte
  • Nicht geeignet für komplexe Autocomplete-Szenarien

Original-README

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

flutter_textfield_search

Build and Test

FTFS is a Flutter package which uses a TextField Widget to search and select a value from a list. It's a simple, lightweight, and fully tested package unlike other "autocomplete" or textfield search packages. View complete code coverage results in JSON format here.

Usage

To use this package, add flutter_textfield_search as a dependency in your pubsec.yaml file.

Example

Import the package.

`import 'package:flutter_textfield_search/textfield_search.dart'`;

Then include the widget anywhere you would normally use a TextField widget with a String for label, a List for initialList, and a TextEditingController for controller.
Example MaterialApp using TextFieldSearch Widget

    const label = "Some Label";
    const dummyList = ['Item 1', 'Item 2', 'Item 3', 'Item 4', 'Item 5'];
    TextEditingController myController = TextEditingController();
    MaterialApp(
      home: Scaffold(
      body: TextFieldSearch(initialList: dummyList, label: label, controller: myController)
      ),
    )

To get the value of the selected option, use addListener on the controller to listen for changes:

    @override
    void dispose() {
      // Clean up the controller when the widget is removed from the
      // widget tree.
      myController.dispose();
      super.dispose();
    }

    @override
    void initState() {
      super.initState();
      // Start listening to changes.
      myController.addListener(_printLatestValue);
    }
    
    _printLatestValue() {
      print("Textfield value: ${myController.text}");
    }

Selecting a List item from a Future List:

    TextEditingController myController = TextEditingController();

    // create a Future that returns List
    Future<List> fetchData() async {
      await Future.delayed(Duration(milliseconds: 5000));
      List list = [];
      String _inputText = myController.text;
      // create a list from the text input of three items
      // to mock a list of items from an http call
      list.add(_inputText + ' Item 1');
      list.add(_inputText + ' Item 2');
      list.add(_inputText + ' Item 3');
      return list;
    }

    @override
    void dispose() {
      // Clean up the controller when the widget is removed from the
      // widget tree.
      myController.dispose();
      super.dispose();
    }

    // used within a MaterialApp (code shortened)
    MaterialApp(
      home: Scaffold(
      body: TextFieldSearch(
          label: 'My Label', 
          controller: myController
          future: () {
            return fetchData();
          }
        )
      ),
    )

Selecting an object from a Future List:

    TextEditingController myController = TextEditingController();

    // create a Future that returns List
    // IMPORTANT: The list that gets returned from fetchData must have objects that have a label property.
    // The label property is what is used to populate the TextField while getSelectedValue returns the actual object selected
    Future<List> fetchData() async {
      await Future.delayed(Duration(milliseconds: 3000));
      List list = [];
      String _inputText = myController.text;
      List jsonList = [
        {
          'label': _inputText + ' Item 1',
          'value': 30
        },
        {
          'label': _inputText + ' Item 2',
          'value': 31
        },
        {
          'label': _inputText + ' Item 3',
          'value': 32
        },
      ];
      // create a list of 3 objects from a fake json response
      list.add(TestItem.fromJson(jsonList[0]));
      list.add(TestItem.fromJson(jsonList[1]));
      list.add(TestItem.fromJson(jsonList[2]));
      return list;
    }

    @override
    void dispose() {
      // Clean up the controller when the widget is removed from the
      // widget tree.
      myController.dispose();
      super.dispose();
    }

    // used within a MaterialApp (code shortened)
    MaterialApp(
      home: Scaffold(
      body: TextFieldSearch(
          label: 'My Label', 
          controller: myController
          future: () {
            return fetchData();
          },
          getSelectedValue: (value) {
            print(value); // this prints the selected option which could be an object
          }
        )
      ),
    )

    // Mock Test Item Class
    class TestItem {
      final String label;
      dynamic value;
      TestItem({ required this.label, this.value });

      factory TestItem.fromJson(Map<String, dynamic> json) {
        return TestItem(
          label: json['label'],
          value: json['value']
        );
      }
    }

Issues

Please email any issues, bugs, or additional features you would like to see built to arindone@nubeer.io.

Contributing

If you wish to contribute to this package you may fork the repository and make a pull request to this repository.

Note: Testing by running flutter test --coverage will generate coverage/lcov.info. Running bash test-coverage.sh will parse the lcov.info file into JSON format. This happens automatically within the CI/CD pipeline on a pull request to main but it is always good to test locally.

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.