RecyclerTabLayout
An efficient TabLayout library implemented with RecyclerView.
Features
- Efficient when having many tabs
- Easy setup with ViewPager (same as TabLayout of Android Design Support Library)
- RTL layout support
UseCase
- Many tabs layout
- Infinite loop scrolling (imitated)
Demos
Samples
Getting started
In your build.gradle:
repositories {
jcenter()
}
dependencies {
compile 'com.nshmura:recyclertablayout:1.5.0'
}
Define RecyclerTabLayout in xml layout with custom attributes.
<com.nshmura.recyclertablayout.RecyclerTabLayout
android:id="@+id/recycler_tab_layout"
android:layout_width="match_parent"
android:layout_height="48dp"
rtl_tabIndicatorColor="?attr/colorAccent"
rtl_tabIndicatorHeight="2dp"
rtl_tabBackground="?attr/selectableItemBackground"
rtl_tabTextAppearance="@android:style/TextAppearance.Small"
rtl_tabSelectedTextColor="?android:textColorPrimary"
rtl_tabMinWidth="72dp"
rtl_tabMaxWidth="264dp"
rtl_tabPaddingStart="12dp"
rtl_tabPaddingTop="0dp"
rtl_tabPaddingEnd="12dp"
rtl_tabPaddingBottom="0dp"
rtl_tabPadding="0dp"/>
Set up with the ViewPager.
ViewPager viewPager = (ViewPager) findViewById(R.id.view_pager);
viewPager.setAdapter(adapter);
RecyclerTabLayout recyclerTabLayout = (RecyclerTabLayout) findViewById(R.id.recycler_tab_layout);
recyclerTabLayout.setUpWithViewPager(viewPager);
Or set up with ViewPager and Custom RecyclerView.Adapter that's extends RecyclerTabLayout.Adapter.
ViewPager viewPager = (ViewPager) findViewById(R.id.view_pager);
viewPager.setAdapter(adapter);
RecyclerTabLayout recyclerTabLayout = (RecyclerTabLayout) findViewById(R.id.recycler_tab_layout);
recyclerTabLayout.setUpWithAdapter(new CustomRecyclerViewAdapter(viewPager));
Here's sample of custom RecyclerView adapter.
public class CustomRecyclerViewAdapter extends RecyclerTabLayout.Adapter<CustomRecyclerViewAdapter.ViewHolder> {
public DemoCustomView01Adapter(ViewPager viewPager) {
super(viewPager);
...
}
@Override
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
// Inflate your view.
View view = ...;
return new ViewHolder(view);
}
@Override
public void onBindViewHolder(ViewHolder holder, int position) {
// Bind data
...
if (position == getCurrentIndicatorPosition()) {
//Highlight view
}
}
public class ViewHolder extends RecyclerView.ViewHolder {
...
public ViewHolder(View itemView) {
super(itemView);
...
}
}
}
Attributes
| attr | description |
|---|---|
| rtl_tabIndicatorColor | Indicator color |
| rtl_tabIndicatorHeight | Indicator height |
| rtl_tabBackground | Background drawable of each tab |
| rtl_tabTextAppearance | TextAppearence of each tab |
| rtl_tabSelectedTextColor | Text color of selected tab |
| rtl_tabOnScreenLimit | The number of OnScreen tabs. If this value is larger than 0, rtl_tabMinWidth and rtl_tabMaxWidth are ignored. |
| rtl_tabMinWidth | Minimum width of each tab |
| rtl_tabMaxWidth | Maximum width of each tab |
| rtl_tabPaddingStart | The padding of the start edge of each tab |
| rtl_tabPaddingTop | The padding of the top edge of each tab |
| rtl_tabPaddingEnd | The padding of the end edge of each tab |
| rtl_tabPaddingBottom | The padding of the bottom edge of each tab |
| rtl_tabPadding | The padding of all four edges of each tab |
| rtl_scrollEnabled | Sets whether tab scrolling is enabled |
Thanks
The demo app uses the following resources.
color-names by codebrainz
https://github.com/codebrainz/color-names
Material Design icons by Google
https://github.com/google/material-design-icons
License
Copyright (C) 2017 nshmura
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.
### After
21 Feb 6, 2021
1 Jan 26, 2022
3 Sep 28, 2022
1.7k Dec 31, 2022
11.1k Dec 27, 2022
2.5k Dec 31, 2022
10.2k Dec 26, 2022
11.6k Dec 27, 2022
1.5k Jan 6, 2023
1.1k Dec 21, 2022
290 Dec 9, 2022
75 Nov 23, 2022
35 Feb 15, 2022
831 Dec 26, 2022
88 Dec 11, 2022
216 Dec 16, 2022
23 Apr 7, 2022
1.3k Jan 2, 2023
3 Jul 27, 2022