A custom ViewPager title strip which gives continuous feedback to the user when scrolling.

This library has been added some features and utilities based on android-SlidingTabBasic project of Google Samples.

Try out the sample application on the Play Store.

(For a working implementation of this project see the demo/ folder.)

Add the dependency to your build.gradle.

dependencies{compile 'com.ogaclejapan.smarttablayout:library:1.6.1@aar' //Optional: see how to use the utility. compile 'com.ogaclejapan.smarttablayout:utils-v4:1.6.1@aar' //Optional: see how to use the utility. compile 'com.ogaclejapan.smarttablayout:utils-v13:1.6.1@aar' } 

Include the SmartTabLayout widget in your layout. This should usually be placed above the ViewPager it represents.

<com.ogaclejapan.smarttablayout.SmartTabLayout android:id="@+id/viewpagertab"android:layout_width="match_parent"android:layout_height="48dp"app:stl_indicatorAlwaysInCenter="false"app:stl_indicatorWithoutPadding="false"app:stl_indicatorInFront="false"app:stl_indicatorInterpolation="smart"app:stl_indicatorGravity="bottom"app:stl_indicatorColor="#40C4FF"app:stl_indicatorThickness="4dp"app:stl_indicatorWidth="auto"app:stl_indicatorCornerRadius="2dp"app:stl_overlineColor="#4D000000"app:stl_overlineThickness="0dp"app:stl_underlineColor="#4D000000"app:stl_underlineThickness="1dp"app:stl_dividerColor="#4D000000"app:stl_dividerThickness="1dp"app:stl_defaultTabBackground="?attr/selectableItemBackground"app:stl_defaultTabTextAllCaps="true"app:stl_defaultTabTextColor="#FC000000"app:stl_defaultTabTextSize="12sp"app:stl_defaultTabTextHorizontalPadding="16dp"app:stl_defaultTabTextMinWidth="0dp"app:stl_distributeEvenly="false"app:stl_clickable="true"app:stl_titleOffset="24dp"app:stl_drawDecorationAfterTab="false" /> <android.support.v4.view.ViewPager android:id="@+id/viewpager"android:layout_width="match_parent"android:layout_height="match_parent"android:layout_below="@id/viewpagertab" /> 

In your onCreate method (or onCreateView for a fragment), bind the widget to the ViewPager. (If you use a utility together, you can easily add items to PagerAdapter)

e.g. ViewPager of v4.Fragment

FragmentPagerItemAdapteradapter = newFragmentPagerItemAdapter( getSupportFragmentManager(), FragmentPagerItems.with(this) .add(R.string.titleA, PageFragment.class) .add(R.string.titleB, PageFragment.class) .create()); ViewPagerviewPager = (ViewPager) findViewById(R.id.viewpager); viewPager.setAdapter(adapter); SmartTabLayoutviewPagerTab = (SmartTabLayout) findViewById(R.id.viewpagertab); viewPagerTab.setViewPager(viewPager);

(Optional) If you use an OnPageChangeListener with your view pager you should set it in the widget rather than on the pager directly.

viewPagerTab.setOnPageChangeListener(mPageChangeListener);

(Optional) Using the FragmentPagerItemAdapter of utility, you will be able to get a position in the Fragment side.

intposition = FragmentPagerItem.getPosition(getArguments());

This position will help to implement the parallax scrolling header that contains the ViewPager :P

There are several attributes you can set:

Notes: Both 'stl_indicatorAlwaysInCenter' and 'stl_distributeEvenly' if it is set to true, it will throw UnsupportedOperationException.

The customization of tab There are three ways.

• Customize the attribute
• SmartTabLayout#setCustomTabView(int layoutResId, int textViewId)
• SmartTabLayout#setCustomTabView(TabProvider provider)

If set the TabProvider, can build a view for each tab.

publicclassSmartTabLayoutextendsHorizontalScrollView{//.../** * Create the custom tabs in the tab layout. Set with *{@link #setCustomTabView(com.ogaclejapan.smarttablayout.SmartTabLayout.TabProvider)} */publicinterfaceTabProvider{/** * @return Return the View of{@code position} for the Tabs */ViewcreateTabView(ViewGroupcontainer, intposition, PagerAdapteradapter)} //... }

Utility has two types available to suit the Android support library.

• utils-v4 library contains the PagerAdapter implementation class for android.support.v4.app.Fragment
• utils-v13 library contains the PagerAdapter implementation class for android.app.Fragment

The two libraries have different Android support libraries that depend, but implemented functionality is the same.

ViewPagerItemAdapteradapter = newViewPagerItemAdapter(ViewPagerItems.with(this) .add(R.string.title, R.layout.page) .add("title", R.layout.page) .create()); viewPager.setAdapter(adapter); //...publicvoidonPageSelected(intposition){//.instantiateItem() from until .destroyItem() is called it will be able to get the View of page.Viewpage = adapter.getPage(position)} 

Fragment-based PagerAdapter There are two implementations. Please differences refer to the library documentation for Android.

• FragmentPagerItemAdapter extends FragmentPagerAdapter
• FragmentStatePagerItemAdapter extends FragmentStatePagerAdapter

FragmentPagerItemAdapteradapter = newFragmentPagerItemAdapter( getSupportFragmentManager(), FragmentPagerItems.with(this) .add(R.string.title, PageFragment.class), .add(R.string.title, WithArgumentsPageFragment.class, newBundler().putString("key", "value").get()), .add("title", PageFragment.class) .create()); viewPager.setAdapter(adapter); //...publicvoidonPageSelected(intposition){//.instantiateItem() from until .destoryItem() is called it will be able to get the Fragment of page.Fragmentpage = adapter.getPage(position)}

Notes: If using fragment inside a ViewPager, Must be use Fragment#getChildFragmentManager().

• Qiitanium
• Ameba

Check WormTabStrip out.

Copyright (C) 2015 ogaclejapan Copyright (C) 2013 The Android Open Source Project 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.