Skip to content

Most visited

Recently visited

navigation
added in version 24.1.0
belongs to Maven artifact com.android.support:design:27.0.0

TabLayout.Tab

public static final class TabLayout.Tab
extends Object

java.lang.Object
   ↳ android.support.design.widget.TabLayout.Tab


A tab in this layout. Instances can be created via newTab().

Summary

Constants

int INVALID_POSITION

An invalid position for a tab.

Public methods

CharSequence getContentDescription()

Gets a brief description of this tab's content for use in accessibility support.

View getCustomView()

Returns the custom view used for this tab.

Drawable getIcon()

Return the icon associated with this tab.

int getPosition()

Return the current position of this tab in the action bar.

Object getTag()
CharSequence getText()

Return the text of this tab.

boolean isSelected()

Returns true if this tab is currently selected.

void select()

Select this tab.

TabLayout.Tab setContentDescription(int resId)

Set a description of this tab's content for use in accessibility support.

TabLayout.Tab setContentDescription(CharSequence contentDesc)

Set a description of this tab's content for use in accessibility support.

TabLayout.Tab setCustomView(int resId)

Set a custom view to be used for this tab.

TabLayout.Tab setCustomView(View view)

Set a custom view to be used for this tab.

TabLayout.Tab setIcon(Drawable icon)

Set the icon displayed on this tab.

TabLayout.Tab setIcon(int resId)

Set the icon displayed on this tab.

TabLayout.Tab setTag(Object tag)

Give this Tab an arbitrary object to hold for later use.

TabLayout.Tab setText(int resId)

Set the text displayed on this tab.

TabLayout.Tab setText(CharSequence text)

Set the text displayed on this tab.

Inherited methods

From class java.lang.Object

Constants

INVALID_POSITION

added in version 24.1.0
int INVALID_POSITION

An invalid position for a tab.

See also:

Constant Value: -1 (0xffffffff)

Public methods

getContentDescription

added in version 24.1.0
CharSequence getContentDescription ()

Gets a brief description of this tab's content for use in accessibility support.

Returns
CharSequence Description of this tab's content

See also:

getCustomView

added in version 24.1.0
View getCustomView ()

Returns the custom view used for this tab.

Returns
View

See also:

getIcon

added in version 24.1.0
Drawable getIcon ()

Return the icon associated with this tab.

Returns
Drawable The tab's icon

getPosition

added in version 24.1.0
int getPosition ()

Return the current position of this tab in the action bar.

Returns
int Current position, or INVALID_POSITION if this tab is not currently in the action bar.

getTag

added in version 24.1.0
Object getTag ()

Returns
Object This Tab's tag object.

getText

added in version 24.1.0
CharSequence getText ()

Return the text of this tab.

Returns
CharSequence The tab's text

isSelected

added in version 24.1.0
boolean isSelected ()

Returns true if this tab is currently selected.

Returns
boolean

select

added in version 24.1.0
void select ()

Select this tab. Only valid if the tab has been added to the action bar.

setContentDescription

added in version 24.1.0
TabLayout.Tab setContentDescription (int resId)

Set a description of this tab's content for use in accessibility support. If no content description is provided the title will be used.

Parameters
resId int: A resource ID referring to the description text

Returns
TabLayout.Tab The current instance for call chaining

See also:

setContentDescription

added in version 24.1.0
TabLayout.Tab setContentDescription (CharSequence contentDesc)

Set a description of this tab's content for use in accessibility support. If no content description is provided the title will be used.

Parameters
contentDesc CharSequence: Description of this tab's content

Returns
TabLayout.Tab The current instance for call chaining

See also:

setCustomView

added in version 24.1.0
TabLayout.Tab setCustomView (int resId)

Set a custom view to be used for this tab.

If the inflated layout contains a TextView with an ID of text1 then that will be updated with the value given to setText(CharSequence). Similarly, if this layout contains an ImageView with ID icon then it will be updated with the value given to setIcon(Drawable).

Parameters
resId int: A layout resource to inflate and use as a custom tab view

Returns
TabLayout.Tab The current instance for call chaining

setCustomView

added in version 24.1.0
TabLayout.Tab setCustomView (View view)

Set a custom view to be used for this tab.

If the provided view contains a TextView with an ID of text1 then that will be updated with the value given to setText(CharSequence). Similarly, if this layout contains an ImageView with ID icon then it will be updated with the value given to setIcon(Drawable).

Parameters
view View: Custom view to be used as a tab.

Returns
TabLayout.Tab The current instance for call chaining

setIcon

added in version 24.1.0
TabLayout.Tab setIcon (Drawable icon)

Set the icon displayed on this tab.

Parameters
icon Drawable: The drawable to use as an icon

Returns
TabLayout.Tab The current instance for call chaining

setIcon

added in version 24.1.0
TabLayout.Tab setIcon (int resId)

Set the icon displayed on this tab.

Parameters
resId int: A resource ID referring to the icon that should be displayed

Returns
TabLayout.Tab The current instance for call chaining

setTag

added in version 24.1.0
TabLayout.Tab setTag (Object tag)

Give this Tab an arbitrary object to hold for later use.

Parameters
tag Object: Object to store

Returns
TabLayout.Tab The current instance for call chaining

setText

added in version 24.1.0
TabLayout.Tab setText (int resId)

Set the text displayed on this tab. Text may be truncated if there is not room to display the entire string.

Parameters
resId int: A resource ID referring to the text that should be displayed

Returns
TabLayout.Tab The current instance for call chaining

setText

added in version 24.1.0
TabLayout.Tab setText (CharSequence text)

Set the text displayed on this tab. Text may be truncated if there is not room to display the entire string.

Parameters
text CharSequence: The text to display

Returns
TabLayout.Tab The current instance for call chaining

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)