Android PagerSlidingTabStrip
Interactive paging indicator widget, compatible with the ViewPager
from the Android Support Library.
Try out the sample application on the Play Store.
Usage
For a working implementation of this project see the sample/
folder.
-
Include the library as local library project or add the dependency in your build.gradle.
dependencies { compile 'com.astuetz:pagerslidingtabstrip:1.0.1' }
-
Include the PagerSlidingTabStrip widget in your layout. This should usually be placed above the
ViewPager
it represents.<com.astuetz.PagerSlidingTabStrip android:id="@+id/tabs" android:layout_width="match_parent" android:layout_height="48dip" />
-
In your
onCreate
method (oronCreateView
for a fragment), bind the widget to theViewPager
.// Initialize the ViewPager and set an adapter ViewPager pager = (ViewPager) findViewById(R.id.pager); pager.setAdapter(new TestAdapter(getSupportFragmentManager())); // Bind the tabs to the ViewPager PagerSlidingTabStrip tabs = (PagerSlidingTabStrip) findViewById(R.id.tabs); tabs.setViewPager(pager);
-
(Optional) If you use an
OnPageChangeListener
with your view pager you should set it in the widget rather than on the pager directly.// continued from above tabs.setOnPageChangeListener(mPageChangeListener);
Customization
To not just look like another Play Store styled app, go and adjust these values to match your brand:
pstsIndicatorColor
Color of the sliding indicatorpstsUnderlineColor
Color of the full-width line on the bottom of the viewpstsDividerColor
Color of the dividers between tabspstsIndicatorHeight
Height of the sliding indicatorpstsUnderlineHeight
Height of the full-width line on the bottom of the viewpstsDividerPadding
Top and bottom padding of the dividerspstsTabPaddingLeftRight
Left and right padding of each tabpstsScrollOffset
Scroll offset of the selected tabpstsTabBackground
Background drawable of each tab, should be a StateListDrawablepstsShouldExpand
If set to true, each tab is given the same weight, default falsepstsTextAllCaps
If true, all tab titles will be upper case, default true
All attributes have their respective getters and setters to change them at runtime
Changelog
Current Version: 1.0.1
1.0.1
- Upgraded gradle build files
- Changed package name to
com.astuetz.PagerSlidingTabStrip
- #37, #41 Added
psts
prefix to all attributes inattrs.xml
- #46 Changed the shouldExpand behavior to set the layout at the time the tab is added
Developed By
- Andreas Stuetz - [email protected]
Credits
- Kirill Grouchnikov - Author of an explanation post on Google+
License
Copyright 2013 Andreas Stuetz
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.