SearchableListDialog

Bottom Dialog Searchable List built with Material.io with custom search bar and custom list item view.

Sample

Features

• Works with literally any type of data
• One-on-one comparison
• Auto empty view
• Portable
• Clean UI
• Pre-optimized
• Easy to use
• Lightweight

---

Implementation

Step 1: Add to project level build.gradle

allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}

Step 2: Add to app level build.gradle

dependencies {
implementation 'com.github.utsavdotpro:SearchableListDialog:VERSION'
}

---

How to use?

In this example, I am creating a dialog search list for a list of customers with their name and business name. You can easily understand how it works from the example and implement according to your requirements.

• You can use any kind of object to populate and search for in the list
• Here, I have created a simple object Customer with basic setters and getters

You can also check out the example app

Creating List Adapter

SearchableListAdapter is built from BaseAdapter with only addition of setItems() and getItems() methods

publicclassCustomersSearchableListAdapterextendsSearchableListAdapter<Customer> {
privatefinalContextcontext;
privateList<Customer> customerList = newArrayList<>();
publicCustomersSearchableListAdapter(Contextcontext) {
this.context = context;
}
@OverridepublicintgetCount() {
returncustomerList.size();
}
@OverridepublicCustomergetItem(intposition) {
returncustomerList.get(position);
}
@OverridepubliclonggetItemId(intposition) {
returncustomerList.get(position).getId();
}
@OverridepublicViewgetView(intposition, ViewconvertView, ViewGroupparent) {
ViewHolderholder = createNewOrGetExistingViewHolder(convertView);
holder.populateView(getItem(position));
convertView = holder.getBinding().getRoot();
convertView.setTag(holder);
returnconvertView;
}
privateViewHoldercreateNewOrGetExistingViewHolder(Viewview) {
if (view != null)
return (ViewHolder) view.getTag();
ListCustomerItemBindingbinding = ListCustomerItemBinding.inflate(LayoutInflater.from(context));
returnnewViewHolder(binding);
}
@OverridepublicList<Customer> getItems() {
returncustomerList;
}
@OverridepublicvoidsetItems(List<Customer> customerList) {
this.customerList = customerList;
notifyDataSetChanged();
}
publicclassViewHolder {
privatefinalListCustomerItemBindingbinding;
publicViewHolder(ListCustomerItemBindingbinding) {
this.binding = binding;
}
publicListCustomerItemBindinggetBinding() {
returnbinding;
}
publicvoidpopulateView(Customercustomer) {
binding.tvName.setText(customer.getName());
binding.tvBusinessName.setText(customer.getBusinessName());
}
}
}

Creating Dialog

privateCustomersSearchableListAdaptercustomersListAdapter;
privateSearchableListDialog<Customer> dialogListCustomers;
customersListAdapter = newCustomersSearchableListAdapter(activity);
dialogListCustomers = newSearchableListDialog<>(activity, customersListAdapter);

Setting Items

Careful! Make sure you set the items to you dialogListCustomers and not customersListAdapter

dialogListCustomers.setItems(customerList);

Defining Search Matcher

Since SLD doesn't work with any specific object type, you have to define your own matcher(). This gives SLD its portability and you freedom to compare any way you like.

dialogListCustomers.setSearchMatcher((customer, keyword) -> {
returncustomer.getName().toLowerCase().contains(keyword);
// return true if matched, else false
});

Listening to Item Selection

dialogListCustomers.setOnItemSelectedListener(customer -> {
// to whatever you like with the selected item (customer in this case)
});

---

P.s. If you need me to write a better documentation, ping me at contact@utsav.pro