LillteZheng / Viewpagerhelper

你是否有遇到这样的问题，每次开发一个新的项目，在 viewpager 这一块上，总是在做重复的东西，比如app引导页，轮播图， viewpager+fragment 的 tab 指示器等等，这些虽然简单，但却是每个app都要的，而且很耗时，有没有每次在写这个，都很无语的感觉呢？ 基于这个，ViewPagerHleper 就诞生了，它可以快速帮你搞定 banner 轮播图，实现高级定制化，内置多种指示器，满足你的日常需求，妈妈再也不用担心我不会复制粘贴了。

工程实际使用 - 玩Android 客户端 : https://github.com/LillteZheng/WanAndroid

注意注意注意！！！ 提问题的时候，请遵循以下标准

• 现象: 操作步骤，应用场景
• 对应代码: 贴图或者贴代码
• 机型或版本: 可选

后面对描述不清的问题，不予理会，精力有限，感谢理解

详细内容可以参考这篇博客： http://blog.csdn.net/u011418943/article/details/78493002

使用

这里用的是 jitpack 这个网站，所以：

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

然后在你的 module 中添加：

implementation 'com.github.LillteZheng.ViewPagerHelper:viewpagerlib:v2.9'

如果你使用 androidx 也想要使用 ViewPager2，可以添加 androidx 库

implementation 'com.github.LillteZheng.ViewPagerHelper:viewpagerlibx:v2.9'

ViewPager2 使用的是 BannerViewPager2 这个类，只支持横向的 ViewPager2，竖直的后面有时间再搞 使用与 BannerViewPageer 一样，只是多了 banner2_l_margin和banner2_r_margin，或者setMzMargin() 去设置一屏多页(魅族)的效果。

效果图

首先，大家最常用到的就是轮播图了，这里给大家提供了 常用的 Indicator

轮播图

文字效果	扇形效果

CircleIndicator	RectIndicator

图片放大效果	卡片效果

跟多说明请参考 轮播使用说明

Tab指示器

TabIndicator 已经不再维护；推荐大家使用新库：https://github.com/LillteZheng/FlowHelper 支持更多效果，功能更强大，且支持自己自定义

三角形版本	条形状版本	文字颜色渐变方式，加了滚动效果

https://github.com/LillteZheng/FlowHelper 的效果如下：

没有结合ViewPager	结合ViewPager

Tab指示器使用说明

弧形图片，支持高斯模糊

弧形图片

版本说明

v2.9

• 添加 Androidx lib，支持viewpager2
• 修复card mode 快速滑报错问题

v2.7

• 处理设置 setCurrentPosition 的问题

v2.6

• 处理刷新时，indicator 成倍增加，以及动画和位置不是从头再来的问题

v2.1

• 大改动，去掉了之前很多无用代码和逻辑
• Indicator 效果全部统一到了 CircleIndicator 和 RectIndicator，其他的去掉
• BannerViewPager 增加 setCurrentPosition(int page) 默认选中第几页方法
• BannerViewPager 修复和 Recyclerview 结合，移除窗口后回来，滚动失败的问题

v1.9

• 处理TabIndicator第一次没加载数据报错和优化部分代码

v1.8

• 修改ArcImageView
• 增加缩放因子
• 增加缩放中心点坐标

v1.7

• 修改ArcImageView
• arcHeight 支持负数，凹进去，方便在user界面使用
• 增加高斯模糊，arc_blur ，对应参数0到25
• 支持使用背景色，采用arc_use_color

v1.6

• ArcImageView 去掉scaleType中的 matrix 属性

v1.5

• 修改了BannerViewpager 的一些自定说明，避免歧义，小伙伴记得更新呀
• 自定义控件，全部增加动态设置参数接口，写得好累啊
• BannerViewpager 增加了卡片式布局的效果
• 优化Readme说明

其他版本

• v1.4 --> 添加ScaleImageView可缩放控件，可支持在viewpager等滑动控件中使用
• v1.3 --> TabIndicator 支持滚动，app:tab_iscanscroll 默认true滚动，可设置不滚动
• v0.9 --> 处理第一次轮播图 index 不对问题，优化代码
• v0.8 --> 退出时自动关轮播，isOutVisiableWindow()方法，用于有滚动时，判断是否停止轮播
• v0.5 --> 增加 banner_loop_max_count 变量，当数据大于这个数值时，才会填充多个数据和轮播
• v0.4 --> 解决app引导页，快速滑动时，“立即体验”按钮会不显示问题,并修改自定义属性，防止干扰
• v0.3 --> 从lib中移除glide的依赖，防止干扰其他项目，去掉和优化一些代码，谢谢各位的提醒
• v0.2 --> 修复TabIndicator的宽度，不是 match_parent时，通过SetTabData添加数据，却显示不全的问题
• v0.1 --> 发布稳定版

如果该项目对您有帮助，赞赏一下吧 ^_^

下面可以看一下自定义的属性，方便大家在用的时候调用：

一些自定义属性：

BannerViewPager

CircleIndicator

RectIndicator

|rect_normalColor|color|默认的颜色| |rect_selectedColor|color|选中时的颜色| |rect_horizon_margin|dimension|两个矩形的距离| |rect_width|dimension|矩形的宽度| |rect_height|dimension|矩形的高度| |rect_round_size|dimension|矩形的圆角| |rect_canMove|boolean|是否可移动，默认支持移动|

TextIndicator

其实就是一个 textview ，自己配置大小颜色和背景即可

弧形图片 ArcImageView

顶部viewpager指示器 TabIndicator

渐变文字 ColorTextVIew

缩放控件 ScaleImageView

如果你有想要的效果，而本项目中没有的，你可以在 issue 中提出来，作者看到了，会抽空去实现的， 如果有发现问题了或者需要提供哪些接口出来，也可以在 issue 中提出来。当然，喜欢请 start 或 fork 来一波。

代码是最好的老师，可以download，改成自己喜欢的。