animated_dropdown_search_codespark

✨ Added

• Documentation comments for the following properties to improve IDE support and code readability:
  • overlayBackgroundColor: Background color for the dropdown overlay.
  • cursorColor: Color of the text cursor.
  • cursorWidth: Width of the text cursor.
  • cursorHeight: Height of the text cursor.
  • highlghtedTextColor: Color used to highlight matched text in the dropdown list.
  • optionTileColor: Background color for each option tile in the list.

• Fixed Alignment

📦 What's New in

This version introduces several new customization options and improvements to the AnimatedDropdownSearch package:

• ✅ Custom Input Border
  Define a custom InputBorder for the search field using the border parameter.

• 🎬 Slide Animation Toggle
  Use the shouldAnimate parameter to enable or disable slide animations on the dropdown options list.

• 🎯 Advanced Search Field Control

  • searchController: Attach your own TextEditingController to the search field.
  • searchFocusNode: Attach a custom FocusNode for advanced focus handling.

• 🧁 Enhanced Search Field Styling

  • filled: Enable or disable the filled style on the search field (defaults to true).
  • fillColor: Customize the fill color (defaults to Colors.white).

• 🧲 Dropdown Alignment
  Set the alignment of the options list using optionsAlignment (defaults to Alignment.center).

These additions offer even more flexibility for fine-tuning the dropdown UI and behavior to suit your app's design system and functionality requirements.

• fixed screenshots description char length issue:

• Setup for CI/CD Pipeline:

Added

• Multiple Selection Mode:
  • Feature: Introduced a boolean multiple constructor to distinguish between single and multiple selection modes.
  • Details: Added a new constructor AnimatedDropdownSearch.multiple specifically for multiple selection.
  • Functionality: Implemented the onSelectedMultiple callback to handle multiple selections, making it required in the multiple selection constructor.

Changed

• Constructor Assertions:
  • Improvement: Updated constructor assertions to ensure onSelected is only allowed in the single selection constructor and onSelectedMultiple is only allowed in the multiple selection constructor.
• Logic Enhancement:
  • Functionality: Refined internal logic to handle sorting and highlighting of options in both single and multiple selection modes.
• Widget Methods:
  • Improvement: Modified optionsListviewWidget and optionsCard methods to support both single and multiple selection scenarios.
• Search Field Behavior:
  • Improvement: Enhanced searchFieldWidget to correctly toggle and clear selections in both single and multiple selection modes.

Fixed

• Dropdown Closure:
  • Bugfix: Corrected an issue where the dropdown would not close properly after a selection in multiple selection mode.
• Text Highlighting:
  • Bugfix: Addressed a bug causing incorrect highlighting of matched text under certain conditions.

Example Usage

// Single selection mode
AnimatedDropdownSearch(
  data: ['Option 1', 'Option 2', 'Option 3'],
  onSelected: (val) {
    print('Selected: $val');
  },
  hint: 'Select an option',
);

// Multiple selection mode
AnimatedDropdownSearch.multiple(
  data: ['Option 1', 'Option 2', 'Option 3'],
  onSelectedMultiple: (values) {
    print('Selected values: $values');
  },
  hint: 'Select options',
);