Android自定义图片轮播Banner控件使用解析

时间:2021-07-29 13:58:52

图片轮播控件,可以说是每个App基本上都会用到的。它可以用来动态的展示多个图片,之前写过两篇博客:实现ViewPager无限循环的方式一实现ViewPager无限循环的方式二,在这两篇博客中,分析了两种实现ViewPager无限循环的原理,但是在使用的过程中,代码的解偶性很低,所以就使用自定义View的方式,实现无限循环的图片轮播的封装。

先看看效果:

Android自定义图片轮播Banner控件使用解析

功能特点

  1. 支持自定义宽高比例
  2. 支持自定义图片切换时间
  3. 支持自定义指示点的颜色
  4. 支持自定义指示点的背景色
  5. 支持自定义指示点的高度
  6. 支持是否显示指示点
  7. 支持每个图片设置不同的点击事件

使用简单

?
1
2
3
4
5
6
7
8
9
10
<com.xiaomai.bannerview.BannerView
   android:id="@+id/bannerView"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   app:aspectRatio="1.5"
   app:defaultSrc="@mipmap/ic_launcher"
   app:indicatorBackground="@color/white"
   app:indicatorHeight="50dp"
   app:indicatorPositionSize="8dp"
   app:updateTime="3000" />

实现步骤

  • 声明自定义的属性
  • 创建一个类继承RelativeLayout
  • 解析属性

声明自定义的属性

在values/attrs文件中创建自定义的属性

?
1
2
3
4
5
6
7
8
9
10
11
12
13
<resources>
 
  <declare-styleable name="BannerView">
    <attr name="aspectRatio" format="float" />  <!-- 宽高比 -->
    <attr name="defaultSrc" format="integer|reference" />   <!-- 占位图 -->
    <attr name="updateTime" format="integer" />   <!-- 图片切换时间 -->
    <attr name="indicatorVisible" format="boolean" /> <!-- 是否显示指示器 -->
    <attr name="indicatorHeight" format="dimension" /> <!-- 指示器的高度 -->
    <attr name="indicatorBackground" format="color|reference" />  <!-- 指示器的背景颜色 -->
    <attr name="indicatorPositionSize" format="dimension" /> <!-- 指示点的大小 -->
  </declare-styleable>
 
</resources>

创建BannerView类

?
1
2
3
4
5
6
7
8
9
10
11
12
public class BannerView extends RelativeLayout {
 
  public BannerView(Context context) {
    this(context, null);
  }
 
  public BannerView(Context context, AttributeSet attrs) {
    this(context, attrs, 0);
  }
 
  public BannerView(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);}

在BannerView中声明变量属性

 

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
private Context context;
 
  private Handler handler;
  private ImageLoader imageLoader;
  private DisplayImageOptions options;
  private boolean isHaveHandler = true;// 当用户点击轮播图时,取消handler队列,也就是取消滚动
  // 控件Start
  private ViewPager viewPager;
  private LinearLayout indicator;// 指示器
  private onItemClickListener listener;
  // 控件End
 
  // 自定义属性Start
  private float mAspectRatio; // 宽高比
  private int defaultImageResource; // 默认占位图
  private int updateTime; // 图片切换的时间间隔,默认3秒
  private boolean showIndicator; // 是否显示指示器,默认显示
  private int indicatorHeight;// 指示器的高度,默认35dp
  private int indicatorPositionSize; // 指示器的大小
  private int indicatorBackground; // 指示器的背景颜色
  // 自定义属性End
  // 数据Start
  private int imageCount;
  private int lastPosition;
 
  private List<Integer> imageResources;
  private List<Image> imageUrls;
  // 数据End

解析自定义属性的值

