wenchaosong / banner Goto Github PK

View Code? Open in Web Editor NEW

533.0 8.0 72.0 20.54 MB

轮播图控件，支持自定义布局，支持两端缩进，类似卡片，支持无限循环和多种主题，可以灵活设置轮播样式、动画、轮播和切换时间、位置、图片加载框架等！

License: Apache License 2.0

Java 100.00%

banner viewpager

banner's Introduction

Android 图片轮播控件

图片轮播类似控件比较多,但是真正好用的比较少,大家公认的项目banner是比较好用的, 但是作者已经很久没维护了,所以我在他的基础上优化了一部分,满足大家项目中常用的一些需求.

具体优化点:
1.优化了自定义布局,不仅仅是一张图片;
2.优化了 onPageSelected 方法调用两次的 bug;
3.增加了多种 banner 样式

关于本库的优化点

目前存在一个优化点,就是实现原理上,为了兼容卡片模式,无限轮播的实现方式采用的是 adapter 的 count 取一个比较大的数值,这种方式其实我是不太想用的,另外一个实现方式是 count 总数加 2,这其实才是真正意义的无限轮播,在这里我也是搜集了各种 banner 的实现源码, 发现第二个方式总有瑕疵.具体就是:卡片模式滑动的时候,最后一张到第一张或者第一张到最后一张图片有个延迟的白边,造成的原因是调用的方法执行的比较慢,所以有个延迟(第二种方式可以参照 BannerNew.java 里面的代码)

所以在此希望大家有好的处理方式能提 pr,或者 issue,我会认真看,认真解决

有问题先看注意事项
有问题先看注意事项
有问题先看注意事项

效果图

apk 下载及动态展示

部分效果图

模式	图片
指示器模式
数字模式
数字加标题模式
标题模式
指示器加标题模式
卡片模式
自定义指示器模式
自定义混合模式
底部弧形模式
指示器在外部
右端缩进模式

使用步骤

Step 1.依赖banner

dependencies{
    implementation 'com.ms:banner:1.0.0'
    implementation 'com.github.wenchaosong:Banner:2.4.0'
}

或者引用本地lib

compile project(':rollbanner')

Step 2.在布局文件中添加Banner,可以设置自定义属性

<com.ms.banner.Banner
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/banner"
    android:layout_width="match_parent"
    android:layout_height="高度自己设置" />

Step 3.设置布局

.setPages(arrList, new CustomViewHolder())

class CustomViewHolder implements BannerViewHolder<String> {

    private CardView mCardView;
    private TextView mTextView;

    @Override
    public View createView(Context context) {
        View view = LayoutInflater.from(context).inflate(R.layout.banner_item, null);
        mCardView = (CardView) view.findViewById(R.id.group);
        mTextView = (TextView) view.findViewById(R.id.position);
        return view;
    }

    @Override
    public void onBind(Context context, int position, String data) {
        // 数据绑定
        mCardView.setCardBackgroundColor(Color.parseColor(data));
        mTextView.setText(position + "");
    }
}

Step 4.在Activity或者Fragment中配置Banner

注意！start()方法必须放到最后执行

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    Banner banner = (Banner) findViewById(R.id.banner);
    banner.setAutoPlay(true)
            .setPages(arrList, new CustomViewHolder())
            .start();
}

Step 5.（可选）

@Override
protected void onStart() {
    super.onStart();
    //开始轮播
    if (banner != null && banner.isPrepare() && !banner.isStart()) {
        banner.startAutoPlay();
    }
}

@Override
protected void onStop() {
    super.onStop();
    //结束轮播
    if (banner != null && banner.isPrepare() && banner.isStart()) {
        banner.stopAutoPlay();
    }
}

Step 6.混淆

-keep class com.ms.banner.** {*;}

注意事项

setCurrentPage 方法不建议调用,因为使用的是成员变量保存,除非再次初始化,否则每次初始化都会先显示设定位置的图片
有问题先参考 demo

另只要是 banner 中布局中可以定义的,都可以重写,包括但不限于指示器,图片,文字等.各个模式相应的代码 demo 中已经有了,可以作为参考,如果有问题可以提 issue

属性和方法介绍

xml 文件可配置的属性

