RxBanner

[停止维护]

一个灵活可制定的基于 Recyclerview 的轮播图控件,支持自动轮播,无限循环。

同时可关闭无限循环变成 引导页 ，带有引导完成接口回调,详见demo

中文文档   English

更新日志

1.1.3

1.完善一些点击事件的逻辑

2.新增当 rb_canSwipe = false 时的点击事件响应

3.修复 自定义指示器 刷新数据时没有默认选中的问题

1.1.2

1.新增 引导页 监听 RxBannerGuideFinishedListener ,调整引导页功能实现

2.新增单张图片时可否滑动设置 rb_canSwipeWhenSingle, 仅单张图片时有效

1.1.1

1.新增滑动阻尼设置 rb_flingDamping, 阻尼越大滑动越困难,默认为RecyclerView标准最小滑动值. 修复 issues #2

2.新增自定义指示器,用法与说明请下翻至 指示器 部分, 由 CircleIndicator 修改整合,感谢原作者, 原始需求 issues #3

Demo Apk

fir.im      rxbanner_demo.apk

github      rxbanner_demo.apk

预览

引用

1.添加 jitpack

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

2.导入引用    

    implementation 'com.github.leveychen:RxBanner:1.1.4'

LATEST RELEASE

依赖出错问题

由于本项目采用28.0.0-rc02的版本编译，28以下版本可能会出现依赖失败的情况，处理办法如下：

在 app.gradle 最下面添加

configurations.all {
    resolutionStrategy.eachDependency { DependencyResolveDetails details ->
        def requested = details.requested
        if (requested.group == 'com.android.support') {
            if (!requested.name.startsWith("multidex")) {
                //这里指定需要统一的依赖版本,这里统一为27.1.1，这里以27.1.1为例
                details.useVersion '27.1.1'
            }
        }
    }
}

强制使用你的主项目的编译版本

用法

layout

see Attributes

    <cn.levey.bannerlib.RxBanner
        android:id="@+id/rx_banner"
        android:layout_width="match_parent"
        android:layout_height="160dp"/>

java

    banner = findViewById(R.id.rx_banner);
    banner
        .setLoader(new ImageLoader())               // see `image loader`
        .setConfig(config)                          // see `config`
        .setDatas(iamgesUrls, titles)
        .start();

一些 image loader 的栗子

Fresco     Glide     Picasso     UniversalImageLoader

可以愉快的玩耍了,下面是一些可选内容

配置信息 -可选

自定义配置信息，所有参数设置均和 xml 布局里一致，优先级高于 xml 布局文件

    RxBannerConfig config = banner.getConfig();
    config.set(value);
    ...
    banner.setConfig(config);
    banner.start();

setConfig() 必须在 setDatas() 和 start() 之前设置。

监听器 -可选

    点击图片时的回调
    banner.setOnBannerClickListener(new RxBannerClickListener())
        onItemClick(int position, Object data)
        onItemLongClick(int position, Object data)

    //点击标题时的回调
    banner.setOnBannerTitleClickListener(new RxBannerTitleClickListener())
        onTitleClick(int position, String title);

    //图片切换时的回调
    banner.setOnBannerChangeListener(new RxBannerChangeListener())
        onBannerSelected(int position)
        onBannerScrollStateChanged(int state)

    //一旦定义引导页监听就可变成引导页
    banner.setOnGuideFinishedListener(new RxBannerGuideFinishedListener()
        onGuideFinished()

生命周期

更好的 在 Activity 、 Fragment 和其他 view 中管理生命周期

    banner.onResume()
    banner.onPause()
    banner.onDestroy()

全局设置 -可选

    RxBannerConfig
        .getInstance()
        .setDebug(true)  // debug: default false
        .setScrollStateChangedListener(new RxBannerScrollStateChangedListener()
        .setLoader(new RxBannerImageViewLoader())
        .setOrientation(LinearLayout.HORIZONTAL)
        .setOrderType(RxBannerConfig.OrderType.ASC)
        .setTimeInterval(5000);

引导页

定义一下布局就行了

activity_guide.xml

为了更好的引导页体验,最好关闭无限循环和自动轮播

    banner:rb_infinite="false"
    banner:rb_autoPlay="false"

然后监听一下回调

    banner.setOnGuideFinishedListener(new RxBannerGuideFinishedListener()
        onGuideFinished()
        // todo

大功告成

属性

所有属性均以 rb_ 开头

Banner

标题

指示器

AnimationType

这里抄的，了解一下 PageIndicatorView / CircleIndicator

名称	属性	预览
AnimationType.NONE	none
AnimationType.COLOR	color
AnimationType.SCALE	scale
AnimationType.SCALE_DOWN	scale_down
AnimationType.SLIDE	slide
AnimationType.WORM	worm
AnimationType.FILL	fill
AnimationType.THIN_WORM	thin_worm
AnimationType.DROP	drop
AnimationType.SWAP	swap
AnimationType.NUMERIC	numeric	1/8
AnimationType.NUMERIC_CIRCLE	numeric_circle	(1/8)
AnimationType.CUSTOM	custom	参考 CircleIndicator

权限

显示网络图片

    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

混淆

    -keep class cn.levey.bannerlib.** {
        *;
    }

Release Note

See release notes on Github Releases

Thanks

ViewPagerLayoutManager PageIndicatorView CircleIndicator

License

Apache-2.0. See LICENSE for detail