Android----banner使用详解

Android----banner使用详解

昨天10.31 ,斗破苍穹的三年之约终于出来了,自己也等了很久很久,敬师长,敬家人,敬朋友,敬每一个前行路上正在奋战的自己,星光不问赶路人,时间不负有心人。

效果图:

  1. 添加依赖

      implementation 'com.youth.banner:banner:2.1.0'
    
  2. 添加权限到你的 AndroidManifest.xml

    
     
    
  3. 布局文件

    
    
  4. 逻辑代码

    package com.hnucm.xiaotang;
    
    import android.os.Bundle;
    
    import androidx.fragment.app.Fragment;
    
    import android.util.Log;
    import android.view.LayoutInflater;
    import android.view.View;
    import android.view.ViewGroup;
    
    
    import com.bumptech.glide.Glide;
    import com.bumptech.glide.load.resource.bitmap.RoundedCorners;
    import com.bumptech.glide.request.RequestOptions;
    import com.youth.banner.Banner;
    import com.youth.banner.adapter.BannerImageAdapter;
    import com.youth.banner.holder.BannerImageHolder;
    import com.youth.banner.indicator.CircleIndicator;
    import com.youth.banner.listener.OnBannerListener;
    
    import org.json.JSONArray;
    import org.json.JSONException;
    import org.xutils.common.Callback;
    import org.xutils.http.RequestParams;
    import org.xutils.x;
    
    import java.util.ArrayList;
    import java.util.List;
    
    
    public class ShouYeFragment extends Fragment implements OnBannerListener {
    
    
        @Override
        public View onCreateView(LayoutInflater inflater, ViewGroup container,
                                 Bundle savedInstanceState) {
            View inflate = inflater.inflate(R.layout.fragment_shou_ye, container, false);
            Banner banner =inflate.findViewById(R.id.banner);
            List<String> imgList = new ArrayList<>();
    
            x.Ext.init(getActivity().getApplication());
            x.Ext.setDebug(BuildConfig.DEBUG);  // 是否输出debug日志, 开启debug会影响性能.
            x.view().inject(getActivity());  //没有用到view注解可以先不用
    
            imgList.add("https://cdn.jsdelivr.net/gh/Yqifei/Blog-Image@master/20211026/image.6719h9mvs700.png");
            imgList.add("https://cdn.jsdelivr.net/gh/Yqifei/Blog-Image@master/20211031/800-(11).2txrpbqztva0.jpg");
            imgList.add("https://cdn.jsdelivr.net/gh/Yqifei/Blog-Image@master/20211031/800-(5).5s6zwxy19v40.jpg");
            imgList.add("https://cdn.jsdelivr.net/gh/Yqifei/Blog-Image@master/20211031/800-(10).24p8puxcmqbk.jpg");
            imgList.add("https://cdn.jsdelivr.net/gh/Yqifei/Blog-Image@master/20211031/800-(14).pizaxijh534.jpg");
    
            RequestParams params = new RequestParams("https://www.fastmock.site/mock/08392ee207964eb010bf22b157103494/androidJavaEE/banner");
            x.http().get(params, new Callback.CommonCallback<String>() {
                @Override
                public void onSuccess(String result) {
                    try {
                        JSONArray jsonArray = new JSONArray(result);
                        for (int i=0;i<jsonArray.length();i++){
                            imgList.add((String)jsonArray.get(i));
                        }
                        banner.setDatas(imgList);    //  动态更新banner数据
                    } catch (JSONException e) {
                        e.printStackTrace();
                    }
    
                }
                @Override
                public void onError(Throwable ex, boolean isOnCallback) {
                }
                @Override
                public void onCancelled(CancelledException cex) {
                }
                @Override
                public void onFinished() {
                }
            });
    
    
            banner.setAdapter(new BannerImageAdapter<String>(imgList) {
    
                @Override
                public void onBindView(BannerImageHolder holder, String data, int position, int size) {
                    System.out.println("hello TEST");
                    Glide.with(holder.itemView)
                            .load(data)
                            .apply(RequestOptions.bitmapTransform(new RoundedCorners(30)))
                            .into(holder.imageView);
                }
    
            }).setIndicator(new 				                      CircleIndicator(getContext())).setLoopTime(1000).setOnBannerListener(this);
            //  设置圆形指示点,设置循环时间,设置监听器
            return inflate;
        }
    
        @Override
        public void OnBannerClick(Object data, int position) {   //  监听每一个图片的点击事件
            Log.i("tag", "你点了第"+position+"张轮播图");
        }
    }
    
  5. 常见的一些属性设置

    方法

    更多方法以实际使用为准,下面不一定全部列出了

    方法名 返回类型 描述
    getAdapter() extends BannerAdapter 获取你设置的BannerAdapter
    getViewPager2() ViewPager2 获取ViewPager2
    getIndicator() Indicator 获取你设置的指示器(没有设置直接获取会抛异常哦)
    getIndicatorConfig() IndicatorConfig 获取你设置的指示器配置信息(没有设置直接获取会抛异常哦)
    getRealCount() int 返回banner真实总数
    setUserInputEnabled(boolean) this 禁止手动滑动Banner;true 允许,false 禁止
    setDatas(List) this 重新设置banner数据
    isAutoLoop(boolean) this 是否允许自动轮播
    setLoopTime(long) this 设置轮播间隔时间(默认3000毫秒)
    setScrollTime(long) this 设置轮播滑动的时间(默认800毫秒)
    start() this 开始轮播(主要配合生命周期使用),或者你手动暂停再次启动
    stop() this 停止轮播(主要配合生命周期使用),或者你需要手动暂停
    setAdapter(T extends BannerAdapter) this 设置banner的适配器
    setAdapter(T extends BannerAdapter,boolean) this 设置banner的适配器,是否支持无限循环
    setOrientation(@Orientation) this 设置banner轮播方向(垂直or水平)
    setOnBannerListener(this) this 设置点击事件,下标是从0开始
    addOnPageChangeListener(this) this 添加viewpager2的滑动监听
    setPageTransformer(PageTransformer) this 设置viewpager的切换效果
    addPageTransformer(PageTransformer) this 添加viewpager的切换效果(可以设置多个)
    setIndicator(Indicator) this 设置banner轮播指示器(提供有base和接口,可以自定义)
    setIndicator(Indicator,boolean) this 设置指示器(传false代表不将指示器添加到banner上,配合布局文件,可以自我发挥)
    setIndicatorSelectedColor(@ColorInt) this 设置指示器选中颜色
    setIndicatorSelectedColorRes(@ColorRes) this 设置指示器选中颜色
    setIndicatorNormalColor(@ColorInt) this 设置指示器默认颜色
    setIndicatorNormalColorRes(@ColorRes) this 设置指示器默认颜色
    setIndicatorGravity(@IndicatorConfig.Direction) this 设置指示器位置(左,中,右)
    setIndicatorSpace(int) this 设置指示器之间的间距
    setIndicatorMargins(IndicatorConfig.Margins) this 设置指示器的Margins
    setIndicatorWidth(int,int) this 设置指示器选中和未选中的宽度,直接影响绘制指示器的大小
    setIndicatorNormalWidth(int) this 设置指示器未选中的宽度
    setIndicatorSelectedWidth(int) this 设置指示器选中的宽度
    setIndicatorRadius(int) this 设置指示器圆角,不要圆角可以设置为0
    setIndicatorHeight(int) this 设置指示器高度
    setBannerRound(float) this 设置banner圆角(还有一种setBannerRound2方法,需要5.0以上)
    setBannerGalleryEffect(int,int,float) this 画廊效果
    setBannerGalleryMZ(int,float) this 魅族效果
    setStartPosition(int) this 设置开始的位置 (需要在setAdapter或者setDatas之前调用才有效哦)
    setIndicatorPageChange() this 设置指示器改变监听 (一般是为了配合数据操作使用,看情况自己发挥)
    setCurrentItem() this 设置当前位置,和原生使用效果一样
    addBannerLifecycleObserver() this 给banner添加生命周期观察者,内部自动管理banner的生命周期

    Attributes属性

    在banner布局文件中调用,如果你自定义了indicator请做好兼容处理。 下面的属性并不是每个指示器都用得到,所以使用时要注意!

    Attributes format describe
    banner_loop_time integer 轮播间隔时间,默认3000
    banner_auto_loop boolean 是否自动轮播,默认true
    banner_infinite_loop boolean 是否支持无限循环(即首尾直接过渡),默认true
    banner_orientation enum 轮播方向:horizontal(默认) or vertical
    banner_radius dimension banner圆角半径,默认0(不绘制圆角)
    banner_indicator_normal_width dimension 指示器默认的宽度,默认5dp (对RoundLinesIndicator无效)
    banner_indicator_selected_width dimension 指示器选中的宽度,默认7dp
    banner_indicator_normal_color color 指示器默认颜色,默认0x88ffffff
    banner_indicator_selected_color color 指示器选中颜色,默认0x88000000
    banner_indicator_space dimension 指示器之间的间距,默认5dp (对RoundLinesIndicator无效)
    banner_indicator_gravity dimension 指示器位置,默认center
    banner_indicator_margin dimension 指示器的margin,默认5dp,不能和下面的同时使用
    banner_indicator_marginLeft dimension 指示器左边的margin
    banner_indicator_marginTop dimension 指示器上边的margin
    banner_indicator_marginRight dimension 指示器右边的margin
    banner_indicator_marginBottom dimension 指示器下边的margin
    banner_indicator_height dimension 指示器高度(对CircleIndicator无效)
    banner_indicator_radius dimension 指示器圆角(对CircleIndicator无效)
    banner_round_top_left boolean 设置要绘制的banner圆角方向(如果都不设置默认全部)
    banner_round_top_right boolean 设置要绘制的banner圆角方向(如果都不设置默认全部)
    banner_round_bottom_left boolean 设置要绘制的banner圆角方向(如果都不设置默认全部)
    banner_round_bottom_right boolean 设置要绘制的banner圆角方向(如果都不设置默认全部)
  6. github官网: GitHub - youth5201314/banner: Banner 2.0 来了!Android广告图片轮播控件,内部基于ViewPager2实现,Indicator和UI都可以自定义。

你可能感兴趣的:(Android,开发,android,java,apache)