bg_searchable_dropdown 0.0.5
SDKflutter
Platformandroidioswindowslinuxmacosweb
More Descriptive: Instead of just saying it provides customized options, the description now mentions specific features like search functionality, clear option, and flexible styling. This gives potential users a better idea of what the package offers. Concise and Clear: It's still relatively short and to the point, but it provides more useful information. Action-Oriented: The use of offering features like... is a bit more active and engaging.
BGSearchableDropDown
A Flutter widget that provides a searchable dropdown list with customization options.
Features
- Searchable dropdown with filtering functionality
- Customizable border, text style, and dropdown icon
- Clear selection option
- Overlay-based dropdown positioning
Installation
Add this package to your pubspec.yaml:
dependencies:
flutter:
sdk: flutter
bg_searchable_dropdown:
path: path_to_your_local_package # Change this if publishing to pub.dev
Usage
Basic Example
import 'package:flutter/material.dart';
import 'package:bg_searchable_dropdown/bg_searchable_dropdown.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
debugShowCheckedModeBanner: false,
home: Scaffold(
appBar: AppBar(title: Text("Searchable Dropdown Example")),
body: Center(
child: Padding(
padding: const EdgeInsets.all(16.0),
child: BGSearchableDropDown(
items: ['Apple', 'Banana', 'Cherry', 'Date', 'Elderberry'],
hint: 'Select a fruit',
clearOptionText: 'Clear Selection',
onChanged: (value) {
print("Selected: $value");
},
),
),
),
),
);
}
}
Properties
| Property | Type | Default Value | Description |
|---|---|---|---|
items | List<String> | [] | List of items to display in the dropdown |
hint | String | '' | Placeholder text when no item is selected |
clearOptionText | String | 'Clear' | Text for the clear selection button |
onChanged | Function(String?) | required | Callback when an item is selected or cleared |
borderColor | Color | Colors.grey | Border color of the dropdown |
borderRadius | double | 8.0 | Border radius of the dropdown |
dropdownHeight | double | 300.0 | Height of the dropdown overlay |
dropdownIcon | Icon | Icons.arrow_drop_down | Dropdown icon |
showClearButton | bool | true | Whether to show the clear selection button |
textStyle | TextStyle | TextStyle(fontSize: 16) | Style for the dropdown text |
searchLabelText | String? | 'Search...' | Label text for the search field |
License
This package is open-source. Feel free to contribute or modify it as needed.