android github轮播图,GitHub - ZTJzzz/Banner: Android轮播图

Android轮播图 - Banner

纵观Android古今，轮播图已然泛滥成灾！大神们各显神通大兴土木，所起楼台之高让后来者心生膜拜,纷纷Star！但不法分子也是层出不穷，为求"大神"的桂冠，挂羊头卖狗肉，一个镜像就试图去名满天下，鄙人正是此等不法分子！虽有点盗窃youth5201314前辈的劳动成果，但也算是实实在在在前辈的肩膀上干了点实在事——帮前辈梳了梳头，整理了一下发型。毕竟盲仔说过：头可断，发型不能乱。但是在下还是得由衷感谢youth5201314前辈，您造的法拉利我至少给您保养了一番！

功能特点

支持一屏三页

支持任意View显示在Banner上

支持自定义显示器

支持多种Banner动画

支持仿魅族Banner

空数据、两条数据优化处理

创建的View内部已做缓存，性能更佳

一句话：更加精简，更加智能，更加好用！！！

有图有真相

新增仿魅族Banner

简单用法

1.添加依赖：

1.1 工程的build.gradle下添加：

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

1.2 模块的build.gradle下添加：

implementation 'com.github.AlpsDog:Banner:v1.0.6'

如果你的项目为: AndroidX

请在 gradle.properties 中添加：(如果已经添加请忽略)

android.useAndroidX=true

android.enableJetifier=true

2.XML布局文件

android:id="@+id/banner"

android:layout_width="match_parent"

android:layout_height="200dp"

android:layout_marginTop="20dp"

app:banner_auto_play="true"

app:banner_default_image="@drawable/banner_default"

app:banner_expose_width="20dp"

app:banner_interval_time="5000"

app:banner_multi_anim="ScaleIn"

app:banner_page_spacing="14dp"

app:banner_scroll_time="1000"

app:banner_show_indicator="true"

app:banner_show_model="Multi"

app:layout_scrollFlags="scroll" />

3.在Activity/Fragment中

// 1. 创建设置BannerLoader

banner.setBannerLoader(new ImageLoader() {

@Override

public void loadView(Context context, BannerEntry entry, int position, View imageView) {

RequestOptions requestOptions = new RequestOptions()

.placeholder(R.drawable.banner_default)

.error(R.drawable.banner_default)

.diskCacheStrategy(DiskCacheStrategy.AUTOMATIC);

Glide.with(context).load(entry.getBannerPath()).apply(requestOptions).into((ImageView) imageView);

}

});

// 2 设置页面点击事件

banner.setOnBannerClickListener(new Banner.OnBannerClickListener() {

@Override

public void onBannerClick(int position) {

Toast.makeText(BaseUseActivity.this, "点击了：" + position, Toast.LENGTH_SHORT).show();

}

});

// 3 翻页事件

banner.setBannerPagerChangedListener(new Banner.OnBannerSimplePagerListener() {

@Override

public void onPageSelected(int position) {

Log.d("hsl777", "onPageSelected: ==>" + position);

}

});

// 4 最重要一步，加载数据

banner.loadImagePaths(mData);

非常重要之处

此处添加可以优化Banner体验

但是一旦启用自动轮播，必须调用 banner.stopAutoPlay();

可以在onResume()、也可以在onDestory(),

这样才能确保轮播任务停止

防止内存泄漏

@Override

protected void onResume() {

super.onResume();

banner.startAutoPlay();

}

@Override

protected void onPause() {

super.onPause();

banner.stopAutoPlay();

}

4.数据源说明

// Banner内部定义的数据接口

public interface BannerEntry {

/**

* 获取Banner数据源

*

* @return

*/

T getBannerPath();

/**

* 获取指示器文本

*

* @return

*/

String getIndicatorText();

}

// 实体类继承此接口

// getBannerPath()返回图片加载的源

// getIndicatorText()返回Banner摘要,非必须

public class BannerItem implements BannerEntry {

private Object path;

private String indicatorText;

public BannerItem() {

}

public BannerItem(Object path, String indicatorText) {

this.path = path;

this.indicatorText = indicatorText;

}

@Override

public Object getBannerPath() {

//此处返回图片加载的源，可以是 URL RES FILE...

return path;

}

@Override

public String getIndicatorText() {

//此处返回Banner摘要,非必须

return indicatorText;

}

public Object getPath() {

return path;

}

public void setPath(Object path) {

this.path = path;

}

public void setIndicatorText(String indicatorText) {

this.indicatorText = indicatorText;

}

}

5.加载器说明

//自定义Banner显示的View时，可用此加载器

public interface BannerLoader {

/**

* 加载VIEW

*

* @param context

* @param entry

* @param position 显示的位置

* @param imageView

*/

void loadView(Context context, BannerEntry entry, int position, V imageView);

/**

* 创建View

*

* @param context

* @param position

* @return

*/

V createView(Context context, int position);

}

//简化版加载器

public abstract class ImageLoader implements BannerLoader {

@Override

public ImageView createView(Context context, int position) {

ImageView imageView = new ImageView(context);

imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);

return imageView;

}

}

//关于怎样自定义Banner显示的View，可参考Demo

6.自定义属性说明

banner_auto_play : 能否自动轮播

banner_show_model : 显示模式(一屏一页、一屏三页、仿魅族Banner)

banner_interval_time : 轮播间隔

banner_scroll_time : 翻页时长(决定翻页的速度)

banner_single_anim : 一屏一页动画

banner_default_image : 数据为空时，默认显示图

banner_expose_width : 一屏三页，左右两页露出的宽度

banner_page_spacing : 一屏三页，页间距

banner_multi_anim : 一屏三页动画

banner_mz_overlap : 仿魅族Banner时，中间Page压着左右两边page的宽度

banner_mz_anim : 仿魅族Banner动画

banner_show_indicator : 是否显示指示器

indicator_select_width : 选中的指示器宽度

indicator_select_height : 选中的指示器高度

indicator_default_width : 未选中指示器宽度

indicator_default_height : 未选中指示器高度

indicator_space : 指示器间隔

indicator_margin_bottom : 指示器距底部距离

indicator_select_drawable : 指示器选中的样式

indicator_default_drawable : 指示器未选中样式

版本说明

v1.0.6正式版

1.修复一张图刷新为多张图是时，显示问题

2.修复多张图刷为一张图时，崩溃问题

v1.0.4正式版

1.修复一张图时，使用glide崩溃问题

v1.0.3正式版

1.空数据优化

2.频繁刷新优化

v1.0.2正式版

新增仿魅族Banner

v1.0.1正式版

1.对内部结构进行了优化

2.增加数据源接口，规范使用

V1.0.0正式版

1.轮播图使用示例

2.轮播图LIB源码

鸣谢

感谢张鸿洋大师的ViewPager一屏三页动画

感谢大家对鄙人的支持