Add this in your root build.gradle file (not your module build.gradle file):
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}Add this to your module's build.gradle file
dependencies {
...
implementation 'com.github.amoetaz:Retrofill:1.0.0'
}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();
}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"
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
Don't forget to star ⭐ the repo
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.