android 轮播图 github,Android轮播图控件的实现详解(附GitHub开源链接)

轮播图在Android开发中是非常常见的控件,一般App的首页广告和电商类App的商品详情图片都会用轮播图来实现。可是Android源生的控件中却没有能直接拿来使用的轮播图控件,所以一般的轮播图效果都需要我们自己去实现。今天我就给大家介绍一个我自己写的轮播图控件:CustomBanner。有需要的同学可以直接访问我的GitHub使用该控件。下面我将为大家详细介绍CustomBanner控件的实现思路和细节。

(说明:下面我贴出来的代码只是CustomBanner的代码摘要,想要看完整源码的同学请到GitHub下载或引用依赖)

1、布局

轮播图一般由一个可以左右滚动、承载图片的主体控件和一个显示当前位置的指示器组成。CustomBanner的布局非常简单,直接继承FrameLayout,内部添加两个子View:一个ViewPager(可以左右滚动、承载图片的主体控件)和一个LinearLayout(指示器容器)。

public class CustomBannerextends FrameLayout {

private ViewPager mBannerViewPager;

private LinearLayout mIndicatorLayout;

//添加轮播图ViewPager

private void addBannerViewPager(Context context) {

mBannerViewPager = new ViewPager(context);

this.addView(mBannerViewPager);

}

//添加轮播图指示器容器

private void addIndicatorLayout(Context context) {

mIndicatorLayout = new LinearLayout(context);

LayoutParams lp = new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);

lp.gravity = analysisGravity(mIndicatorGravity);

lp.setMargins(0, 0, 0, DensityUtils.dp2px(context, 8));

mIndicatorLayout.setGravity(Gravity.CENTER);

this.addView(mIndicatorLayout, lp);

}

}

2、实现轮播图的无限循环

轮播图是需要左右无限循环滚动的,而ViewPager是有滚动边界的。为了实现ViewPager循环滚动,我采用了网上一个很巧妙的实现方式。就是ViewPager的实际长度是它的应有长度+2,在ViewPager的应有长度的头尾各加一个节点。头节点的数据跟ViewPager的最后一个数据一样,尾节点的数据跟ViewPager的第一个数据一样。当ViewPager滚动到尾节点时,就无缝跳转到第一个数据,当ViewPager滚动到头节点时,就无缝跳转到最后一个数据,由于跳转的两节点的数据是一样的,而且是无缝跳转,没有过度动画,所以用户感觉不到ViewPager的显示节点已经改变,就给用户一种ViewPager在无限循环的错觉。具体请看这里。

由于多加了两个节点,所以在处理ViewPager的position时,实际的position和用户所看到的position是不一样的。比如:轮播图有5张图片,用户看到的也应该是5张图片,而实际上我们的ViewPager会有7张图片,因为第1张图片和第6张图片是同一张图片,第7张图片和第2张图片是同一张图片。这里可能很不好理解,但是一定要理解,因为这是实现轮播图循环轮播的关键。

//ViewPager的实际长度是他的数据的长度+2

@Override

public int getCount() {

return mDatas == null || mDatas.isEmpty() ? 0 : mDatas.size() + 2;

}

//通过实际的position计算用户所理解的position

private int getActualPosition(int position) {

if (position == 0) {

//如果是头节点,返回最后一个数据的position

//因为头节点的数据和最后一个数据是一样的。

return mDatas.size() - 1;

} else if (position == getCount() - 1) {

//如果是尾节点,返回第一个数据的position

//因为尾节点的数据和第一个数据是一样的。

return 0;

} else {

//除了头尾以外,position节点的数据是mDatas中的第position - 1的下标的数据

return position - 1;

}

}

3、设置ViewPager的滚动速度

ViewPager有自己的mScroller属性,负责控制ViewPager的滚动速度。但是ViewPager的默认滚动速度太快了,而且ViewPager并没有提供方法设置mScroller的滚动速度也没有提供方法设置mScroller,所以我们需要通过反射用自己的mScroller替换掉ViewPager的mScroller,使我们可以完全控制和操作ViewPager的mScroller属性。这不仅仅是实现我们自定义ViewPager的滚动速度,也是实现第2步中ViewPager无缝跳转的关键。

//通过反射替换掉mBannerViewPager的mScroller属性

private void replaceViewPagerScroll() {

try {

Field field = ViewPager.class.getDeclaredField("mScroller");

field.setAccessible(true);

mScroller = new ViewPagerScroller(mContext,

new AccelerateInterpolator());

field.set(mBannerViewPager, mScroller);

} catch (Exception e) {

}

}

/**

* 设置轮播图的滚动速度

*

* @param scrollDuration

*/

public CustomBannersetScrollDuration(int scrollDuration) {

mScroller.setScrollDuration(scrollDuration);

return this;

}

