dcarlsson c6fdfe669e Update headers for Android Material Components documentation to clarify page titles in relation to table of contents/index listings.
- Update page title for each piece of documentation to use the vernacular concept rather
than the class name for the component.
- Treat all instances of class names as proper nouns and mark them as code names.

PiperOrigin-RevId: 155705022
2017-05-11 12:57:38 -07:00

2.5 KiB

Tab Layout

TabLayout provides a horizontal layout to display tabs. The layout handles interactions for a group of tabs including:

  • scrolling behavior,
  • (swipe) gestures,
  • tab selection,
  • animations,
  • and alignment.

The Android Developers site provides detailed documentation on implementing TabLayout.

Design & API Documentation

Usage

The Material Design guidelines for individual tabs is done in the tabs themselves; the TabLayout displays groups of these tabs and controls how they interact with each other.

A TabLayout is a single row of tabs and can be fixed or scrollable. For a fixed layout, the maximum number of tabs is limited by the size and number of the tabs and the screen size. Fixed tabs have equal width, based on the widest tab text.

A tab layout should be used above the content associated with the respective tabs and lets the user quickly change between content views. These content views are often held in a ViewPager.

Use setupWithViewPager(ViewPager) to link a TabLayout with a ViewPager. The individual tabs in the TabLayout will be automatically populated with the page titles from the PagerAdapter.

Alternatively, you can add a TabLayout to a ViewPager in XML:

<android.support.v4.view.ViewPager
    android:layout_width="match_parent"
    android:layout_height="match_parent">

  <android.support.design.widget.TabLayout
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_gravity="top" />

</android.support.v4.view.ViewPager>