Android 关于CircleIndicator

一、CircleIndicator的介绍及使用

        在 Android 中，CircleIndicator 是一个用于显示 ViewPager 页面指示器的开源库。它可以在 ViewPager 中显示圆形指示器，用于指示当前页面和总页面数量，提供了一种简洁美观的方式来显示当前页面的位置。

1.引入 CircleIndicator 库：

在项目的 build.gradle 文件中的 dependencies 中添加以下依赖：
implementation 'me.relex:circleindicator:1.3.2

2.在 XML 布局文件中添加 CircleIndicator：

在需要显示指示器的布局文件中，添加 CircleIndicator 组件：
<me.relex.circleindicator.CircleIndicator
    android:id="@+id/indicator"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="center_horizontal"
    android:padding="16dp"
    app:ci_drawable="@drawable/indicator_selector" />

这里设置了指示器的布局宽高为 wrap_content，并将其放置在水平居中的位置，设置了内边距和指示器的样式。
3.在 Java 代码中设置 CircleIndicator：

在对应的活动中，找到指示器的实例，并将其与 ViewPager 关联：
ViewPager viewPager = findViewById(R.id.view_pager);
CircleIndicator indicator = findViewById(R.id.indicator);

viewPager.setAdapter(adapter); // 设置适配器
indicator.setViewPager(viewPager); // 将指示器与 ViewPager 关联
这里通过 setViewPager() 方法将 CircleIndicator 与 ViewPager 关联起来。

4.自定义指示器样式：

可以通过在布局文件中设置 app:ci_drawable 属性来自定义指示器的样式。
创建一个 XML 文件，定义指示器的样式，例如 indicator_selector.xml：
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/selected_dot" android:state_selected="true" />
    <item android:drawable="@drawable/unselected_dot" />
</selector>
在 drawable 目录下创建 selected_dot.xml 和 unselected_dot.xml 文件，分别表示选中状态和未选中状态的指示器样式。
你可以在这些 XML 文件中定义自己喜欢的形状、颜色和大小等样式。

二、 CircleIndicator的优缺点

优点：

1. 简单易用：CircleIndicator 提供了简单的 API，易于集成和使用。只需几行代码即可将指示器与 ViewPager 关联起来。

2. 定制性：该库允许你自定义指示器的样式和外观。你可以定义选中和未选中状态的指示器形状、颜色、大小等属性，以适应你的应用设计。

3. 轻量级：CircleIndicator 是一个轻量级库，不会对应用的性能产生明显影响。

4. 支持滑动特性：当使用 CircleIndicator 时，它会随着 ViewPager 页面的滑动而更新当前页面的位置。这提供了一种可视化的方式来导航和切换页面。

缺点：

1. 有限的样式选项：尽管 CircleIndicator 允许定制指示器的样式，但它的样式选项相对有限。如果你需要更多复杂的样式，可能需要自定义指示器或寻找其他开源库。

2. 依赖性：使用 CircleIndicator 需要在项目中添加该库的依赖。虽然这不是一个大问题，但仍然需要确保正确管理和更新依赖。

总体来说，CircleIndicator 是一个简单易用的开源库，适用于大多数基本的 ViewPager 页面指示器需求。它具有一定的定制性，能满足一般的指示器样式需求。但如果你需要更复杂的样式或更高度定制的指示器，可能需要考虑其他库或自定义实现。需要根据具体的项目需求和设计决策是否选择使用 CircleIndicator 或其他可用的指示器库。

三、CircleIndicator常用方法

1. setViewPager(ViewPager viewPager)：将指示器与指定的 ViewPager 关联起来。这样，指示器就能够根据 ViewPager 的页面数量和当前选中的页面进行更新显示。

2. setViewPager(ViewPager viewPager, int initialPage)：除了关联 ViewPager 外，还可以指定初始页面。这样，在设置指示器时，初始页面就会被标记为选中状态。

3. setViewPager(ViewPager viewPager, int initialPage, IndicatorClickListener listener)：除了关联 ViewPager 和指定初始页面外，还可以设置一个点击监听器。通过设置监听器，可以在用户点击指示器时执行自定义的操作。

4. setCount(int count)：手动设置指示器的总页面数量。如果你不使用 setViewPager() 方法关联 ViewPager，可以使用该方法手动设置页面数量。

5. setCurrentItem(int currentItem)：手动设置当前选中的页面位置。这样，指示器将相应地更新选中状态。

6. setIndicatorStyle(int indicatorStyle)：设置指示器的样式。可选的样式包括 IndicatorStyle.DEFAULT（默认样式）和 IndicatorStyle.DASH（短划线样式）。

7. setOrientation(int orientation)：设置指示器的布局方向。可选的方向包括 Orientation.HORIZONTAL（水平方向）和 Orientation.VERTICAL（垂直方向）。

8. setRadius(float radius)：设置指示器圆点的半径大小。

9. setFillColor(int color)：设置选中状态圆点的填充颜色。

10. setStrokeColor(int color)：设置未选中状态圆点的边框颜色。

11. setStrokeWidth(float width)：设置未选中状态圆点边框的宽度。