ViewPagerIndicator源码解析从BaseIndicatorView到IndicatorView的实现原理【免费下载链接】viewpagerindicator Worked with ViewPager and ViewPager2,support multiple slider styles and multiple slide mode.This repo was split from BannerViewPager-项目地址: https://gitcode.com/gh_mirrors/view/viewpagerindicatorViewPagerIndicator是一个功能强大的Android指示器库支持多种指示器样式和滑动模式完美兼容ViewPager和ViewPager2。这个开源项目为Android开发者提供了高度可定制的页面指示器解决方案让轮播图、引导页等场景的指示器实现变得简单高效。本文将从源码层面深入解析其核心架构带你理解从BaseIndicatorView到IndicatorView的实现原理。 核心架构设计ViewPagerIndicator采用分层架构设计主要分为三个层次基础层BaseIndicatorView - 处理页面滑动逻辑和基本配置实现层IndicatorView - 具体的指示器视图实现绘制层Drawer体系 - 负责不同样式的绘制逻辑BaseIndicatorView滑动事件处理的核心BaseIndicatorView是整个库的基础类位于indicator/src/main/java/com/zhpan/indicator/base/BaseIndicatorView.kt。它继承自Android的View类并实现了IIndicator接口主要负责与ViewPager/ViewPager2的绑定和页面监听滑动进度计算和状态管理指示器基本属性的配置// 核心的页面滚动处理方法 override fun onPageScrolled(position: Int, positionOffset: Float, positionOffsetPixels: Int) { if (!mIndicatorOptions.animateAfterPageChanged() getSlideMode() ! IndicatorSlideMode.NORMAL getPageSize() 1) { scrollSlider(position, positionOffset) invalidate() } }BaseIndicatorView通过setupWithViewPager()方法将指示器与ViewPager绑定自动监听页面切换事件。它支持五种滑动模式NORMAL、SMOOTH、WORM、COLOR和SCALE每种模式都有不同的视觉效果。IndicatorView具体实现与绘制代理IndicatorView是开发者直接使用的类位于indicator/src/main/java/com/zhpan/indicator/IndicatorView.kt。它继承自BaseIndicatorView通过DrawerProxy代理具体的绘制工作class IndicatorView JvmOverloads constructor( context: Context, attrs: AttributeSet? null, defStyleAttr: Int 0 ) : BaseIndicatorView(context, attrs, defStyleAttr) { private lateinit var mDrawerProxy: DrawerProxy override fun onDraw(canvas: Canvas) { super.onDraw(canvas) mDrawerProxy.onDraw(canvas, this) } }IndicatorView的关键创新在于绘制代理模式- 它将具体的绘制逻辑委托给DrawerProxy实现了绘制逻辑与视图逻辑的分离。 绘制系统Drawer架构ViewPagerIndicator的绘制系统是其最精妙的部分采用工厂模式策略模式的设计DrawerFactory样式工厂DrawerFactory位于indicator/src/main/java/com/zhpan/indicator/drawer/DrawerFactory.kt根据不同的指示器样式创建对应的绘制器internal object DrawerFactory { fun createDrawer(indicatorOptions: IndicatorOptions, view: View): IDrawer { return when (indicatorOptions.indicatorStyle) { IndicatorStyle.DASH - DashDrawer(indicatorOptions, view) IndicatorStyle.ROUND_RECT - RoundRectDrawer(indicatorOptions, view) else - CircleDrawer(indicatorOptions, view) } } }具体绘制器实现库提供了三种主要绘制器都位于indicator/src/main/java/com/zhpan/indicator/drawer/目录CircleDrawer- 圆形指示器绘制器DashDrawer- 短横线指示器绘制器RoundRectDrawer- 圆角矩形指示器绘制器每个绘制器都继承自BaseDrawer实现了IDrawer接口负责具体的绘制逻辑和动画效果。DrawerProxy绘制代理DrawerProxy位于indicator/src/main/java/com/zhpan/indicator/drawer/DrawerProxy.kt作为中间层协调绘制工作class DrawerProxy(private val indicatorOptions: IndicatorOptions, private val view: View) : IDrawer { private lateinit var mIDrawer: IDrawer init { init(indicatorOptions) } private fun init(indicatorOptions: IndicatorOptions) { mIDrawer DrawerFactory.createDrawer(indicatorOptions, view) } } 配置系统IndicatorOptions所有的配置选项都集中在IndicatorOptions类中位于indicator/src/main/java/com/zhpan/indicator/option/IndicatorOptions.kt。这个类采用建造者模式方便链式调用// 示例配置 indicatorView.apply { setSliderColor(normalColor, checkedColor) setSliderWidth(resources.getDimension(R.dimen.dp_10)) setSlideMode(IndicatorSlideMode.WORM) setIndicatorStyle(IndicatorStyle.CIRCLE) setupWithViewPager(view_pager2) }主要配置项包括指示器样式CIRCLE、DASH、ROUND_RECT滑动模式NORMAL、SMOOTH、WORM、COLOR、SCALE颜色配置正常状态色、选中状态色尺寸配置宽度、高度、间距方向配置水平、垂直、从右到左 滑动动画实现原理ViewPagerIndicator支持五种滑动动画模式每种模式的实现原理不同1. NORMAL模式最简单的模式直接跳转到选中位置没有过渡动画。2. SMOOTH模式平滑滑动模式指示器随着ViewPager的滑动而平滑移动。3. WORM模式虫洞效果当前指示器吞噬下一个指示器实现流畅的过渡效果。4. COLOR模式颜色渐变效果当前指示器和下一个指示器的颜色会随着滑动进度渐变。5. SCALE模式缩放效果当前指示器会放大下一个指示器会缩小。这些动画效果在具体的Drawer实现中完成例如CircleDrawer中的drawWormSlider()、drawColor()、drawScaleSlider()等方法。 使用示例与最佳实践快速集成步骤添加依赖在build.gradle中添加jitpack依赖布局配置在XML中添加IndicatorView代码绑定通过setupWithViewPager()方法与ViewPager绑定自定义指示器ViewPagerIndicator支持高度自定义你可以通过继承BaseIndicatorView创建自己的指示器class CustomIndicatorView : BaseIndicatorView { // 自定义绘制逻辑 override fun onDraw(canvas: Canvas) { // 你的绘制代码 } } 性能优化技巧避免频繁重绘只在需要时调用invalidate()合理使用动画根据场景选择合适的滑动模式内存优化复用Paint对象避免在绘制方法中创建新对象 源码学习要点通过分析ViewPagerIndicator的源码我们可以学到设计模式应用工厂模式、策略模式、代理模式Android自定义View最佳实践测量、布局、绘制的正确实现动画系统设计多种动画效果的统一管理配置系统设计建造者模式在Android中的应用 总结ViewPagerIndicator通过清晰的架构设计和优秀的代码组织提供了一个功能强大且易于扩展的指示器解决方案。从BaseIndicatorView的基础事件处理到IndicatorView的具体实现再到Drawer系统的灵活绘制每一层都体现了良好的软件设计原则。无论你是Android初学者还是经验丰富的开发者研究ViewPagerIndicator的源码都能让你对Android自定义View、动画系统和设计模式有更深入的理解。这个项目不仅提供了实用的功能更是一个优秀的学习资源。要了解更多实现细节建议直接查看源码文件BaseIndicatorView.ktIndicatorView.ktDrawerFactory.ktCircleDrawer.kt【免费下载链接】viewpagerindicator Worked with ViewPager and ViewPager2,support multiple slider styles and multiple slide mode.This repo was split from BannerViewPager-项目地址: https://gitcode.com/gh_mirrors/view/viewpagerindicator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考