属性	值	描述
delay_time	integer	轮播下一张图片的延迟时间
scroll_time	integer	滚动到下一张图片的时间
is_auto_play	boolean	是否自动轮播
is_loop	boolean	是否循环
title_background	color、reference	title 的背景
title_textcolor	color	title 的字体颜色
title_textsize	dimension	title 的字体大小
title_height	dimension	title 的高度
indicator_width	dimension	指示器的宽度
indicator_height	dimension	指示器的高度
indicator_margin	dimension	指示器到底部的距离
indicator_padding	dimension	指示器之间的间距
indicator_drawable_selected	reference	选中的指示器图片
indicator_drawable_unselected	reference	未选中的指示器图片
banner_default_image	reference	默认的图片
page_left_margin	dimension	左边缩进的距离
page_right_margin	dimension	右边缩进的距离
arc_height	dimension	底部弧形的高度
arc_start_color	reference	底部弧形的起始颜色
arc_end_color	reference	底部弧形的结束颜色
arc_direction	enum	底部弧形的方向

java 文件可调用的方法

setDelayTime                设置延迟时间
setAutoPlay                 设置是否自动轮播
setLoop                     设置是否循环
setIndicatorGravity         设置指示器位置
setBannerAnimation          设置滚动动画
setBannerTitles             设置 title 数据
setBannerStyle              设置样式
setViewPagerIsScroll        设置是否可以滚动
setPages                    设置数据源
setCurrentPage              设置当前页
update                      刷新
updateBannerStyle           刷新样式
start                       开始使用
isPrepare                   是否加载完成
isStart                     是否轮播中
setIndicatorRes             设置指示器资源
startAutoPlay               开始自动轮播
stopAutoPlay                停止轮播
setOnBannerClickListener    监听点击事件
setOnPageChangeListener     监听页面变化事件

banner's People

Contributors

Stargazers

Watchers

banner's Issues

关于卡片模式下只有一个Item时的优化

如果list只有一项，显示的时候左右都会多出一点，给人还有多余项目的错觉，所以在BannerPagerAdapter的getCount方法中最好做出如下判断：
@OverRide
public int getCount() {
if(mDatas.size() == 1){
return mDatas.size();
}else {
return mDatas.size() + 2;
}

这样就没有问题了。

可以自定义指示器的样式不？

可以自定义指示器的样式不？
例如我给定两个图片，一张普通的，一张是选中的

无法开放方法来获取当前的Postion或者CurrenPosition

性能问题

hello，无限轮播的时候，一直调用holder的createView，里面不断通过LayoutInflater填充生成View，这会有性能问题吧，感觉holder没起到复用的作用。

文档最好加上混淆规则

glide 的混淆代码

-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
**[] $VALUES;
public *;
}

banner 的混淆代码

-keep class com.ms.banner.** {
*;
}

setOnBannerClickListener

setOnBannerClickListener 有时无效

如果原来有数据，后来update size 为0 时会报错

目前我是放一个size为1的数据

 “”

The layout is not specified,please set holder

不设置holder的时候，可以有个默认的

指示器为数字时出现数组下标越界

在 Banner 类中的 onPageSelected(int position) 函数中，与 youth5201314 的比较少了一下两行
...
if (position == 0) position = count;
if (position > count) position = 1;
...
导致出现数组下标越界

修改绘制顺序问题

你好，多屏显示的时候，我想修改viewpager的绘制顺序已到达中间的卡片是显示在两侧卡片之上，但是BannerViewPager中的getCurrentItem()返回2000多

建议哈，没有其他意思，能不能动态设置卡片模式左右展示部分的高度

自己改库改的很难受
this.setOnHierarchyChangeListener(new OnHierarchyChangeListener() {
@OverRide
public void onChildViewAdded(View parent, View child) {
child.setScaleY(minScale);
child.setAlpha(minAlpha);
}

        @Override
        public void onChildViewRemoved(View parent, View child) {
        }
    });

图片消失

我现在tab+viewpager+fragment，第一个tab下顶部有banner（本框架），然后我一直切换tab项，再切换回第一个tab，banner里的轮播图会消失

compile 一直失败

卡片模式，不设置动画，如何设置卡片的两边的边距

依赖报错

ERROR: Failed to resolve: com.github.wenchaosong:Banner:2.3.7
Show in Project Structure dialog
Affected Modules: app

没有设置圆形图，还是显示圆形图片是怎么搞得啊

fragment中使用时，切换到其他页面，过一段时间再切换回来

页面中的banner图不显示了，刷新也没用，不知道是fragment的问题，还是banner的bug

【建议】实现LifecycleObserver

在Banner中实现LifecycleObserver接口，这样的话使用AppCompatActivity就不需要手动在onResume和onPause中去satr和stop了。只需要lifecycle.addObserver(banner)
代码

