Skip to content

An interactive indicator to navigate between the different pages of a ViewPager

Notifications You must be signed in to change notification settings

juliendn/SlidingTabStrip

 
 

Repository files navigation

Android SlidingTabStrip

Forked from PagerSlidingTabStrip by Andreas Stütz.

This fork provides a View tu mimic a Tab widget. The result is similar to Andreas's library.

PagerSlidingTabStrip Sample Screenshot 1PagerSlidingTabStrip Sample Screenshot 2

Usage

For a working implementation of this project see the sample/ folder.

  1. Include the library as local library project or add the dependency in your build.gradle.

    dependencies { // TODO compile '' }

  2. Include the SlidingTabStrip widget in your layout.

    <fr.jdn.SlidingTabStrip android:id="@+id/tabs" android:layout_width="match_parent" android:layout_height="48dip" />

  3. In your onCreate method (or onViewCreated for a fragment), set a OnTabClickListener.

    SlidingTabStrip tabs = (SlidingTabStrip) findViewById(R.id.tabs);
    tabs.setOnTabClickListener( new OnTabClickListener(){
       public void onTabClicked( int position )
       {
           // Do something
           Toast.makeText( context, "click " + position, Toast.LENGTH_SHORT).show();
       }
    });
    
  4. Populate the SlidingTabStrip.

    // continued from above
    tabs.addTextTab("test1");
    tabs.addTextTab("test2");
    tabs.addTextTab("test3");
    tabs.addTextTab("test4");
    tabs.addIconTab(android.R.drawable.ic_menu_add);
    tabs.addIconTab(android.R.drawable.ic_menu_call);
    tabs.addTextTab("test5");
    tabs.addTextTab("test6");
    
    tabs.clearTab();
    

Customization

To not just look like another Play Store styled app, go and adjust these values to match your brand:

  • stsIndicatorColor Color of the sliding indicator
  • stsUnderlineColor Color of the full-width line on the bottom of the view
  • stsDividerColor Color of the dividers between tabs
  • stsIndicatorHeightHeight of the sliding indicator
  • stsUnderlineHeight Height of the full-width line on the bottom of the view
  • stsDividerPadding Top and bottom padding of the dividers
  • stsTabPaddingLeftRight Left and right padding of each tab
  • stsScrollOffset Scroll offset of the selected tab
  • stsTabBackground Background drawable of each tab, should be a StateListDrawable
  • stsShouldExpand If set to true, each tab is given the same weight, default false
  • stsTextAllCaps 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.2

  • Upgraded gradle build files
  • Changed package name to com.astuetz.PagerSlidingTabStrip
  • #37, #41 Added psts prefix to all attributes in attrs.xml
  • #46 Changed the shouldExpand behavior to set the layout at the time the tab is added

Developed By

Credits

License

Copyright 2014 Julien De Nadai
----------------------------------------------------------------------------
"THE BEER-WARE LICENSE" (Revision 42):
<phk@FreeBSD.ORG> wrote this file. As long as you retain this notice you
can do whatever you want with this stuff. If we meet some day, and you think
this stuff is worth it, you can buy me a beer in return Poul-Henning Kamp
----------------------------------------------------------------------------

Beerware_logo

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.

About

An interactive indicator to navigate between the different pages of a ViewPager

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 97.6%
  • Groovy 2.4%