public class ViewPagerScroller extends Scroller {

private int mScrollDuration = 550;

//是否无缝跳转

private boolean sudden;

public ViewPagerScroller(Context context) {

super(context);

}

public ViewPagerScroller(Context context, Interpolator interpolator) {

super(context, interpolator);

}

public ViewPagerScroller(Context context, Interpolator interpolator,

boolean flywheel) {

super(context, interpolator, flywheel);

}

@Override

public void startScroll(int startX, int startY, int dx, int dy, int duration) {

super.startScroll(startX, startY, dx, dy, sudden ? 0 : mScrollDuration);

}

@Override

public void startScroll(int startX, int startY, int dx, int dy) {

super.startScroll(startX, startY, dx, dy, sudden ? 0 : mScrollDuration);

}

public int getScrollDuration() {

return mScrollDuration;

}

public void setScrollDuration(int scrollDuration) {

this.mScrollDuration = scrollDuration;

}

public boolean isSudden() {

return sudden;

}

public void setSudden(boolean zero) {

this.sudden = zero;

}

}

4、实现ViewPager的自动轮播

这个实现起来非常的简单。直接利用Handler延迟发送消息的功能来进行轮播滚动的计时,在消息的处理中改变ViewPager显示的Item,达到ViewPager的自动滚动效果,然后再Handler发送一个延迟消息,形成循环。

private Handler mTimeHandler = new Handler();

private Runnable mTurningTask = new Runnable() {

@Override

public void run() {

if (isTurning && mBannerViewPager != null) {

int page = mBannerViewPager.getCurrentItem() + 1;

mBannerViewPager.setCurrentItem(page);

mTimeHandler.postDelayed(mTurningTask, mIntervalTime);

}

}

};

/**

* 启动轮播

* @param intervalTime 轮播间隔时间

* @return

*/

public CustomBannerstartTurning(long intervalTime) {

isTurning = true;

mIntervalTime = intervalTime;

mTimeHandler.postDelayed(mTurningTask, mIntervalTime);

return this;

}

5、添加和更新指示器

指示器的指示点用指示器容器mIndicatorLayout来承载,当ViewPager滚动的时候,指示器也要相应的做更新

//根据轮播图的数量来添加指示器的点

//指示器的点用ImageView来表示,样式由使用者自定义

private void initIndicator(int count) {

mIndicatorLayout.removeAllViews();

if (count > 0) {

for (int i = 0; i < count; i++) {

ImageView imageView = new ImageView(mContext);

LinearLayout.LayoutParams lp = new LinearLayout.LayoutParams(

ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);

0, DensityUtils.dp2px(mContext, 2), 0);

mIndicatorLayout.addView(imageView, lp);

}

}

}

/**

* 更新指示器

*/

private void updateIndicator() {

int count = mIndicatorLayout.getChildCount();

//获取ViewPager当前显示的Item。

int currentPage = getCurrentItem();

if (count > 0) {

for (int i = 0; i < count; i++) {

ImageView view = (ImageView) mIndicatorLayout.getChildAt(i);

if (i == currentPage) {

//设置选中样式

view.setImageResource(mIndicatorSelectRes);

} else {

//设置未选中样式

view.setImageResource(mIndicatorUnSelectRes);

}

}

}

}

6、设置轮播图数据

把轮播图的基本功能都实现了之后,接下来就是填充数据了。下面先看设置数据的方法:

/**

* 设置轮播图数据

* @param creator 创建和更新轮播图View的接口

* @param data 轮播图数据

* @return

*/

public CustomBannersetPages(ViewCreatorcreator, Listdata) {

mAdapter = new BannerPagerAdapter(mContext, creator, data);

mBannerViewPager.setAdapter(mAdapter);

return this;

}

代码非常的简单,其实就是给mBannerViewPager设置了一个Adapter。上面的setPages方法接收两个参数:

1、creator:这是一个ViewCreator对象,ViewCreator是负责创建和更新轮播图的接口。

2、data:这是轮播图的数据。

他们的泛型T是轮播图的数据类型,轮播图的数据类型可以是任何的类型。

下面是ViewCreator接口代码

/**

* 创建和更新轮播图View的接口

* @param */

public interface ViewCreator{

//创建轮播图的每个项的View

View createView(Context context, int position);

//更新轮播图

void updateUI(Context context, View view, int position, T data);

}

createView方法的返回值是View而不是ImageView,所以CustomBanner可以支持轮播所有的布局,而不仅仅是ImageView,虽然我们大部分情况使用的都是ImageView。

如果你现在还不清楚ViewCreator是干什么的,那么请看下面的代码。下面是轮播图适配器BannerPagerAdapter的核心代码,通过这段代码,你应该就能很清晰的理解ViewCreator的作用了。

@Override

public Object instantiateItem(ViewGroup container, final int position) {

View view = views.get(position);

if (view == null) {

//mCreator就是调用者传入的ViewCreator对象

//通过mCreator创建轮播图的布局,所以轮播图的布局是由调用者创建的

view = mCreator.createView(mContext, position);

views.put(position, view);

}

final int item = getActualPosition(position);

final T t = mData.get(item);

//通过mCreator把更新轮播图数据的操作交给调用者去实现

mCreator.updateUI(mContext, view, item, t);

container.addView(view);

return view;

}

CustomBanner的实现思路和代码分析到这里就结束了。相信现在大家对于轮播图的实现已经有了一定的了解了。至于CustomBanner的使用,我将在下一章《Android轮播图控件CustomBanner的使用讲解》具体讲解,欢迎阅读。下面先给大家看一下CustomBanner的效果:

演示.gif

上面贴出来的代码只是CustomBanner的代码摘要,完整的代码请访问我在GitHub中的CustomBanner项目。

文章已同步到我的CSDN博客

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值