CycleViewPager2
Introduction
使用 ViewPager2
实现无限轮播效果,可以用来实现 banner 以及上下滚动文字广告等。
Screenshots
- MultiplePagerScaleInTransformer
- ZoomOutPageTransformer
- DepthPageTransformer
Features
- 支持无限自动轮播
- 支持水平竖直方向
- 支持圆点指示符及自定义
- 支持一屏显示 3 个 item 的切换效果
- 支持 ZoomOutPageTransformer & DepthPageTransformer 效果
Getting started
在项目的根节点的 build.gradle
中添加如下代码
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
在项目的 build.gradle
中添加
dependencies {
implementation 'com.github.wangpeiyuan:CycleViewPager2:v1.0.7'
}
注意:还需要自行添加 ViewPager2 的依赖。如:
dependencies {
implementation "androidx.viewpager2:viewpager2:1.0.0"
}
ViewPager2 最新版本请点击此处
Usage
在 XML 布局文件中:
<com.wangpeiyuan.cycleviewpager2.CycleViewPager2 android:id="@+id/banner" android:layout_width="0dp" android:layout_height="250dp" android:layout_marginTop="16dp" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toTopOf="parent" />
继承
CyclePagerAdapter
或CyclePagerFragmentAdapter
实现相关方法,跟RecyclerView
的Adapter
基本类似,如: ``` private inner class MyCyclePagerAdapter : CyclePagerAdapter() { override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): PagerViewHolder { return PagerViewHolder(LayoutInflater.from(parent.context) .inflate(R.layout.fragment_pager, parent, false) )
}
override fun getRealItemCount(): Int = items.size
override fun onBindRealViewHolder(holder: PagerViewHolder, position: Int) {
holder.ivPager.setImageResource(items[position]) holder.tvTitle.text = position.toString()
} }
private inner class PagerViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) { var ivPager: ImageView = itemView.findViewById(R.id.iv_pager) var tvTitle: TextView = itemView.findViewById(R.id.tv_title) }
3. 通过 `CycleViewPager2` 设置相关参数。
//设置 adapter,此 adapter 必须是继承自 CyclePagerAdapter 或 CyclePagerFragmentAdapter cycleViewPager2.setAdapter(adapter) //设置指示符 cycleViewPager2.setIndicator(indicator) //设置自动轮播间隔 cycleViewPager2.setAutoTurning(autoTurningTime) //设置切换效果,可以多个效果组合 cycleViewPager2.setPageTransformer(compositePageTransformer) //添加间距 cycleViewPager2.addItemDecoration(itemDecoration) //添加切换监听 cycleViewPager2.registerOnPageChangeCallback(pageChangeCallback)
cycleViewPager2.setOffscreenPageLimit(limit)
cycleViewPager2.setOrientation(orientation)
或者使用 `CycleViewPager2Helper` 方式。
CycleViewPager2Helper(banner) .setAdapter(adapter) .setMultiplePagerScaleInTransformer( nextItemVisiblePx.toInt(), currentItemHorizontalMarginPx.toInt(), 0.1f ) .setDotsIndicator( dotsRadius, Color.RED, Color.WHITE, dotsPadding, 0, dotsBottomMargin.toInt(), 0, DotsIndicator.Direction.CENTER ) .setAutoTurning(3000L) .build() ```
更多特殊效果
指示符(Indicator),目前库中仅简单实现了圆点的指示符
DotsIndicator
,更多的效果可以实现Indicator
接口自定义,具体可以参考DotsIndicator
的实现。MultiplePagerScaleInTransformer
,实现了一屏多个的效果,这个效果需要配合MarginItemDecoration
来使用(也可以通过设置 item 的间距达到相同的效果)。- 更多的切换效果(PageTransformer),需要自己实现
ViewPager2.PageTransformer
。
License
Apache License, Version 2.0