Custom Searchable Dropdown

Easily add a powerful and customizable searchable dropdown widget to your Flutter app!

This plugin lets you seamlessly integrate a dropdown menu with built-in search functionality, enhancing user experience by making it easier to find and select items from a list.


✨ Key Features

  • πŸ” Intuitive Search
    Effortlessly find specific items through real-time search as you type.

  • 🎨 Highly Customizable
    Customize label styles, dropdown items, and even suffix icons to match your app’s design.

  • πŸ”„ Flexible Data Types
    Works with different item types β€” perfect for dynamic or static lists.

  • ⚑ Simple Integration
    Quick setup with minimal boilerplate.


πŸš€ Getting Started

1. Install the Package

Add this line to your pubspec.yaml:

dependencies:
  custom_dropdown_experts: ^0.0.3

2. Import the Package

import 'package:custom_dropdown_experts/custom_dropdown_experts.dart';

πŸ“¦ Usage Example

Here’s a basic example of how to use CustomSearchableDropDown:

Container(
  decoration: BoxDecoration(
    borderRadius: BorderRadius.circular(6.0),
    border: Border.all(color: Colors.black),
  ),
  child: CustomSearchableDropDown(
    items: widget.values ?? [],
    label: title,
    labelStyle: TextStyle(
      fontSize: 16.0,
      fontFamily: 'ProximaRegular',
      color: Colors.black,
    ),
    dropdownItemStyle: TextStyle(
      fontSize: 16.0,
      fontFamily: 'ProximaRegular',
      color: Colors.black,
    ),
    suffixIcon: SvgPicture.asset(
      'assets/user_image/ic_up_down_arrow.svg',
      width: 10,
      height: 10,
    ),
    dropDownMenuItems: widget.values?.map((item) => item).toList() ?? [],
    onChanged: (value) {
      if (value != null) {
        widget.onChange(value);
        title = value;
      }
    },
  ),
);

🧩 Parameters Explained

Parameter Type Description
items List Items to display in the dropdown
dropDownMenuItems List Mapped list of dropdown items
label String Label text shown above the dropdown
labelStyle TextStyle Custom style for the label text
dropdownItemStyle TextStyle Custom style for each dropdown item
suffixIcon Widget Icon to indicate dropdown behavior
onChanged Function Callback triggered when an item is selected

πŸ“˜ Additional Information

We’re actively working to improve the package. Stay tuned for more updates and advanced features!


🀝 Contributing

We welcome contributions!
Feel free to open issues, suggest features, or submit pull requests on GitHub.


πŸ›Ÿ Support

If you run into any issues or have feature requests, open an issue on the GitHub issue tracker.


Made with ❀️ by Your Name or Team Name