Skip to content

Latest commit

 

History

History
43 lines (36 loc) · 4.31 KB

Guide.md

File metadata and controls

43 lines (36 loc) · 4.31 KB

HTViewPagerWithIndicator使用文档

HTViewPagerWithIndicator是一个基于SlidingTabLayoutViewPager的能够自定义滑动指示器视图的页面管理控件。根据README文档,基本了解了HTViewPagerWithIndicator的特点以及快速使用的方法。

1. 自定义控件属性设置

  • htHorizontalBorderHeightSlidingTabLayout底部横向分割线的高度,可选,默认0
  • htHorizontalBorderColorSlidingTabLayout底部横向分割线的颜色,可选;
  • htIndicatorHeight:滑动指示器的高度,可选,默认8dp
  • htVerticalDividerHeightTabView间分割线的高度,可选,默认是0,宽度默认1dp
  • htTabViewOffsetTabView滑动时的偏移量,可选,默认0
  • htMaxVisibleViewCount:控件可见TabView的数量n,可选。n默认值是-1,表示TabView自适应宽度;若n=0,则全部的TabView平分SlidingTabLayout的宽度;若N大于0,则TabView的宽度为SlidingTabLayout宽度的1/n,多出的部分将不可见。
  • htTabLayoutPaddingTop:设置SlidingTabLayoutPaddingTop值。htTabLayoutPaddingLefthtTabLayoutPaddingBottomhtTabLayoutPaddingRight类似;
  • htTabLayoutBackground:设置SlidingTabLayout的背景(注意不要再getTabView返回的view中设置背景色,会覆盖指示器);
  • htTabLayoutGravity:设置SlidingTabLayout 的对齐位置,top(默认)或者bottom
  • htIndicatorGravity:设置Indicator指示器的对齐位置,top或者bottom(默认);
  • htHorizontalDividerGravity:底部横向分割线的对齐位置,top或者bottom(默认)。

2. TabView视图的数据源接口

用户在创建ViewPagerPagerAdapter时,通过实现HTSlidingTabLayoutAdapter接口,可以实现自定义TabView样式。其中包括TabView的视图、TabView的数据绑定、滑动指示器的宽度、以及TabView切换回调等。

HTSlidingTabLayoutAdapter接口方法
  • View getTabView(int position, ViewGroup parent)

获取指定位置上的TabView视图。positionTabView的索引,parent为父容器。如果要显示指示器,不要再返回的view中设置背景色,会覆盖指示器。

  • int getIndicatorWidth(int position)

获取指定位置的指示器宽度,单位px,默认和TabView等宽。positionTabView的索引。

  • void onTabViewBindData(View tabView, int position)

将指定位置的tabView进行数据绑定。tabView是当前的TabView视图,positionTabView的索引。

  • void onTabViewStatusChanged(View tabView, int position, boolean isSelected)

TabView初始化或者切换时,监听控件的状态变化进行回调。tabView是当前状态发生变化的TabView视图,position为该TabView的索引,isSelected标示状态。

3.控件的常用方法

HTViewPagerWithIndicator是继承ViewPager的,因此ViewPager的接口方法详细说明参考ViewPager使用

其他常用方法
  • setEnableViewPagerSlide(boolean enableSlide):是否允许ViewPager页面横向滑动,默认允许;
  • setEnableTabViewScroll(boolean enableScroll):是否允许TabView横向滑动,默认允许;
  • setSelectedIndicatorColors(int... colors):设置滑动指示器的颜色,默认是透明色。参数可以是一组颜色,将以循环的形式显示;
  • setDividerColors(int... colors):设置纵向分割线的颜色,默认透明色。参数可以是一组颜色,将以循环的形式显示;
  • setCustomTabColorizer(SlidingTabLayout.TabColorizer tabColorizer):设置自定义的TabView的滑动指示器和纵向分割线的颜色;
  • setIndicatorViewShow(boolean indicatorShow):设置是否显示滑动指示器,默认显示;
  • void notifyTabViewsDataSetChanged():通知全部的TabView重新绑定数据;
  • notifyTabViewDataSetChanged(int position):通知指定位置的TabView数据重新绑定