class MyBanner : Banner, LifecycleObserver {
    constructor(context: Context?) : super(context)
    constructor(context: Context?, attrs: AttributeSet?) : super(context, attrs)

    @OnLifecycleEvent(Lifecycle.Event.ON_RESUME)
    fun onResume() {
        startAutoPlay()
    }

    @OnLifecycleEvent(Lifecycle.Event.ON_PAUSE)
    fun onPause() {
        stopAutoPlay()
    }

}

在RecyclerView中下拉刷新会报错

在RecyclerView中下拉刷新会报错
错误如下：
java.lang.IllegalStateException: The application's PagerAdapter changed the adapter's contents without calling PagerAdapter#notifyDataSetChanged! Expected adapter item count: 1000, found: 0 Pager id: cn.zhouheiya.app:id/bannerViewPager Pager class: class com.ms.banner.view.BannerViewPager Problematic adapter: class com.ms.banner.Banner$BannerPagerAdapter
at android.support.v4.view.ViewPager.populate(ViewPager.java:1135)
at android.support.v4.view.ViewPager.populate(ViewPager.java:1084)
at android.support.v4.view.ViewPager$3.run(ViewPager.java:267)
at android.view.Choreographer$CallbackRecord.run(Choreographer.java:1065)
at android.view.Choreographer.doCallbacks(Choreographer.java:877)
at android.view.Choreographer.doFrame(Choreographer.java:805)
at android.view.Choreographer$FrameDisplayEventReceiver.run(Choreographer.java:1051)
at android.os.Handler.handleCallback(Handler.java:873)
at android.os.Handler.dispatchMessage(Handler.java:99)
at android.os.Looper.loop(Looper.java:201)
at android.app.ActivityThread.main(ActivityThread.java:6806)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:522)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:873)

我是这样使用的

求指教啊大佬

BannerViewPager的onAttachedToWindow()方法出现多次异常

java.lang.IllegalStateException

The application's PagerAdapter changed the adapter's contents without calling PagerAdapter#notifyDataSetChanged! Expected adapter item count: 7, found: 2 Pager id: xxx.xxx.xxx:id/bannerViewPager Pager class: class com.ms.banner.view.BannerViewPager Problematic adapter: class com.ms.banner.Banner$BannerPagerAdapter

banner引入xml布局里面报错

包名都写对了，也跟着步骤来了。
Caused by: android.view.InflateException: Binary XML file line #139: Error inflating class com.ms.banner.Banner

指示器的数量虽然等于图片数量，但是在轮播的时候指示器只切换前三个

小哥麻烦加个QQ：1260321778

求教最后一个demo图片的效果指示器怎么弄呢？文档和demo和代码里都没找到

轮播recycleView,默认先显示的是posiion1 不是0

如题:
List<List> splitList = CollectionUtils.getSplitList(strings, 8);
bannerPingpai.setBannerStyle(BannerConfig.NOT_INDICATOR);
bannerPingpai.setOnPageChangeListener(new ViewPager.OnPageChangeListener() {
@OverRide
public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {

        }

        @Override
        public void onPageSelected(int position) {
            ToastUitl.showShort(position + "");
        }

        @Override
        public void onPageScrollStateChanged(int state) {

        }
    });
    bannerPingpai.setPages(splitList, new HolderCreator<BannerViewHolder>() {
        @Override
        public BannerViewHolder createViewHolder() {
            return new CustomViewHolder();
        }
    }).start();

class CustomViewHolder implements BannerViewHolder<List> {

    @BindView(R.id.recyclerView)
    RecyclerView mRecyclerView;


    @Override
    public View createView(Context context) {
        View view = LayoutInflater.from(context).inflate(R.layout.item_wholesale_pingpai_layout, null);
        ButterKnife.bind(this, view);
        return view;
    }

    @Override
    public void onBind(Context context, int position, List<String> data) {
        /**/ 数据绑定,这里先加载的是大list的第二个元素**
        PingPaiHotAdapter mPingPaiHotAdapter = new PingPaiHotAdapter(data);
        mRecyclerView.setLayoutManager(new GridLayoutManager(getContext(), 4));
        mRecyclerView.setAdapter(mPingPaiHotAdapter);
        mPingPaiHotAdapter.setOnItemClickListener(new BaseQuickAdapter.OnItemClickListener() {
            @Override
            public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
                String item = mPingPaiHotAdapter.getItem(position);
                ToastUitl.showShort(item);
            }
        });
    }
}