登录

去注册 忘记密码?

登录

注册

去登录

  • 扫码关注公众号
  • 发送“我爱安卓
  • 即可获取验证码

注册

解锁回答区域

  • 扫码关注公众号
  • 发送“我爱安卓

若你登陆,将永久解锁;
若未登录,仅本机解锁。

解锁回答区域

获取注册验证码

  • 扫码关注公众号
  • 发送“我爱安卓
  • 即可获取验证码

兼容ViewPager与ViewPager2,支持多种指示器样式以及多种滑动样式

zhpanvip   2020-04-26 21:17   收藏

ViewPagerIndicator

English | 中文

ViewPagerIndicator使用案例

预览

### 点击链接或扫描二维码下载demo APK

QRCode

目前,该库已经可以支持多种指示器样式和多种滑动模式,同时,也支持Drawable指示器和自定义指示器

IndicatorView

属性CIRCLEDASHROUND_RECT
NORMALCIRCLE_NORMALDASH_NORMALROUND_RECT_NORMAL
SMOOTHCIRCLE_SMOOTHDASH_SMOOTHROUND_RECT_SMOOTH
WORMCIRCLE_WORMDASH_WORMROUND_WORM
COLORCIRCLE_COLORDASH_COLORROUND_COLOR
SCALECIRCLE_SCALEDASH_SCALEROUND_SCALE

DrawableIndicator

Bitmap DrawableVector Drawable
NORMALNORMAL

API

MethodDescriptionDefault
setIndicatorStyle(Int)设置指示器样式枚举类型(CIRCLE;DASH;ROUND_RECT) 默认值:CIRCLE
setSliderColor(normalColor: Int,selectedColor: Int)设置指示器滑块颜色normalColor:未选中时的滑块颜色, 默认值:"#8C6C6D72", checkedColor:选中时滑块颜色,默认值:"#8C18171C"
setSlideMode(slideMode: Int)设置滑块滑动模式枚举类型(NORMAL;SMOOTH;WORM;COLOR;SCALE),默认值:NORMAL
setSliderWidth(indicatorWidth:Int)设置滑块宽度,如果是圆形指示器则为滑块直径默认值:8dp
setSliderWidth(normalWidth Int , checkWidth Int)设置滑块宽度,如果是圆形指示器则为滑块直径默认值 8dp
setIndicatorHeight(indicatorHeight Int)设置指示器高度,只有在DASH和ROUND_RECT样式下有效默认值为:normalIndicatorWidth/2
setSliderGap(indicatorMargin Int )设置滑块之间的间距默认值为滑块宽度或者直径
setupWithViewPager(ViewPager)indicator与ViewPager关联
setupWithViewPager(ViewPager2)indicator与ViewPager2关联

如何使用

添加依赖

在项目的gradle中添加如下依赖:

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}
	

在模块的gradle中添加如下依赖:

implementation 'com.github.zhpanvip:viewpagerindicator:latestVersion'

latestVersion:

1.IndicatorView

到目前为止IndicatorView已经可以支持三种indicator样式以及五种滑动样式,具体使用步骤如下:

(1).在layout.xml文件中添加如下代码:

    <RelativeLayout
            android:layout_width="match_parent"
            android:layout_height="@dimen/dp_200"
            tools:context=".MainActivity">

            <androidx.viewpager.widget.ViewPager
                android:id="@+id/banner_view"
                android:layout_width="match_parent"
                android:layout_height="match_parent" />

            <com.zhpan.indicator.IndicatorView
                android:id="@+id/indicator_view"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_alignParentBottom="true"
                android:layout_centerHorizontal="true"
                android:layout_margin="@dimen/dp_10" />

    </RelativeLayout>

(2) 为IndicatorView配置参数以及关联ViewPager/ViewPager2:

        val indicatorView = findViewById<IndicatorView>(R.id.indicator_view2)
        indicatorView
                    .setSliderColor(getResColor(R.color.red_normal_color), getResColor(R.color.red_checked_color))
                    .setSliderWidth(resources.getDimension(R.dimen.dp_17))
                    .setSliderHeight(resources.getDimension(R.dimen.dp_5))
                    .setSlideMode(IndicatorSlideMode.WORM)
                    .setIndicatorStyle(IndicatorStyle.CIRCLE)
                    .setupWithViewPager(viewPager)

