DEV Community

bright inventions
bright inventions

Posted on • Updated on • Originally published at brightinventions.pl

Tabs - navigation pattern on Android

Proper content organisation in your Android application may be achieved with a wide range of layouts and widgets. Today I'd like to focus on tabs that is what kind of components are dedicated to using tabs in an application, what are the key principles in using them and how to customize their view.

Folder Tabs Img

Basic concept

Tabs are the pattern common and simple, it exceeds mobile or web apps design. To avoid overusing it though we need some clarification about its usage.

What is it for?

The key feature is to make a user aware of alternate views and give the ability to frequent switching between them. It may help to organize data sets (music > rock, pop, jazz, swing) or views with similar aspect (music > all, recent, recommended).

What is it NOT for?

Apps with a deep navigation structure or apps with a single core functionality. It might not be easy to classify the application like that, but it won't fit in most cases.

If we start to design a tab layout, first let's define some principles that we will follow. It might be important to say it before starting the implementation and keep it in mind.

Each tab should be equally important

Sometimes it might be a little confusing, but try to bring it to the basics. There's a little example:

Good usage: Horrors, Comedies, Thrillers, Drama

Bad usage: Blog, Store, Contact Us, About

Follow layout principles

Even if we are going to customize our view, there are some points that we'll never break. I know you might disagree with some, but in my opinion, these are what keeps the layout clear and understandable for the user. First of all, present tabs as a single row, either horizontal or vertical. Secondly, always highlight a selected tab, so the users know where they are in the app. Thirdly, do not nest the tabs. Fourthly, adjust a tab name or view to its content, so to the photos section lead tab with a name "photos", not e.g. "recording".

Keep consistent design of the tabs

It may be problematic in two cases. The one is the size of the tab, which should be similar to each one. You should be avoiding long descriptions in the tab because it is easier to adjust a size of one-word tabs to each other. The second one is if you decide to use something more than text tabs, like with images, for example, you should keep the pattern for each one and do not combine image tabs with text tabs. It brings unnecessary mess.

The concept above should be pretty general and mostly applies not only to Android apps. From now on let's write some code! And this is going to be very Android-specific!

Default usage

First, for using android.support.design.widget.TabLayout add design support dependency to build.gradle:

compile 'com.android.support:design:__NEWEST_VERSION_HERE__'
Enter fullscreen mode Exit fullscreen mode

Then we can define TabLayout into layout XML. The very basic usage of TabLayout is to use it as any other view container:

<android.support.design.widget.TabLayout
        android:id="@+id/myTabLayout"
        android:layout_height="wrap_content"
        android:layout_width="match_parent">

        <android.support.design.widget.TabItem
            android:text="DOGS"
            android:layout_height="wrap_content"
            android:layout_width="wrap_content" />

        <android.support.design.widget.TabItem
            android:text="CATS"
            android:layout_height="wrap_content"
            android:layout_width="wrap_content" />

    </android.support.design.widget.TabLayout>
Enter fullscreen mode Exit fullscreen mode

Mind that only TabItem instances can be added to TabLayout.

Then, to take some actions when the tab is selected, we have to add a listener to out tab layout:

myTabLayout.addOnTabSelectedListener( object : TabLayout.OnTabSelectedListener{
            override fun onTabReselected(tab: TabLayout.Tab?) {}

            override fun onTabUnselected(tab: TabLayout.Tab?){}

            override fun onTabSelected(tab: TabLayout.Tab?) {
                Toast.makeText(applicationContext,tab!!.text,Toast.LENGTH_SHORT).show()
            }

        })
Enter fullscreen mode Exit fullscreen mode

in onTabSelected method we have an access to the selected tab and all its view elements, like e.g. text. Very useful is especially a position field, which can be used as an index to a different container or as a reference to another view.

Adding tabs programmatically

To add tabs programmatically instead of defining it into xml simply use addTab() method. To add tab with single text simply define it like that:

val tab = myTabLayout.newTab()
tab.text = "DOGS"
myTabLayout.addTab(tab)
Enter fullscreen mode Exit fullscreen mode

Custom Tab view

The fun part is to finally add some more interesting view of our tabs instead of using only text. Let's combine the text with some nice images! Like this:

single tab

Define a round background for our image under res/drawable:

<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <solid android:color="#ffffff" />
    <size
        android:width="48dp"
        android:height="48dp" />
</shape>
Enter fullscreen mode Exit fullscreen mode

Then custom_tab.xml under res/layout

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:background="#888"
    android:layout_marginTop="10dp"
    android:layout_marginStart="10dp"
    android:gravity="center">

    <ImageView
        android:padding="15dp"
        android:id="@+id/tabImage"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:scaleType="centerInside"
        android:background="@drawable/white_circle" />

    <TextView
        android:paddingTop="5dp"
        android:id="@+id/tabText"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="#000"
        android:textSize="12sp" />

</LinearLayout>
Enter fullscreen mode Exit fullscreen mode

Under drawable again add some images you want to use for your tabs. Let's say they are dog.png and cat.png. Now adding a neat tab with your custom layout will be as easy as last time.

