multiple_search_selection 2.4.0

A highly customizable multiple selection widget with fuzzy search functionality.

2.4.0 ✨🔥 New features & Breaking changes

• Refactored the displayed items to use lazy loading, resulting in a significant improvement in performance for large lists. Additionally, the index is now accessible for further customization.

itemBuilder: (country, index) {
    if (index==0) return Text('Hello World');
    return Padding(
    padding: const EdgeInsets.all(6.0),
    child: Container(
        decoration: BoxDecoration(
        borderRadius: BorderRadius.circular(6),
        color: Colors.white,
         ),
        child: Padding(
         padding: const EdgeInsets.symmetric(
            vertical: 20.0,
            horizontal: 12,
         ),
         child: Text(country.name),
      ),
    ),
  );
},

• Exposes some more InputDecoration parameters :
  • Adds showClearSearchFieldButton which adds a suffix icon to clear searchfield
  • Adds hintText
  • Adds textFieldFocus
  • Adds textEdittingController
• If pickedItemsContainerBuilder is provided it will build even if no items are picked

2.3.7 ✨ New features

• Adds pickedItemsContainerBuilder. You can now provide your own custom Widget for the picked items. pickedItems (List<Widget>) are created from the pickedItemBuilder. So having those items you can customise the layout at your needs.

pickedItemsContainerBuilder: (pickedItems) => Center(
    child: Container(
    height: 150,
    width: 150,
    decoration: BoxDecoration(
        border: Border.all(color: Colors.grey[400]!),
      ),
    child: ListView(
        children: pickedItems,
    ),
  ),
),
pickedItemBuilder: (country) {
    return Padding(
    padding: const EdgeInsets.all(8),
    child: Center(
        child: Text(
        country.name,
        style: const TextStyle(
            color: Colors.blue,
            decoration: TextDecoration.underline,
        ),
      ),
    ),
  );
},

2.3.6 🎨 ♻️ Improves structure & Refactors code

• Removes redundant code & refactors methods.
• Fixes onItemRemoved being called twice. Thanks to anqit

2.3.5 🐛 Bug fixes

• Fixes issue were fuzzy search was not always working

2.3.4 🎨 Updates CHANGELOG

2.3.3 🐛✨ Bug fixes & New features

• Adds missed [onItemCreated] parameter to [createOptions]
• Adds caseSensitiveSearch so you can search with case sensitive. Thanks to anqit

2.3.2 ✨ New features

New constructor added MultipleSearchSelection<T>.creatable which can now create new item when search result does not return any results. It takes a new required parameter, createOptions e.g :

// [T] here is [Country]
createOptions: CreateOptions<Country>(
    // You need to create and return the item you want to add since [T] is not always [String].
    createItem: (text) {
        return Country(name: text, iso: text);
    },
    // Create item Widget that appears instead of no results.
    createItemBuilder: (text) => Align(
        alignment: Alignment.centerLeft,
            child: Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text('Create "$text"'),
            ),
        ),
    // Whether you want to pick the newly created item or just add it to your list. Defaults to false.
    pickCreatedItem: true,
),

2.3.1 ✨ New features

• [clearSearchFieldOnSelect]. Whether to clear the searchfield and reset the showed items when you pick an item. Defaults to [false].

2.3.0 ♻️ 🔥 🐛 Code refactoring, Breaking changes & Bug fixes

🔥 Breaking changes:

• Minimum Dart SDK updated to 2.17.0

🐛 Bug fixes:

• Dropdown was not correctly rebuilding after changing the initial items list.

♻️ Fields made optional:

• Key parameter has been added. It defaults to ValueKey(items.hasCode).
• [maximumShowItemsHeight]. It defaults to 150.
• [onPickedChange]. Your call if you need it.
• [itemsVisibility]. It defaults to always on.
• [fuzzySearch]. It defaults to none.

2.2.1 🐛 Bug fixes

• Fixes itemsVisibility: ShowedItemsVisibility.onType not showing anything.

2.2.0 🔥 Breaking changes

Fields removed:

• [padding] : Refactor -> You can wrap the whole widget in a [Padding] widget.
• [titlePadding] : Refactor -> You can wrap the title with a [Padding] widget.
• [showedItemMouseCursor] : Refactor -> You can build your own showed item [Widget] with [itemBuilder] and use your own style.
• [searchItemTextContentPadding] : Refactor -> You can use [searchFieldInputDecoration] to style your search textfield.

Fields renamed:

• [searchItemTextStyle] -> [searchFieldTextStyle]

2.1.0 🔥 ⚡️ Breaking changes & performance improvements

• Adds [showItemsButton] widget and removes all parameters associated with it previously.
• Adds [selectAllButton] widget and removes all parameters associated with it previously.
• Adds [clearAllButton] widget and removes all parameters associated with it previously.
• Removes opinionated default widgets to plain [Text] reducing code size

2.0.2 🐛 Bug fixes

• Fixes sort picked items bug

2.0.1 🐛 Bug fixes

• Fixes bug with [showItemsText] button text showing [selectAllText] instead
• Removes junk files reducing library size

2.0.0 🔥 Breaking changes

[items] & [initialItems] are now of type [T] for more flexibility when working with different types of [Object] in [List].

New required parameters added :

• [itemBuilder(T)] build and return the showed item widget
• [pickedItemBuilder(T)] build and return the picked item widget
• [fieldToCheck(T)] return the [String] field from the [T] of which you will search & sort against

Removed all parameters connected to showed & picked items since we now have builder methods. Please check the example for the implementation.

1.1.0 ✨ New features

• Adds [itemsVisibility] enum which activates different display options on showed items.

ShowedItemsVisibility.alwaysOn // The items are always displayed
ShowedItemsVisibility.onType // Items are displayed when user types on search field
ShowedItemsVisibility.toggle // Items are displayed when tapped on show items toggle button

1.0.5 ♻️ Refactors code

• Replaces deprecated isAlwaysShown with thumbVisibility for RawScrollBar

1.0.4 ✨ 📝 New features & documentation improvement

• Adds initialy picked items parameter, List<String>. initialPickedItems
• Edits library description
• Edits example code

1.0.3 ✨ New features

• Adds [MouseCursor] for showed & picked items. showedItemMouseCursor & pickedItemMouseCursor
• Adds [BoxDecoration] for showed & picked items container. pickedItemsBoxDecoration & showedItemsBoxDecoration

1.0.2 ✨ New features

• Adds fuzzy search functionality. New enum FuzzySearch added to choose from available fuzzy algorithms (Jaro & Levenshtein). Defaults to [FuzzySearch.none].

1.0.1 ✨ New features

• Adds [ScrollController] for showed & picked items.
• Adds [ScrollPhysics] for showed & picked items.
• Adds a choice whether to sort showed & picked items.
• Adds picked item remove icon parameter.
• Exposes picked item's [BoxDecoration].
• Exposes clear all & select all buttons' animation curves.

1.0.0 🎉 Initial release

• Initial release.