点击下载 BGABannerDemo.apk 或扫描下面的二维码安装
bga-banner 后面的「latestVersion」指的是左边这个 maven-central 徽章后面的「数字」,请自行替换。
dependencies {
compile 'com.android.support:support-v4:latestVersion'
compile 'cn.bingoogolapple:bga-banner:latestVersion@aar'
}
<cn.bingoogolapple.bgabanner.BGABanner
android: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" />
有多种配置数据源的方式,这里仅列出三种方式。更多初始化方式请查看 demo,或加网页底部给的 QQ 群咨询
配置数据源的方式1:通过传入数据模型并结合 Adapter 的方式配置数据源。这种方式主要用于加载网络图片,以及实现少于3页时的无限轮播
mContentBanner.setAdapter(new BGABanner.Adapter<ImageView, String>() {
@Override
public 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);
mContentBanner.setDelegate(new BGABanner.Delegate<ImageView, String>() {
@Override
public void onBannerItemClick(BGABanner banner, ImageView itemView, String model, int position) {
Toast.makeText(banner.getContext(), "点击了" + position, Toast.LENGTH_SHORT).show();
}
});
mContentBanner.setEnterSkipViewIdAndDelegate(R.id.btn_guide_enter, R.id.tv_guide_skip, new BGABanner.GuideDelegate() {
@Override
public 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" />
<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" />
<attr name="banner_isNeedShowIndicatorOnOnlyOnePage" format="boolean" />
<attr name="banner_contentBottomMargin" format="dimension"/>
declare-styleable>