接下来为自定义的属性赋值,在3个参数的构造方法中初始化变量。

 

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
public BannerView(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);
    parseCustomAttributes(context, attrs);
    this.context = context;
    handler = new Handler();
    imageLoader = ImageLoader.getInstance();
    options = HSApplication.getDisplayOptions().build();
    initViews();
  }
  /**
   * 解析自定义属性
   *
   * @param context
   * @param attrs
   */
  private void parseCustomAttributes(Context context, AttributeSet attrs) {
    TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.BannerView);
    mAspectRatio = typedArray.getFloat(R.styleable.BannerView_aspectRatio, 0f);
    defaultImageResource = typedArray.getResourceId(R.styleable.BannerView_defaultSrc,
        R.drawable.about_us);
    updateTime = typedArray.getInt(R.styleable.BannerView_updateTime, 3000);
    showIndicator = typedArray.getBoolean(R.styleable.BannerView_indicatorVisible, true);
    indicatorHeight = (int) (typedArray.getDimension(R.styleable.BannerView_indicatorHeight,
        Utils.dip2px(context, 35)));
    indicatorBackground = typedArray.getResourceId(R.styleable.BannerView_indicatorBackground,
        R.color.white_alpha00);
    indicatorPositionSize = (int) typedArray.getDimension(
        R.styleable.BannerView_indicatorPositionSize, Utils.dip2px(context, 5));
    typedArray.recycle();
  }
  private void initViews() {
    viewPager = new ViewPager(context);
    viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
      @Override
      public void onPageScrolled(int position, float positionOffset,
          int positionOffsetPixels) {
 
      }
 
      @Override
      public void onPageSelected(int position) {
        if (showIndicator) {
          for (int i = 0; i < indicator.getChildCount(); i++) {
            indicator.getChildAt(i).setSelected(false);
          }
          indicator.getChildAt(position % imageCount).setSelected(true);
        }
        lastPosition = position;
      }
 
      @Override
      public void onPageScrollStateChanged(int state) {
        switch (state) {
          case ViewPager.SCROLL_STATE_IDLE:// 空闲状态
            if (!isHaveHandler) {
              isHaveHandler = true;
              handler.postDelayed(updateRunnable, updateTime);
            }
            break;
          case ViewPager.SCROLL_STATE_DRAGGING:// 用户滑动状态
            handler.removeCallbacks(updateRunnable);
            isHaveHandler = false;
            break;
        }
      }
    });
    addView(viewPager, new LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
        ViewGroup.LayoutParams.WRAP_CONTENT));
 
    if (showIndicator) {
      indicator = new LinearLayout(context);
      indicator.setOrientation(LinearLayout.HORIZONTAL);
      indicator.setGravity(Gravity.CENTER);
      indicator.setBackgroundResource(indicatorBackground);
      RelativeLayout.LayoutParams layoutParams = new LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT, indicatorHeight);
      layoutParams.addRule(ALIGN_PARENT_BOTTOM);
      addView(indicator, layoutParams);
    }
}

控件和自定义的属性都经过赋值和初始化了,接下来,该为设置图片资源了。

 

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
public void setImageResources(List<Integer> imageResources) {
    if (imageResources == null || imageResources.size() == 0) {
      throw new RuntimeException("图片资源为空");
    }
    this.imageResources = imageResources;
    imageCount = imageResources.size();
  }
 
  public void setImageUrls(List<Image> imageUrls) {
    if (imageUrls == null || imageUrls.size() == 0) {
      throw new RuntimeException("图片地址资源为空");
    }
    this.imageUrls = imageUrls;
    imageCount = imageUrls.size();
    loadImages();
  }
 
  private void loadImages() {
    if (showIndicator) {
      addIndicationPoint();
    }
    viewPager.setAdapter(new MyViewPageAdapter());
    viewPager.setCurrentItem(200 - (200 % imageCount));
    handler.removeCallbacks(updateRunnable);
    handler.postDelayed(updateRunnable, updateTime);
  }
 
  /**
   * 添加指示点到指示器中
   */
  private void addIndicationPoint() {
    // 防止刷新重复添加
    if (indicator.getChildCount() > 0) {
      indicator.removeAllViews();
    }
    View pointView;
    int margin = Utils.dip2px(context, 5f);
    LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(
        indicatorPositionSize, indicatorPositionSize);
    layoutParams.setMargins(margin, margin, margin, margin);
 
    for (int i = 0; i < imageCount; i++) {
      pointView = new View(context);
      pointView.setBackgroundResource(R.drawable.indicator_selector);
      if (i == lastPosition) {
        pointView.setSelected(true);
      } else {
        pointView.setSelected(false);
      }
      indicator.addView(pointView, layoutParams);
    }
  }
 
  private class MyViewPageAdapter extends PagerAdapter {
    @Override
    public int getCount() {
      return Integer.MAX_VALUE;
    }
 
    @Override
    public boolean isViewFromObject(View view, Object object) {
      return view == object;
    }
 
    @Override
    public Object instantiateItem(ViewGroup container, final int position) {
      final ImageView imageView = new ImageView(container.getContext());
      imageView.setImageResource(defaultImageResource);
      imageView.setScaleType(ImageView.ScaleType.FIT_XY);
      final Image image = imageUrls.get(position % imageCount);
      imageLoader.displayImage(image.getImageUrl(), imageView, options);
      imageView.setOnClickListener(new OnClickListener() {
        @Override
        public void onClick(View v) {
          if (listener != null) {
            listener.onClick(v, position % imageCount, image.getAction(),
                image.getUrl());
          }
        }
      });
      container.addView(imageView);
      return imageView;
    }
 
    @Override
    public void destroyItem(ViewGroup container, int position, Object object) {
      container.removeView((View) object);
    }
  }
 
  private Runnable updateRunnable = new Runnable() {
    @Override
    public void run() {
      viewPager.setCurrentItem(lastPosition + 1);
      handler.postDelayed(updateRunnable, updateTime);
    }
 
/**
   * 点击监听回调事件
   */
  public interface onItemClickListener {
    void onClick(View view, int position, String action, String url);
  }
 
  public void setOnItemClickListener(onItemClickListener listener) {
    this.listener = listener;
  }

时间太仓促,解释的不是太详细,可以移步我的GitHub查看完整代码。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:https://blog.csdn.net/xiaomai949804781/article/details/53187165