Summary: Constants | Fields | Ctors | Methods | Inherited Methods

TabLayout.Tab

public static class TabLayout.Tab
extends Object

java.lang.Object
↳	com.google.android.material.tabs.TabLayout.Tab

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

Summary

Constants
`int`	`INVALID_POSITION` An invalid position for a tab.

Fields
`public TabLayout`	`parent`
`public TabLayout.TabView`	`view`

Public constructors
`Tab()`

Public methods
`BadgeDrawable`	`getBadge()` Returns an instance of `BadgeDrawable` associated with this tab, null if none was initialized.
`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`	`getId()` Returns the id for this tab, `View.NO_ID` if not set.
`BadgeDrawable`	`getOrCreateBadge()` Creates an instance of `BadgeDrawable` if none exists.
`int`	`getPosition()` Return the current position of this tab in the action bar.
`int`	`getTabLabelVisibility()` Gets the visibility mode for the Labels in this Tab.
`Object`	`getTag()`
`CharSequence`	`getText()` Return the text of this tab.
`boolean`	`isSelected()` Returns true if this tab is currently selected.
`void`	`removeBadge()` Removes the `BadgeDrawable`.
`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`	`setId(int id)` Give this tab an id, useful for testing.
`TabLayout.Tab`	`setTabLabelVisibility(int mode)` Sets the visibility mode for the Labels in 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

`Object`	`clone()`
`boolean`	`equals(Object arg0)`
`void`	`finalize()`
`final Class<?>`	`getClass()`
`int`	`hashCode()`
`final void`	`notify()`
`final void`	`notifyAll()`
`String`	`toString()`
`final void`	`wait(long arg0, int arg1)`
`final void`	`wait(long arg0)`
`final void`	`wait()`

Constants

INVALID_POSITION

public static final int INVALID_POSITION

An invalid position for a tab.

See also:

getPosition()

Constant Value: -1 (0xffffffff)

Fields

parent

public TabLayout parent

view

public TabLayout.TabView view

Public constructors

Tab

public Tab ()

Public methods

getBadge

public BadgeDrawable getBadge ()

Returns an instance of BadgeDrawable associated with this tab, null if none was initialized.

Returns
`BadgeDrawable`

getContentDescription

public 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

public View getCustomView ()

Returns the custom view used for this tab.

Returns
`View`

See also:

getIcon

public Drawable getIcon ()

Return the icon associated with this tab.

Returns
`Drawable`	The tab's icon

getId

public int getId ()

Returns the id for this tab, View.NO_ID if not set.

Returns
`int`

getOrCreateBadge

public BadgeDrawable getOrCreateBadge ()

Creates an instance of BadgeDrawable if none exists. Initializes (if needed) and returns the associated instance of BadgeDrawable.

Returns
`BadgeDrawable`	an instance of BadgeDrawable associated with `Tab`.

getPosition

public 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.

getTabLabelVisibility

public int getTabLabelVisibility ()

Gets the visibility mode for the Labels in this Tab.

Returns
`int`	the label visibility mode, one of `TabLayout.TAB_LABEL_VISIBILITY_UNLABELED` or `TabLayout.TAB_LABEL_VISIBILITY_LABELED`.

See also:

setTabLabelVisibility(int)

getTag

public Object getTag ()

Returns
`Object`	This Tab's tag object.

getText

public CharSequence getText ()

Return the text of this tab.

Returns
`CharSequence`	The tab's text

isSelected

public boolean isSelected ()

Returns true if this tab is currently selected.

Returns
`boolean`

removeBadge

public void removeBadge ()

Removes the BadgeDrawable. Do nothing if none exists. Consider changing the visibility of the BadgeDrawable if you only want to hide it temporarily.

select

public void select ()

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

setContentDescription

public 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

public 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

public 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 R.id.text1 then that will be updated with the value given to setText(CharSequence). Similarly, if this layout contains an ImageView with ID R.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

public 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 R.id.text1 then that will be updated with the value given to setText(CharSequence). Similarly, if this layout contains an ImageView with ID R.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

public 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

public 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

setId

public TabLayout.Tab setId (int id)

Give this tab an id, useful for testing.

Do not rely on this if using TabLayout.setupWithViewPager(ViewPager)

Parameters
`id`	`int`

Returns
`TabLayout.Tab`

setTabLabelVisibility

public TabLayout.Tab setTabLabelVisibility (int mode)

Sets the visibility mode for the Labels in this Tab. The valid input options are:

TabLayout.TAB_LABEL_VISIBILITY_UNLABELED: Tabs will appear without labels regardless of whether text is set.
TabLayout.TAB_LABEL_VISIBILITY_LABELED: Tabs will appear labeled if text is set.

Parameters
`mode`	`int`: one of `TabLayout.TAB_LABEL_VISIBILITY_UNLABELED` or `TabLayout.TAB_LABEL_VISIBILITY_LABELED`.

Returns
`TabLayout.Tab`	The current instance for call chaining.

setTag

public 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

public 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

public 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