Retrofill

Kotlin version

Prerequisites

Add this in your root build.gradle file (not your module build.gradle file):

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

Dependency

Add this to your module's build.gradle file

dependencies {
	...
	implementation 'com.github.amoetaz:Retrofill:1.0.0'
}

Usage

First if you want to show a normal list -Not a nested- you can do this

new Retrofill(this).setupNormalList(recyclerView, R.layout.list_item, new Action() {
            @Override
            public void execute() {
                Toast.makeText(MainActivity.this, "Great", Toast.LENGTH_SHORT).show();
            }
        }).showNormalRecylerView();

That is it,and as shown here there are 3 parameters passed to setupNormalList method the recyclerView as a view , layout item and the last one is a listener if you want to add clicks on items list if you don't want so just pass it with null like that

new Retrofill(this).setupNormalList(recyclerView, R.layout.list_item, null)

you can customise your list to specifiy list size and span count and more as shown here with default values if you didn't specifiy them

/*values passed to setter method are also a default values*/
        new Retrofill(this).setupNormalList(recyclerView, R.layout.list_item, new Action() {
            @Override
            public void execute() {
                Toast.makeText(MainActivity.this, "Great", Toast.LENGTH_SHORT).show();
            }
        })
            .setLayoutType(LayoutType.LINEAR)
            .setVertical(true)
            .setListSize(5)
            .setSpanCount(2)
            .showNormalRecylerView();

and if you want to show a nested list

new Retrofill(this)
                .setupNestedList(recyclerView, R.layout.outer_list_item, R.id.rv_inner_list, R.layout.inner_list_item, new Action() {
                    @Override
                    public void execute() {
                        Toast.makeText(NestedListActivity.this, "Fantastic", Toast.LENGTH_SHORT).show();
                    }
                })
                .showNestedRecylerView();

The parameters as in normal list plus the id of inner recylerview -pass it as id not as a view- and the inner list item

And if you want to specifiy some atterbutes like in normal list here is the full code

new Retrofill(this)
                .setupNestedList(OuterRecyclerView, R.layout.outer_list_item, R.id.rv_inner_list, R.layout.inner_list_item, new Action() {
                    @Override
                    public void execute() {
                        Toast.makeText(NestedListActivity.this, "Fantastic", Toast.LENGTH_SHORT).show();
                    }
                })
                .setOuterIsVertical(true)
                .setOuterLayoutType(LayoutType.LINEAR)
                .setOuterListSize(6)
                .setOuterSpanCount(2)
                .setInnerLayoutType(LayoutType.LINEAR)
                .setInnerListSize(5)
                .setInnerSpanCount(2)
                .setInnerVertical(true)
                .showNestedRecylerView();
    }

Limitations

Of course there are some limitaions if you will use this lib but in next version I will try work around them until now these some limitions

You can`t add click to specific view on list item but you can add click to whole item
Custom layout manager is not supported you can only choose form build-in layout manager in android
The list items will be identcal as in the xml for example if there is a textview with id tv_text and you set it text in xml with "Hello" so all textviews in other items with id tv_text in run will display with "Hello"

Notes

1-You can pass layout type to setter LayoutType methods from one of these

LayoutType.LINEAR
LayoutType.GRID
LayoutType.STAGGERED_GRID

2- You must initiate your views in list item in xml and DON'T use tools namespace instead use android

3- You should check your xml list item to make sure it is properly suitable with your layout type for example if your layout type is linear sometimes it is better to set the hegiht of parent of list item with wrap content

Contact - Let's become friends

Don't forget to star ⭐ the repo

License

Apache Version 2.0

Copyright 2020 Moetaz Ashraf

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

amoetaz/Retrofill