记录TabLayout的一些用法(android)

Posted 2021-08-28 kaolagirl

一.简述

TabLayout是android support中的一个控件android.support.design.widget.TabLayout，Google在升级了AndroidX之后，将TabLayout迁移到material包下面去了com.google.android.material.tabs.TabLayout，原来的support下面的TabLayout从API 29开始就不再维护了。所以如果项目已经升级了AndroidX，建议直接使用后者。TabLayout一般结合ViewPager+Fragment的使用实现滑动的标签选择器。

二.属性

属性	描述
tabIndicatorColor	设置tab指示器(tab的下划线)的颜色
tabIndicatorHeight	设置tab指示器(tab的下划线)的高度
tabBackground	设置tab的背景。
tabContentStart	相对起始位置tab的Y轴偏移量。
tabGravity	tab的布局方式，两个值GRAVITY_CENTER （内容中心显示） 和 GRAVITY_FILL （内容尽可能充满TabLayout）。
tabMaxWidth	设置tab选项卡的最大宽度。
tabMinWidth	设置tab选项卡的最小宽度。
tabMode	设置布局中tab选项卡的行为模式，两个常量MODE_FIXED （固定的tab）和 MODE_SCROLLABLE（滑动的tab）。
tabPadding	设置tab的内边距（上下左右）。
tabPaddingTop	设置tab的上方内边距。
tabPaddingBottom	设置tab的底部内边距。
tabPaddingStart	设置tab的左侧内边距。
tabPaddingEnd	设置tab的右侧内边距。
tabSelectedTextColor	设置tab被选中时的文字颜色。
tabTextColor	设置tab默认的文字颜色。
tabRippleColor	设置水波纹背景颜色，如果设置为透明则可达到去掉水波纹的效果
tabIndicatorFullWidth	指示器与Tab的宽度是否相同，其宽度由Tab的宽度决定，默认为true；其宽度由Tab中的文字宽度决定，则为false

三. 方法

方法 描述
addOnTabSelectedListener（TabLayout.OnTabSelectedListener listener）	添加一个TabLayout.OnTabSelectedListener监听事件，当tab选择更改时，它将被调用。
addTab（TabLayout.Tab tab，boolean setSelected）	向此布局添加选项卡，并设置是否被选中
addTab（TabLayout.Tab tab，int position）	向此布局添加选项卡，并设置位置
addTab（TabLayout.Tab tab）	向此布局添加选项卡。
addTab（TabLayout.Tab tab，int position，boolean setSelected）	向此布局添加选项卡，设置位置并是否被选中
addView（View child，int index）	添加子视图到指定位置。
addView（View child）	添加子视图。
addView（View child，ViewGroup.LayoutParams params）	添加具有指定布局参数的子视图。
addView（View child，int index，ViewGroup.LayoutParams params）	添加具有指定布局参数的子视图。
clearOnTabSelectedListeners（）	删除所有以前添加的TabLayout.OnTabSelectedListeners。
generateLayoutParams（AttributeSet attrs）	根据提供的属性集返回一组新的布局参数。
getSelectedTabPosition（）	返回当前所选标签的位置。
TabLayout.Tab getTabAt（int index）	返回指定位置的tab。
getTabCount（）	返回当前在操作栏中注册的选项卡数。
getTabGravity（）	返回当前的标签tab的布局方式，GRAVITY_CENTER （内容中心显示） 和 GRAVITY_FILL （内容尽可能充满TabLayout）。
getTabMode（）	返回tab选项卡的行为模式,MODE_FIXED* （固定的tab）和 MODE_SCROLLABLE（滑动的tab）。
getTabTextColors（）	获取用于选项卡的不同状态（正常，已选择）的文本颜色。
newTab ()	创建并返回一个新的TabLayout.Tab。
removeAllTabs（）	从操作栏中删除所有选项卡，并取消选择当前选项卡。
removeOnTabSelectedListener（TabLayout.OnTabSelectedListener listener）	删除以前通过addOnTabSelectedListener（OnTabSelectedListener）添加的给定TabLayout.OnTabSelectedListener，tab选中监听器。
removeTab（TabLayout.Tab tab）	从布局中删除选项卡。
removeTabAt（int position）	从布局中删除指定位置的选项卡。
setOnTabSelectedListener（TabLayout.OnTabSelectedListener listener）	API方法24.0.0中已弃用此方法。使用addOnTabSelectedListener（OnTabSelectedListener）和removeOnTabSelectedListener（OnTabSelectedListener）。
setScrollPosition（int position，float positionOffset，boolean updateSelectedText）	设置选项卡的滚动位置，当标签tab显示为滚动容器（如ViewPager）的一部分时，此功能非常有用。位置int：当前滚动位置positionOffset float：表示从位置偏移的[0, 1)的值。updateSelectedText boolean：是否更新文本的选择状态。
setSelectedTabIndicatorColor（int color）	设置选中的tab的指示器（下划线）颜色。
setSelectedTabIndicatorHeight（int height）	设置选中的tab的指示器的高度。
setTabGravity（int gravity）	设置TabLayout的布局方式，GRAVITY_CENTER （内容中心显示） 和 GRAVITY_FILL （内容尽可能充满TabLayout）。
setTabMode（int mode）	设置tab选项卡的行为模式,MODE_FIXED* （固定的tab）和 MODE_SCROLLABLE（滑动的tab）。
setTabTextColors（int normalColor，int selectedColor）	设置用于选项卡的不同状态（常规，选定）的文字颜色。
setTabTextColors（ColorStateList textColor）	设置用于选项卡的不同状态（常规，选定）的文字颜色。
setTabsFromPagerAdapter（PagerAdapter adapter）	API方法23.2.0中已弃用此方法。使用setupWithViewPager（ViewPager）将TabLayout与ViewPager链接在一起。当使用该方法时，当更改PagerAdapter时，TabLayout将自动更新。
setupWithViewPager（ViewPager viewPager，boolean autoRefresh）	将TabLayout与ViewPager链接在一起，当更改PagerAdapter时，TabLayout是否更新由autoRefresh决定。
setupWithViewPager（ViewPager viewPager）	将TabLayout与ViewPager链接在一起。
shouldDelayChildPressedState（）	如果此ViewGroup的子代或子孙后代按下的状态应该被延迟，则返回true。 一般来说，应该对可以滚动的容器（如List）进行此操作。 这防止当用户实际上尝试滚动内容时出现按压状态。 由于兼容性原因，默认实现返回true。 不滚动的子类通常会覆盖此方法并返回false。

四.示例

1.默认样式

 <com.google.android.material.tabs.TabLayout
        android:id="@+id/tab_layout"
        android:background="@color/white"
        app:tabTextColor="@color/theme_defaultText"
        app:tabSelectedTextColor="@color/theme_color"
        app:tabIndicatorColor="@color/theme_color"
        app:tabIndicatorHeight="2dp"
        android:layout_width="match_parent"
        android:layout_height="40dp"/>

2.去除水波纹效

    <com.google.android.material.tabs.TabLayout
        android:id="@+id/tab_layout"
        android:background="@color/white"
        app:tabTextColor="@color/theme_defaultText"
        app:tabSelectedTextColor="@color/theme_color"
        app:tabIndicatorColor="@color/theme_color"
        app:tabIndicatorHeight="2dp"
        app:tabIndicatorFullWidth="false" //设置指示器长度与tab文字长度相同
        app:tabRippleColor="@color/transparent"  //去除水波纹效果
        android:layout_width="match_parent"
        android:layout_height="40dp"/>