val tab = LayoutInflater.from(applicationContext).inflate(R.layout.custom_tab, null)
tab.tabImage.setImageResource(R.drawable.dog)
tab.tabText.text = "DOG"
myTabLayout.addTab(myTabLayout.newTab().setCustomView(tab))
Enter fullscreen mode Exit fullscreen mode

Little fancy customization

In the end, I'd like to share with you my concept of a TabLayout view, feel free to take some inspiration. Here's how it's going to look like:

Sliding Layout GIF

To achieve that we'll need to override some TabLayout functionality! This is what we are going to start with:

class SlideLayout @JvmOverloads constructor(
        context: Context,
        attrs: AttributeSet? = null,
        defStyleAttr: Int = 0) : TabLayout(context, attrs, defStyleAttr) {

      init {
        addOnTabSelectedListener(object : TabLayout.OnTabSelectedListener {

            override fun onTabSelected(tab: TabLayout.Tab) {
                tab.customView?.tabText?.setTypeface(null, Typeface.BOLD)
            }

            override fun onTabUnselected(tab: TabLayout.Tab) {
                tab.customView?.tabText?.setTypeface(null, Typeface.NORMAL)
            }

            override fun onTabReselected(tab: TabLayout.Tab) = Unit

        })
    }

}
Enter fullscreen mode Exit fullscreen mode

The simplest change is to make the tab's text bold when it is selected. We need addOnTabSelectedListener where we can implement the tab's behavior on selection. Then just apply a typeface as above! In XML definition remove highlight with the following attribute:

<com.bob.tabs.SlideLayout
    ...
    app:tabIndicatorHeight="0dp"
Enter fullscreen mode Exit fullscreen mode

First step done.

Center tabs

Next thing we will do is to display tabs with a selected tab in the center. Add this attribute to XML definition:

<com.bob.tabs.SlideLayout
    ...
    app:tabMode="scrollable"
Enter fullscreen mode Exit fullscreen mode

It will allow tabs to get over the screen. In consequence, selecting different tabs will scroll the whole layout and display selected one in the center if the rest of the tabs fill the remaining part of the screen. That means a few first and a few last tabs won't be centralized but aligned with the edge of the parent view. But! We can change it! In onLayout method let's do some math. We will add padding to the first and the last tab, so it is always in the center, and that's how we could calculate it:

override fun onLayout(changed: Boolean, l: Int, t: Int, r: Int, b: Int) {
    super.onLayout(changed, l, t, r, b)

    val lastTabIndex = getTabContainer()?.childCount?.minus(1) ?: 0
    val firstTab = getTabView(0)
    val lastTab = getTabView(lastTabIndex)

    if (firstTab != null && lastTab != null) {
        val paddingLeft = width / 2 - firstTab.width / 2
        val paddingRight: Int = width / 2 - lastTab.width / 2

        ViewCompat.setPaddingRelative(getTabContainer(), paddingLeft, 0, paddingRight, 0)
    }
}

Enter fullscreen mode Exit fullscreen mode

And these are some helper methods:

private fun getTabContainer(): ViewGroup? = getChildAt(0) as? ViewGroup
private fun getTabView(position: Int): View? = getTabContainer()?.getChildAt(position)
Enter fullscreen mode Exit fullscreen mode

Resizing

Now the last feature! Let's make our tabs resize when they away from the center, so we could get the impression they are on the carousel. Define some zoom multiplicators and help array:

private val MAX_ZOOM = 1.0f
private val MIN_ZOOM = 0.6f
private var screenPos = IntArray(2)
Enter fullscreen mode Exit fullscreen mode

Then do some math once again! This time we need to override onDraw method:

override fun onDraw(canvas: Canvas) {

        getTabContainer()?.let {
            for (i in 0 until it.childCount) {
                getTabView(i)?.let {

                    it.getLocationOnScreen(screenPos)
                    val pos = screenPos[0]
                    val width = it.width

                    val scale: Float
                    val tabCenter = pos + width / 2

                    if (tabCenter <= 0 || getWidth() <= tabCenter) {
                        scale = MIN_ZOOM
                    } else {
                        val sliderCenter = (getWidth() / 2).toFloat()
                        val distance = Math.abs(sliderCenter - tabCenter)
                        scale = MAX_ZOOM - (MAX_ZOOM - MIN_ZOOM) * distance / sliderCenter
                    }

                    /* View draw start in left top corner */
                    it.pivotY = 0f

                    it.scaleX = scale
                    it.scaleY = scale

                }
            }
        }

        super.onDraw(canvas)
    }
Enter fullscreen mode Exit fullscreen mode

While calculating how much to scale the tab, we need to define how far away (distance) is our tab from the center (sliderCenter). Base on that we choose, scale a multiplicator between MIN_ZOOM and MAX_ZOOM.

That's it, your sliding tabs are ready to use!

Slide Penguin GIF

The full code you can find on my github account. It contains even more functionalities with scrolling and docking tabs in the center. Feel free to test it, use it and modify it!

Originally published at brightinventions.pl

By Radek Pieczątkiewicz, Software Engineer @ Bright Inventions
Email

References:

  1. Tabs / material.io
  2. TabLayout / developer.android.com

Top comments (0)