指示器¶
添加: Version 0.2.0
指示器默认会以 圆点 形式显示你当前所在的页面。
快速使用¶
添加: Version 0.2.0
<com.ave.vastgui.tools.view.vp2indicator.Vp2IndicatorView
android:id="@+id/vp2indicator"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_margin="20dp"
app:indicator_item_count="3" />
AndroidView(factory = { ctx ->
Vp2IndicatorView(ctx).apply {
setIndicatorItemCount(5)
setIndicatorCircleRadius(20f)
}
})
附加到 ViewPager2¶
添加: Version 0.2.0
调用 attachToViewPager2
,你可以将指示器附加到 ViewPager2
上。
attachToViewPager2
该方法被调用后将不再允许手动设置指示器数量和当前被选中的指示器。
binding.vp2indicator.attachToViewPager2(binding.vp2)
设置圆点指示器半径¶
添加: Version 0.2.0
调用 setIndicatorCircleRadius
设置圆形指示器半径。
binding.vp2indicator.setIndicatorCircleRadius(8f.DP)
设置圆点指示器颜色¶
添加: Version 0.2.0
当指示器的风格为 Style.CIRCLE
,可以通过 setSelectedColor
和 setUnSelectedColor
为指示器指定颜色。
binding.vp2indicator.apply {
setSelectedColor(R.color.tomato)
setUnSelectedColor(R.color.limegreen)
... // 其他设置
}
设置指示器间距¶
添加: Version 0.2.0
可以通过 indicator_item_distance
或者调用 setIndicatorItemDistance
来修改指示器间距。
binding.vp2indicator.setIndicatorItemDistance(10f.DP)
<com.ave.vastgui.tools.view.viewpager2.indicator.Vp2IndicatorView
...
app:indicator_item_distance="10dp" />
设置指示器风格¶
添加: Version 0.5.0 更新: Version 1.5.2
可以通过 indicator_style
或者调用 setIndicatorStyle
来设置指示器类型,目前支持两种:
- CIRCLE:默认的圆形指示器
- BITMAP:指定对应的Bitmap为指示器形状
binding.vp2indicator.setIndicatorStyle(Vp2IndicatorView.Style.CIRCLE)
<com.ave.vastgui.tools.view.viewpager2.indicator.Vp2IndicatorView
...
app:indicator_style="circle" />
设置 Bitmap 作为指示器¶
添加: Version 0.5.0
下面的示例为你展示了如何设置三角形 bitmap 为指示器。
binding.vp2indicator.apply {
setIndicatorStyle(Style.BITMAP)
setBitmapSize(20f.DP.toInt(), 20f.DP.toInt())
setSelectedBitmap(R.drawable.ic_indicator_select)
setUnSelectedBitmap(R.drawable.ic_indicator_unselect)
... // 其他设置
}