HFRecyclerView

This is an Android library allowing to add Header and/or Footer in your RecyclerView in the simplest way possible.

USAGE

To add Header and/or Footer in your RecyclerView you need to add HFRecyclerView library in your project or you can also grab it from Gradle:

compile 'com.mikhaellopez:hfrecyclerview:1.0.0'

JAVA

1. You need to create a custom RecyclerView.Adapter for your RecyclerView which extends HFRecyclerView with the object type of your choice (in my example, my object type is MyDataObject :

   public class ExampleAdapter extends HFRecyclerView<MyDataObject> {
       //...
   }

2. In your custom adapter, add a constructor. The first param in super constructor is your data list. The second is a flag to determine if you want to add a header, and the last to add a footer.

   public class ExampleAdapter extends HFRecyclerView<MyDataObject> {
   
       public ExampleAdapter(List<MyDataObject> data) {
           // With Header & With Footer
           super(data, true, true);
       }
   
       //...
   }

3. After that, override 3 methods and create 3 class which extend RecyclerView.ViewHolder in order to add the viewHolder for your Item, your Header and your Footer:

   public class ExampleAdapter extends HFRecyclerView<MyDataObject> {
       
       //...
       
       //region Override Get ViewHolder
       @Override
       protected RecyclerView.ViewHolder getItemView(LayoutInflater inflater, ViewGroup parent) {
           return new ItemViewHolder(inflater.inflate(R.layout.item_example, parent, false));
       }
   
       @Override
       protected RecyclerView.ViewHolder getHeaderView(LayoutInflater inflater, ViewGroup parent) {
           return new HeaderViewHolder(inflater.inflate(R.layout.item_header, parent, false));
       }
   
       @Override
       protected RecyclerView.ViewHolder getFooterView(LayoutInflater inflater, ViewGroup parent) {
           return new FooterViewHolder(inflater.inflate(R.layout.item_footer, parent, false));
       }
       //endregion
   
       //region ViewHolder Header and Footer
       class ItemViewHolder extends RecyclerView.ViewHolder {
           TextView text;
   
           public ItemViewHolder(View itemView) {
               super(itemView);
               text = (TextView)itemView.findViewById(R.id.text);
           }
       }
   
       class HeaderViewHolder extends RecyclerView.ViewHolder {
           public HeaderViewHolder(View itemView) {
               super(itemView);
           }
       }
   
       class FooterViewHolder extends RecyclerView.ViewHolder {
           public FooterViewHolder(View itemView) {
               super(itemView);
           }
       }
       //endregion
   }

4. Finally, you must override onBindViewHolder method to manage your views as you like:

   public class ExampleAdapter extends HFRecyclerView<MyDataObject> {
   
       //...
   
       @Override
       public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
           if (holder instanceof ItemViewHolder) {
               ItemViewHolder itemViewHolder = (ItemViewHolder) holder;
               MyDataObject data = getItem(position);
               itemViewHolder.text.setText(data);
           } else if (holder instanceof HeaderViewHolder) {
   
           } else if (holder instanceof FooterViewHolder) {
   
           }
       }
       
       //...
   }

ℹ️ You can see a full example here : ExampleAdapter and MainActivity

LICENCE

CircularImageView by Lopez Mikhael is licensed under a Apache License 2.0. Based on a work at @hister.