本文主要介绍Android Support v7提供的RecycleView和交错式布局(通常成为瀑布流布局)的使用和事件监听处理。
1. 涉及到开源库有:
Fresco :
Facebook开源的不是一般强大的图片加载组件库
Android View和事件绑定库,通过注解完成,在编译时APT处理注解文档。
2. 模块配置
Android Studio模块,build.gradle配置:
apply plugin: 'com.android.application' android { compileSdkVersion 21 buildToolsVersion '21.1.2' defaultConfig { applicationId 'secondriver.sdk' minSdkVersion 16 targetSdkVersion 21 versionCode 1 versionName '1.0' } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } packagingOptions { exclude 'META-INF/services/javax.annotation.processing.Processor' } lintOptions { disable 'InvalidPackage' } } dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) compile 'com.android.support:appcompat-v7:21.0.3' compile 'com.android.support:recyclerview-v7:21.0.3@aar' compile 'com.android.support:cardview-v7:21.0.3@aar' compile 'com.facebook.fresco:fresco:0.8.0' compile 'com.jakewharton:butterknife:7.0.1' testCompile 'junit:junit:4.12' }
3. 布局文件
主布局文件:activity_recycleview.xml 包含一个RecycleView,将作为主屏幕组件。
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout android:id="@+id/swipe_refresh_layout" xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="wrap_content"> <android.support.v7.widget.RecyclerView android:id="@+id/recycler_view" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_alignParentTop="true" android:scrollbars="vertical" /> </RelativeLayout>
RecycleView 通过设置不同的布局管理器对象来实现不同的布局显示,如:
android.support.v7.widget.LinearLayoutManager 可以实现ListView的布局效果
android.support.v7.widget.GridLayoutManager 可以实现GridView的布局效果
android.support.v7.widget.StaggeredGridLayoutManager 可以实现交错式网格布局效果
次布局文件(RecycleView中显示的每一项视图的布局):item_recycelview.xml 通过com.android.support:CardView包提供的CardView帧式容器布局包含一个ImageView和TextView作为RecycleView的每一项视图的布局。
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:card_view="http://schemas.android.com/apk/res-auto" xmlns:fresco="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:gravity="center"> <android.support.v7.widget.CardView android:id="@+id/card_view" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center" card_view:cardCornerRadius="4dp" card_view:cardUseCompatPadding="true"> <RelativeLayout android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="vertical"> <com.facebook.drawee.view.SimpleDraweeView android:id="@+id/info_image" android:layout_width="300dp" android:layout_height="420dp" fresco:actualImageScaleType="centerCrop" fresco:placeholderImage="@mipmap/ic_launcher" fresco:roundAsCircle="false" fresco:roundBottomLeft="true" fresco:roundBottomRight="true" fresco:roundTopLeft="true" fresco:roundTopRight="true" fresco:roundedCornerRadius="1dp" fresco:roundingBorderWidth="2dp" /> <TextView android:id="@+id/info_text" android:layout_width="200dp" android:layout_height="80dp" android:textSize="20sp" android:textColor="@android:color/holo_blue_dark" android:textAppearance="?android:attr/textAppearanceMedium" android:layout_alignLeft="@id/info_image" android:layout_alignRight="@id/info_image" android:layout_below="@id/info_image" android:gravity="left|center_vertical"/> </RelativeLayout> </android.support.v7.widget.CardView> </LinearLayout>
ImageView组件使用的是Fresco库提供的视图组件。
4. Activity实现和数据填充
4.1 RecycleView中的每一项视图的数据组成
文本信息+ 图片地址(url,file,resId) 本示例中采用Url网络图片
/**
* View项的数据对象
*/
static class Pair {
public String text;
public String url;
public Pair(String text, String url) {
this.text = text;
this.url = url;
}
}
4.2 RecycleView中国的每一项视图的数据填充,即适配器
自定义适配器需要实现RecycleView.Adapter类。
static class RecycleViewAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
/**
* RecycleView的View项单击事件监听
*/
public interface OnRecycleViewItemClickListener {
void onRecycleViewItemClick(View view, int position);
}
private ArrayList<Pair> items = new ArrayList<>();
private OnRecycleViewItemClickListener mOnRecycleViewItemClickListener;
public RecycleViewAdapter(ArrayList<Pair> items) {
this.items = items;
}
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_recyclerview, parent, false);
return new RecycleViewItemHolder(view, mOnRecycleViewItemClickListener);
}
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
Pair pair = items.get(position);
((RecycleViewItemHolder) holder).setContent(pair);
}
@Override
public int getItemCount() {
return items.size();
}
public void setOnRecycleViewItemClickListener(OnRecycleViewItemClickListener onItemClickListener) {
if (null != onItemClickListener) {
this.mOnRecycleViewItemClickListener = onItemClickListener;
}
}
}
主要实现onCreateViewHolder和onBindViewHolder方法。由于RecycleView并未提供为视图项添加监听事件,这里自定义个一个事件监听接口,在实例化适配器的时候可以选择设置事件监听。
4.3 创建ViewHolder需要通过自定义ViewHolder类继承RecycleView.ViewHolder。
static class RecycleViewItemHolder extends RecyclerView.ViewHolder implements View.OnClickListener {
@Bind(R.id.info_text)
public TextView infoTextView;
@Bind(R.id.info_image)
public SimpleDraweeView draweeView;
private RecycleViewAdapter.OnRecycleViewItemClickListener onItemClickListener;
public RecycleViewItemHolder(View itemView, RecycleViewAdapter.OnRecycleViewItemClickListener onItemClickListener) {
super(itemView);
ButterKnife.bind(this, itemView);
this.onItemClickListener = onItemClickListener;
itemView.setOnClickListener(this);
}
public void setContent(Pair pair) {
infoTextView.setText(pair.text);
draweeView.setImageURI(Uri.parse(pair.url));
}
@Override
public void onClick(View v) {
if (null != onItemClickListener) {
onItemClickListener.onRecycleViewItemClick(v, getPosition());
}
}
}
在构造方法中的传入OnRecycleViewItemClickListener对象,并且自定义ViewHolder实现OnClickListener接口,通过为itemView对象设置OnClickListener监听事件,在onClick方法中将点击事件的处理交由OnRecycleViewItemClickListener对象处理,从而达到为RecycleView中的itemView注册点击事件。
如果不采用这种方式添加事件监听,就不需要自定义监听接口和自定义ViewHolder实现事件监听接口以及事件处理。另外可以通过获得的itemView之后,通过组件I的获取组件来添加事件监听。还可以通过获得的自定义ViewHolder,来访问每个组件。
4.4 Activity的具体实现
package secondriver.sdk.activity;
import android.app.Activity;
import android.net.Uri;
import android.os.Bundle;
import android.support.v7.widget.DefaultItemAnimator;
import android.support.v7.widget.RecyclerView;
import android.support.v7.widget.StaggeredGridLayoutManager;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import android.widget.Toast;
import com.facebook.drawee.view.SimpleDraweeView;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Random;
import butterknife.Bind;
import butterknife.ButterKnife;
import secondriver.sdk.R;
/**
* Author : secondriver
* Created : 2015/11/18
*/
public class RecycleViewActivity extends Activity {
private static final String TAG = RecyclerView.class.getName();
private static final String[] RES_URL = new String[]{
"http://p1.wmpic.me/article/2015/11/16/1447644849_hySANEEF.jpg",
//减少篇幅,此处省去14个图片Url
};
@Bind(R.id.recycler_view)
public RecyclerView mRecycleView;
private final int PRE_SCREEN_NUMBER = 6;
private final int SPAN_COUNT = 2;
private int previousLastIndex = 0;
private boolean isSlidingToLast = false;
private RecycleViewAdapter mAdapter;
private ArrayList<Pair> mItem = new ArrayList<>();
//交错式网格布局管理对象,即通常称的瀑布流布局
private StaggeredGridLayoutManager mLayoutManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_recyclerview);
ButterKnife.bind(this);
Fresco.initialize(this); //重要,Fresco做一系列初始化工作
initRecycleView();
}
private void initRecycleView() {
mLayoutManager = new StaggeredGridLayoutManager(SPAN_COUNT, StaggeredGridLayoutManager.VERTICAL);
mRecycleView.setLayoutManager(mLayoutManager);
mAdapter = new RecycleViewAdapter(mItem);
loadData(false);
mRecycleView.setAdapter(mAdapter);
mRecycleView.setItemAnimator(new DefaultItemAnimator());
//RecycleView的View项单击事件监听
mAdapter.setOnRecycleViewItemClickListener(new RecycleViewAdapter.OnRecycleViewItemClickListener() {
@Override
public void onRecycleViewItemClick(View view, int position) {
long id = mRecycleView.getChildItemId(view);
Log.d(TAG, "View项的根视图:" + view.getClass().getName() + ",position=" + position + " ViewHolder_Id=" + id);
//通过findViewById查找View项中的元素
SimpleDraweeView draweeView = (SimpleDraweeView) view.findViewById(R.id.info_image);
if (null != draweeView) {
draweeView.setImageURI(Uri.parse(RES_URL[0]));
Toast.makeText(RecycleViewActivity.this, "通过findViewById查找View项中的元素", Toast.LENGTH_LONG).show();
}
RecycleViewItemHolder recycleViewItemHolder = (RecycleViewItemHolder) mRecycleView.findViewHolderForPosition(position);
if (null != recycleViewItemHolder) {
recycleViewItemHolder.infoTextView.setText("通过ViewHolder找到View项中的元素");
}
}
});
//下拉刷新,追加内容
mRecycleView.setOnScrollListener(
new RecyclerView.OnScrollListener() {
@Override
public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
super.onScrollStateChanged(recyclerView, newState);
if (newState == RecyclerView.SCROLL_STATE_IDLE) {
if (isPullToBottom() && isSlidingToLast) {
if (mItem.size() > 36) { //最大数据量
Toast.makeText(RecycleViewActivity.this, "没有数据了", Toast.LENGTH_LONG).show();
return;
} else {
loadData(false);
Log.d(TAG, "notifyItemRangeInserted startPosition=" + previousLastIndex);
mAdapter.notifyItemRangeInserted(previousLastIndex, PRE_SCREEN_NUMBER);
}
}
}
if (newState == RecyclerView.SCROLL_STATE_SETTLING) {
Log.d(TAG, "settling");
}
}
@Override
public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
super.onScrolled(recyclerView, dx, dy);
isSlidingToLast = dy > 0; //上拉,下滑
Log.d(TAG, "dx = " + dx + " dy=" + dy + " isSlidingToLast=" + isSlidingToLast);
}
}
);
}
private boolean isPullToBottom() {
int[] lastIndexs = mLayoutManager.findLastCompletelyVisibleItemPositions(null);
Log.d(TAG, "last item =" + Arrays.toString(lastIndexs) + ", have item=" + mAdapter.getItemCount());
int maxIndex = mAdapter.getItemCount() - 1;
for (int i : lastIndexs) {
if (i == maxIndex) {
return true;
}
}
return false;
}
private void loadData(boolean isClear) {
if (isClear) {
mItem.clear();
}
previousLastIndex = mItem.size();
Random r = new Random();
for (int index = 0; index < PRE_SCREEN_NUMBER && index < RES_URL.length; index++) {
mItem.add(new Pair("Card " + (previousLastIndex + index), RES_URL[r.nextInt(RES_URL.length)]));
}
Log.d(TAG, "mItem count =" + mItem.size());
}
}
说明:
RecycleView的ItemView的数据由Pair对象管理存储
Fresco库默认配置下的使用之前需要初始化调用Fresco.initialize(Context)
上述实现了2个事件监听,一个OnScrollerListener由RecycleView提供,实现下拉刷新;一个OnRecycleViewItemClickListener由自定义的RecycleViewAdpater提供,实现单击itemView来更换图片(SimpleDraweeView)和文字(TextView)。
Butterknife和Fresco库的具体使用参见其Github上的文档。
5. 效果图
比较遗憾ScreenRecord不支持模拟器和Android4.4一下的系统,只能附上截图。