2.DrawableIndicator

使用DrawableIndicator可以设置bitmap drawable或者vector drawable,可以自定义drawable的大小,具体使用步骤如下:

(1) Add IndicatorView in layout.xml

    <RelativeLayout
            android:layout_width="match_parent"
            android:layout_height="@dimen/dp_200"
            tools:context=".MainActivity">

            <androidx.viewpager.widget.ViewPager
                android:id="@+id/banner_view"
                android:layout_width="match_parent"
                android:layout_height="match_parent" />

            <com.zhpan.indicator.DrawableIndicator
                android:id="@+id/indicator_view"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_alignParentBottom="true"
                android:layout_centerHorizontal="true"
                android:layout_margin="@dimen/dp_10" />

    </RelativeLayout>

(2) DrawableIndicator与ViewPager/ViewPager2关联:

        val indicatorView = findViewById<DrawableIndicator>(R.id.indicator_view)
        val dp10 = resources.getDimensionPixelOffset(R.dimen.dp_10)
        indicatorView
              .setIndicatorGap(resources.getDimensionPixelOffset(R.dimen.dp_2_5))
              .setIndicatorDrawable(R.drawable.heart_empty, R.drawable.heart_red)
              .setIndicatorSize(dp10, dp10, dp10, dp10)
              .setupWithViewPager(viewPager)

3.自定义Indicator样式

例子将实现一个如下图的indicator样式

Custom IndicatorView Style
NORMAL

(1)自定义View并继承BaseIndicatorView

public class FigureIndicatorView extends BaseIndicatorView {

    private int radius = DpUtils.dp2px(20);

    private int backgroundColor = Color.parseColor("#88FF5252");

    private int textColor = Color.WHITE;

    private int textSize=DpUtils.dp2px(13);

    public FigureIndicatorView(Context context) {
        this(context, null);
    }

    public FigureIndicatorView(Context context, @Nullable AttributeSet attrs) {
        this(context, attrs, 0);
    }

    public FigureIndicatorView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        mPaint = new Paint();
    }

    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
        setMeasuredDimension(2 * radius, 2 * radius);
    }

    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        mPaint.setColor(backgroundColor);
        canvas.drawCircle(getWidth() / 2, getHeight() / 2, radius, mPaint);
        mPaint.setColor(textColor);
        mPaint.setTextSize(textSize);
        String text = currentPosition + 1 + "/" + pageSize;
        int textWidth = (int) mPaint.measureText(text);
        Paint.FontMetricsInt fontMetricsInt = mPaint.getFontMetricsInt();
        int baseline = (getMeasuredHeight() - fontMetricsInt.bottom + fontMetricsInt.top) / 2 - fontMetricsInt.top;
        canvas.drawText(text, (getWidth() - textWidth) / 2, baseline, mPaint);
    }

    public void setRadius(int radius) {
        this.radius = radius;
    }

    @Override
    public void setBackgroundColor(@ColorInt int backgroundColor) {
        this.backgroundColor = backgroundColor;
    }

    public void setTextSize(int textSize) {
        this.textSize = textSize;
    }

    public void setTextColor(int textColor) {
        this.textColor = textColor;
    }
}

(2)自定义的indicator与ViewPager/ViewPager2关联

    val indicatorView = findViewById<FigureIndicatorView>(R.id.indicator_view)
            indicatorView.setBackgroundColor(Color.parseColor("#aa118EEA"))
            indicatorView.setTextSize(IndicatorUtils.dp2px(13f))
                    .setupWithViewPager(viewPager)

FAQ

如有问题可以加入QQ群交流

QQ交流群60902509

开源不易 随心赞赏

AlipayWeChat
NORMALSMOOTH

License

Copyright 2020 zhpanvip

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.