Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/andy671/dachshund-tab-layout

Extended Android Tab Layout with animated indicators that have continuous feedback.
https://github.com/andy671/dachshund-tab-layout

android android-development android-layout android-library android-ui animations java view

Last synced: about 8 hours ago
JSON representation

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

Host: GitHub
URL: https://github.com/andy671/dachshund-tab-layout
Owner: Andy671
License: mit
Created: 2017-02-11T19:58:21.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2022-09-07T10:54:43.000Z (about 2 years ago)
Last Synced: 2024-10-16T16:13:06.264Z (28 days ago)
Topics: android, android-development, android-layout, android-library, android-ui, animations, java, view
Language: Java
Homepage:
Size: 160 KB
Stars: 855
Watchers: 20
Forks: 90
Open Issues: 6
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Dachshund Tab Layout

[![](https://img.shields.io/badge/minSDK-15-brightgreen.svg)](https://developer.android.com/training/basics/supporting-devices/platforms.html)

[![](https://jitpack.io/v/Andy671/Dachshund-Tab-Layout.svg)](https://jitpack.io/#Andy671/Dachshund-Tab-Layout)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

# ![Logo](https://raw.githubusercontent.com/Andy671/Dachshund-Tab-Layout/master/dachshund_logo.png)

## Introduction

Boosted Android Tab Layout with custom animated indicators including "Dachshund" animation inspired by [this](https://material.uplabs.com/posts/tab-interaction).

## Sample

![](http://i.giphy.com/1VVYHwT4OFf6U.gif)

## Available Animated Indicators

| Indicator         	|  Example | Custom behavior |

|--------------------- 	|--------------------------------| ----- |

| DachshundIndicator 	| ![](http://i.giphy.com/115nZIzHqsDpcI.gif) | |

| PointMoveIndicator	|![](http://i.giphy.com/yK9y4NcPH7wNa.gif)  | setInterpolator(TimeInterpolator interpolator) |

| LineMoveIndicator 	| ![](http://i.giphy.com/rzvsTmlUOod0I.gif) | setEdgeRadius(int edgeRadius)|

| PointFadeIndicator	| ![](http://i.giphy.com/nQZYOyfYH7gJy.gif)  | |

| LineFadeIndicator 	| ![](http://i.giphy.com/PHUmWmrM0O7YI.gif) | setEdgeRadius(int edgeRadius)|

###

## Installation

### Step 1

Add the JitPack repository to your build file

```gradle

	allprojects {

		repositories {

			...

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

		}

	}

```

### Step 2

Add the dependency

```gradle

	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:

```xml

 

	

```

Setup it with a ViewPager:

```java

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

	tabLayout.setupWithViewPager(yourViewPager);

```

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

```java

	//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](https://stackoverflow.com/questions/33191794/android-tablayout-with-active-tab-always-at-center-just-like-in-play-newsstand) question.

```xml

```

## 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):

```java

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