VerticalBannerView是一个仿淘宝APP首页轮播头条的自定义控件。
特性:
1.可自由定义展示的内容。
2.使用方式类似ListView/RecyclerView。
3.可为当前显示的内容添加各种事件,比如点击打开某个页面等。
VerticalBannerView开源项目地址
运行效果图:
一、项目使用
(1).添加项目依赖。
- dependencies {
- compile 'com.github.Rowandjj:VerticalBannerView:1.0'
- }
(2).添加布局。
- <LinearLayout
- android:layout_width="match_parent"
- android:layout_height="wrap_content"
- android:gravity="center_vertical"
- android:orientation="horizontal">
- <TextView
- android:layout_width="wrap_content"
- android:layout_height="wrap_content"
- android:paddingLeft="5dp"
- android:text="淘宝头条"
- android:textStyle="bold"/>
- <View
- android:layout_width="1dp"
- android:layout_height="40dp"
- android:layout_marginLeft="5dp"
- android:layout_marginRight="5dp"
- android:background="#cccccc"/>
- <com.taobao.library.VerticalBannerView
- xmlns:app="http://schemas.android.com/apk/res-auto"
- android:id="@+id/banner"
- android:layout_width="wrap_content"
- android:layout_height="36dp"
- app:animDuration="900"
- app:gap="2000"/>
- </LinearLayout>
(3).实现Adapter。
- public class SampleAdapter extends BaseBannerAdapter<Model> {
- private List<Model> mDatas;
- public SampleAdapter01(List<Model> datas) {
- super(datas);
- }
- @Override
- public View getView(VerticalBannerView parent) {
- return LayoutInflater.from(parent.getContext()).inflate(R.layout.your_item,null);
- }
- @Override
- public void setItem(final View view,final Model data) {
- TextView textView = (TextView) view.findViewById(R.id.text);
- textView.setText(data.title);
- // 你可以增加点击事件
- view.setOnClickListener(new View.OnClickListener() {
- @Override
- public void onClick(View v) {
- // TODO handle click event
- }
- });
- }
- }
(4).为VerticalBannerView设置Adapter,并启动动画。
- List<Model> datas = new ArrayList<>();
- datas.add(new Model01("Note7发布了"));
- datas.add(new Model01("Note7被召回了"));
- SampleAdapter adapter = new SampleAdapter(datas);
- VerticalBannerView banner = (VerticalBannerView) findViewById(R.id.banner);
- banner.setAdapter(adapter);
- banner.start();
二、源码分析
实现原理:
VerticalBannerView本质上是一个垂直的LinearLayout。定义一个Adapter类,向LinearLayout提供子View。初始状态下往LinearLayout中添加两个子View,子View的高度同LinearLayout的高度一致,这样一来只有第1个子View显示出来,第2个子View在底部不显示。然后使用属性动画ObjectAnimator同时修改两个子View的translationY属性,动画执行过程中translationY从默认值0渐变到负的LinearLayout的高度,显示出来的效果就是第1个子View逐渐向上退出,第2个子View从底部向上逐渐显示。动画执行完毕后,移除第1个子View,这样第2个子View的索引变成0,并完全显示出来占据LinearLayout的高度。再将已经移除的第1个子View,添加到索引为1的位置,此时该子View超出父视图之外完全不显示。一轮动画执行完毕,再调用postDelay()方法重复上述动画,一直循环下去。
下面进入代码部分,主要是两个类BaseBannerAdapter和VerticalBannerView。
(1).BaseBannerAdapter类
BaseBannerAdapter类负责为广告栏提供数据。我们在使用时,需要写一个Adapter类继承BaseBannerAdapter,实现getView()和setItem()方法。在getView()方法中,我们需要把要添加到广告栏中的item view创建出来并返回,setItem()方法则负责为创建的item view绑定数据。
- public abstract class BaseBannerAdapter<T> {
- private List<T> mDatas;
- private OnDataChangedListener mOnDataChangedListener;
- public BaseBannerAdapter(List<T> datas) {
- mDatas = datas;
- if (datas == null || datas.isEmpty()) {
- throw new RuntimeException("nothing to show");
- }
- }
- public BaseBannerAdapter(T[] datas) {
- mDatas = new ArrayList<>(Arrays.asList(datas));
- }
- // 设置banner填充的数据
- public void setData(List<T> datas) {
- this.mDatas = datas;
- notifyDataChanged();
- }
- void setOnDataChangedListener(OnDataChangedListener listener) {
- mOnDataChangedListener = listener;
- }
- // 获取banner总数
- public int getCount() {
- return mDatas == null ? 0 : mDatas.size();
- }
- // 通知数据改变
- void notifyDataChanged() {
- mOnDataChangedListener.onChanged();
- }
- // 获取数据
- public T getItem(int position) {
- return mDatas.get(position);
- }
- // 设置banner的ItemView
- public abstract View getView(VerticalBannerView parent);
- // 设置banner的数据
- public abstract void setItem(View view,T data);
- // 数据变化的监听
- interface OnDataChangedListener {
- void onChanged();
- }
- }
(2).VerticalBannerView类
VerticalBannerView类继承自LinearLayout,并在构造方法中设定方向为垂直。同时VerticalBannerView类实现了OnDataChangedListener接口,实现onChanged()方法,这样当改变数据后调用BaseBannerAdapter的notifyDataChanged()时,VerticalBannerView的onChanged()方法被回调,执行setupAdapter()重新初始化数据。
- public class VerticalBannerView extends LinearLayout implements BaseBannerAdapter.OnDataChangedListener {
- public VerticalBannerView(Context context,AttributeSet attrs,int defStyleAttr) {
- super(context,attrs,defStyleAttr);
- init(context,defStyleAttr);
- }
- private void init(Context context,int defStyleAttr) {
- setOrientation(VERTICAL);
- ......
- }
- ......
- @Override
- public void onChanged() {
- setupAdapter();
- }
- ......
- }
为VerticalBannerView添加item数据,需要调用setAdapter()方法,关键在于其中执行的setupAdapter()方法。
- public void setAdapter(BaseBannerAdapter adapter) {
- if (adapter == null) {
- throw new RuntimeException("adapter must not be null");
- }
- if (mAdapter != null) {
- throw new RuntimeException("you have already set an Adapter");
- }
- this.mAdapter = adapter;
- mAdapter.setOnDataChangedListener(this);
- setupAdapter();
- }
在setupAdapter()方法中,先移除所有的子View,然后调用Adapter的getView()方法创建两个子View,分别赋值给成员变量mFirstView和mSecondView,并为这两个子View绑定数据,最后再调用addView()添加进来。
- // 初始化Child View
- private void setupAdapter() {
- // 先移除所有的子View
- removeAllViews();
- if (mAdapter.getCount() == 1) {
- mFirstView = mAdapter.getView(this);
- mAdapter.setItem(mFirstView,mAdapter.getItem(0));
- addView(mFirstView);
- } else {
- // 调用Adapter的getView()方法,创建两个子View,分别赋值给mFirstView和mSecondView
- mFirstView = mAdapter.getView(this);
- mSecondView = mAdapter.getView(this);
- // 使用索引0和1的数据,为mFirstView和mSecondView设置数据
- mAdapter.setItem(mFirstView,mAdapter.getItem(0));
- mAdapter.setItem(mSecondView,mAdapter.getItem(1));
- // 将mFirstView和mSecondView添加到当前View
- addView(mFirstView);
- addView(mSecondView);
- mPosition = 1;
- isStarted = false;
- }
- setBackgroundDrawable(mFirstView.getBackground());
- }
为了实现子View之间的切换,需要把上面添加进来的子View的高度修改为与VerticalBannerView高度一致。这个操作在onMeasure()方法中完成。
- @Override
- protected void onMeasure(int widthMeasureSpec,int heightMeasureSpec) {
- super.onMeasure(widthMeasureSpec,heightMeasureSpec);
- // 成员变量mBannerHeight有一个默认值
- if (LayoutParams.WRAP_CONTENT == getLayoutParams().height) {
- // 如果当前View的高度设置为wrap_content,使用默认值
- getLayoutParams().height = (int) mBannerHeight;
- } else {
- // 如果当前View设定了固定高度,则使用设定的高度
- mBannerHeight = getHeight();
- }
- // 修改mFirstView和mSecondView的高度为其父视图的高度
- if (mFirstView != null) {
- mFirstView.getLayoutParams().height = (int) mBannerHeight;
- }
- if (mSecondView != null) {
- mSecondView.getLayoutParams().height = (int) mBannerHeight;
- }
- }
上面的准备工作完成后,就可以进入动画的执行了。VerticalBannerView通过调用start()方法启动切换动画。在start()方法中,调用postDelayed()执行AnimRunnable任务,在AnimRunnable的run()方法中,先调用performSwitch(),然后再次调用postDelayed()使AnimRunnable任务一直循环执行下去。两个子View之间的切换工作由performSwitch()负责执行。
- public void start() {
- if (mAdapter == null) {
- throw new RuntimeException("you must call setAdapter() before start");
- }
- if (!isStarted && mAdapter.getCount() > 1) {
- isStarted = true;
- postDelayed(mRunnable,mGap);
- }
- }
- private AnimRunnable mRunnable = new AnimRunnable();
- private class AnimRunnable implements Runnable {
- @Override
- public void run() {
- performSwitch();
- // 调用postDelayed()延时再执行,一直循环下去
- postDelayed(this,mGap);
- }
- }
下面再进入performSwitch()方法,该方法是Item View之间产生切换效果的核心。
- // 执行切换
- private void performSwitch() {
- // 动画在执行过程中,View的translationY属性从0一直减小到-mBannerHeight
- // 因为translationY属性一直是负值,所以View向上移动
- ObjectAnimator animator1 = ObjectAnimator.ofFloat(mFirstView,"translationY",-mBannerHeight);
- ObjectAnimator animator2 = ObjectAnimator.ofFloat(mSecondView,-mBannerHeight);
- AnimatorSet set = new AnimatorSet();
- set.playTogether(animator1,animator2);
- set.addListener(new AnimatorListenerAdapter() {
- @Override
- public void onAnimationEnd(Animator animation) {
- // 动画执行完成,把mFirstView和mSecondView的translationY恢复到默认状态
- mFirstView.setTranslationY(0);
- mSecondView.setTranslationY(0);
- // 使用下一条数据,设置到第一个子View
- View removedView = getChildAt(0);
- mPosition++;
- mAdapter.setItem(removedView,mAdapter.getItem(mPosition % mAdapter.getCount()));
- // 移除第一个子View,此时当前LinearLayout的childCount==1
- removeView(removedView);
- // 移除的View,再添加到第2个位置
- addView(removedView,1);
- }
- });
- set.setDuration(mAnimDuration);
- set.start();
- }
在performSwitch()方法中,使用属性动画ObjectAnimator同时修改两个mFirstView和mSecondView的translationY属性,动画执行中translationY从默认值0一直减小到-mBannerHeight,在这个过程中mFirstView逐渐向上退出,mSecondView从底部逐渐显现。动画执行完毕后,移除mFirstView,mSecondView变成第1个子View并完全显示出来填充父视图的高度。再将移除的mFirstView添加到第2个位置,此时mFirstView未显示出来。由于performSwitch()方法一直循环被调用,mFirstView和mSecondView就这样一直循环切换。