跳转至

指示器

添加: Version 0.2.0

指示器默认会以 圆点 形式显示你当前所在的页面。

Vp2IndicatorView

快速使用

添加: 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 ,可以通过 setSelectedColorsetUnSelectedColor 为指示器指定颜色。

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)
    ... // 其他设置
}

修改指示器为bitmap

示例代码

查看示例代码