本文主要是介绍Android 引导、图片轮播控件(BGABanner),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
目录
- 功能介绍
- 效果图与示例 apk
- 常见问题
- 使用
- 自定义属性说明
- 关于我
- 打赏支持
- License
功能介绍
- 引导界面导航效果
- 支持根据服务端返回的数据动态设置广告条的总页数
- 支持大于等于1页时的无限循环自动轮播、手指按下暂停轮播、抬起手指开始轮播
- 支持自定义指示器位置和广告文案位置
- 支持图片指示器和数字指示器
- 支持 ViewPager 各种切换动画
- 支持选中特定页面
- 支持监听 item 点击事件
- 加载网络数据时支持占位图设置,避免出现整个广告条空白的情况
- 多个 ViewPager 跟随滚动
效果图与示例 apk
点击下载 BGABannerDemo.apk 或扫描下面的二维码安装
常见问题
- 结合 Fresco 加载图片请参考 FrescoDemoActivity
- 自定义 item 布局文件请参考 FrescoDemoActivity
使用
1.添加 Gradle 依赖
bga-banner 后面的「latestVersion」指的是左边这个 maven-central 徽章后面的「数字」,请自行替换。
dependencies {compile 'com.android.support:support-v4:latestVersion'compile 'cn.bingoogolapple:bga-banner:latestVersion@aar' }
2.在布局文件中添加 BGABanner
<cn.bingoogolapple.bgabanner.BGABannerandroid:id="@+id/banner_guide_content"style="@style/MatchMatch"app:banner_pageChangeDuration="1000"app:banner_pointAutoPlayAble="false"app:banner_pointContainerBackground="@android:color/transparent"app:banner_pointDrawable="@drawable/bga_banner_selector_point_hollow"app:banner_pointTopBottomMargin="15dp"app:banner_transitionEffect="alpha" />
3.在 Activity 或者 Fragment 中配置 BGABanner 的数据源
有多种配置数据源的方式,这里仅列出三种方式。更多初始化方式请查看 demo,或加网页底部给的 QQ 群咨询
配置数据源的方式1:通过传入数据模型并结合 Adapter 的方式配置数据源。这种方式主要用于加载网络图片,以及实现少于3页时的无限轮播
mContentBanner.setAdapter(new BGABanner.Adapter<ImageView, String>() {@Overridepublic void fillBannerItem(BGABanner banner, ImageView itemView, String model, int position) {Glide.with(MainActivity.this).load(model).placeholder(R.drawable.holder).error(R.drawable.holder).centerCrop().dontAnimate().into(itemView);} });mContentBanner.setData(Arrays.asList("网络图片路径1", "网络图片路径2", "网络图片路径3"), Arrays.asList("提示文字1", "提示文字2", "提示文字3"));
配置数据源的方式2:通过直接传入视图集合的方式配置数据源,主要用于自定义引导页每个页面布局的情况
List<View> views = new ArrayList<>(); views.add(BGABannerUtil.getItemImageView(this, R.drawable.ic_guide_1)); views.add(BGABannerUtil.getItemImageView(this, R.drawable.ic_guide_2)); views.add(BGABannerUtil.getItemImageView(this, R.drawable.ic_guide_3)); mContentBanner.setData(views);
配置数据源的方式3:通过传入图片资源 id 的方式配置数据源,主要用于引导页每一页都是只显示图片的情况
mContentBanner.setData(R.drawable.uoko_guide_foreground_1, R.drawable.uoko_guide_foreground_2, R.drawable.uoko_guide_foreground_3);
4.监听广告 item 的单击事件,在 BGABanner 里已经帮开发者处理了防止重复点击事件
mContentBanner.setDelegate(new BGABanner.Delegate<ImageView, String>() {@Overridepublic void onBannerItemClick(BGABanner banner, ImageView itemView, String model, int position) {Toast.makeText(banner.getContext(), "点击了" + position, Toast.LENGTH_SHORT).show();} });
5.设置「进入按钮」和「跳过按钮」控件资源 id 及其点击事件,如果进入按钮和跳过按钮有一个不存在的话就传 0,在 BGABanner 里已经帮开发者处理了防止重复点击事件,在 BGABanner 里已经帮开发者处理了「跳过按钮」和「进入按钮」的显示与隐藏
mContentBanner.setEnterSkipViewIdAndDelegate(R.id.btn_guide_enter, R.id.tv_guide_skip, new BGABanner.GuideDelegate() {@Overridepublic void onClickEnterOrSkip() {startActivity(new Intent(GuideActivity.this, MainActivity.class));finish();} });
自定义属性说明
<declare-styleable name="BGABanner"><!-- 指示点容器背景 --><attr name="banner_pointContainerBackground" format="reference|color" /><!-- 指示点背景 --><attr name="banner_pointDrawable" format="reference" /><!-- 指示点容器左右内间距 --><attr name="banner_pointContainerLeftRightPadding" format="dimension" /><!-- 指示点上下外间距 --><attr name="banner_pointTopBottomMargin" format="dimension" /><!-- 指示点左右外间距 --><attr name="banner_pointLeftRightMargin" format="dimension" /><!-- 指示器的位置 --><attr name="banner_indicatorGravity"><flag name="top" value="0x30" /><flag name="bottom" value="0x50" /><flag name="left" value="0x03" /><flag name="right" value="0x05" /><flag name="center_horizontal" value="0x01" /></attr><!-- 是否开启自动轮播 --><attr name="banner_pointAutoPlayAble" format="boolean" /><!-- 自动轮播的时间间隔 --><attr name="banner_pointAutoPlayInterval" format="integer" /><!-- 页码切换过程的时间长度 --><attr name="banner_pageChangeDuration" format="integer" /><!-- 页面切换的动画效果 --><attr name="banner_transitionEffect" format="enum"><enum name="defaultEffect" value="0" /><enum name="alpha" value="1" /><enum name="rotate" value="2" /><enum name="cube" value="3" /><enum name="flip" value="4" /><enum name="accordion" value="5" /><enum name="zoomFade" value="6" /><enum name="fade" value="7" /><enum name="zoomCenter" value="8" /><enum name="zoomStack" value="9" /><enum name="stack" value="10" /><enum name="depth" value="11" /><enum name="zoom" value="12" /></attr><!-- 提示文案的文字颜色 --><attr name="banner_tipTextColor" format="reference|color" /><!-- 提示文案的文字大小 --><attr name="banner_tipTextSize" format="dimension" /><!-- 加载网络数据时覆盖在 BGABanner 最上层的占位图 --><attr name="banner_placeholderDrawable" format="reference" /><!-- 是否是数字指示器 --><attr name="banner_isNumberIndicator" format="boolean" /><!-- 数字指示器文字颜色 --><attr name="banner_numberIndicatorTextColor" format="reference|color" /><!-- 数字指示器文字大小 --><attr name="banner_numberIndicatorTextSize" format="dimension" /><!-- 数字指示器背景 --><attr name="banner_numberIndicatorBackground" format="reference" /><!-- 当只有一页数据时是否显示指示器,默认值为 false --><attr name="banner_isNeedShowIndicatorOnOnlyOnePage" format="boolean" /><!-- 自动轮播区域距离 BGABanner 底部的距离,用于使指示器区域与自动轮播区域不重叠 --><attr name="banner_contentBottomMargin" format="dimension"/> </declare-styleable>
这篇关于Android 引导、图片轮播控件(BGABanner)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!