Dachshund Tab Layout

Extended Android Tab Layout with animated indicators that have continuous feedback.

Description

Boosted Android Tab Layout with custom animated indicators including "Dachshund" animation inspired by this.

Code Quality Rank: L5

Programming language: Java

License: MIT License

Tags: Material-design     Animations     ViewPager     Java     Transitions     Views    

Latest version: v0.3.3

README

Dachshund Tab Layout

Introduction

Boosted Android Tab Layout with custom animated indicators including "Dachshund" animation inspired by this.

Sample

Available Animated Indicators

Indicator	Example	Custom behavior
DachshundIndicator
PointMoveIndicator		setInterpolator(TimeInterpolator interpolator)
LineMoveIndicator		setEdgeRadius(int edgeRadius)
PointFadeIndicator
LineFadeIndicator		setEdgeRadius(int edgeRadius)

Installation

Step 1

Add the JitPack repository to your build file

    allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

Step 2

Add the dependency

    dependencies {
        compile 'com.github.Andy671:Dachshund-Tab-Layout:v0.3.3'
    }

Usage

DachshundTabLayout is a subclass of TabLayout, so usage is pretty similar. The most of the original methods should work without any problems. See sample and source code for more info.

Add DachshundTabLayout to xml (after the Toolbar in the AppBarLayout), if you have TabLayout simply replace it:

 <android.support.design.widget.AppBarLayout
 ...
    <android.support.v7.widget.Toolbar           
    .../>
    <com.kekstudio.dachshundtablayout.DachshundTabLayout
        android:id="@+id/tab_layout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

Setup it with a ViewPager:

    DachshundTabLayout tabLayout = (DachshundTabLayout) findViewById(R.id.tab_layout);
    tabLayout.setupWithViewPager(yourViewPager);

If you want to change animated indicator (see Available Animated Indicators):

    //AvailableAnimatedIndicator - change it with available animated indicator

    AvailableAnimatedIndicator indicator = new AvailableAnimatedIndicator(tabLayout);
    tabLayout.setAnimatedIndicator(indicator);

Center align

In v0.3.2 I've added ddCenterAlign parameter. You can use it when you want to center the tabs in scrollable tabMode. Working behavior from Stackoverflow question.

<com.kekstudio.dachshundtablayout.DachshundTabLayout
        ...
        custom:tabMode="scrollable"
        custom:ddCenterAlign="true"/>

Creating custom AnimatedIndicator

If you want to create your own custom AnimatedIndicator - you can implement AnimatedIndicatorInterface and if you want to use animators - AnimatorUpdateListener (See JavaDoc of AnimatedIndicatorInterface for more info):

public class CustomIndicator implements AnimatedIndicatorInterface, ValueAnimator.AnimatorUpdateListener {

    private DachshundTabLayout dachshundTabLayout;

    public CustomIndicator(DachshundTabLayout dachshundTabLayout){
        this.dachshundTabLayout = dachshundTabLayout;

        //here set-up your Animators, Paints etc.
    }

    @Override
    public void onAnimationUpdate(ValueAnimator animator) {
        // when animator updates - invalidate your canvas, and draw what you want.
    }

    @Override
    public void setSelectedTabIndicatorColor(@ColorInt int color) {
        // customization of color
    }

    @Override
    public void setSelectedTabIndicatorHeight(int height) {
        // customization of height
    }

    @Override
    public void setIntValues(int startXLeft, int endXLeft,
                             int startXCenter, int endXCenter,
                             int startXRight, int endXRight){
        // X-positions of the target and current tabs
    }

    @Override
    public void setCurrentPlayTime(long currentPlayTime) {
        // current play time of the animation
    }

    @Override
    public void draw(Canvas canvas) {
        //Make your draw calls here
    }

    @Override
    public long getDuration() {
        return DEFAULT_DURATION;
    }
}

XML Attributes

Attribute	Type	Default
ddIndicatorHeight	dimension	6dp
ddIndicatorColor	color	Color.WHITE
ddAnimatedIndicator	enum [dachshund, pointMove, lineMove, pointFade, lineFade]	dachshund

Contribution

• Feel free to fork the repo, make pull requests or fix existing bug
• Feel free to open issues if you find some bug or unexpected behaviour