介紹三個Android支持庫控件：TabLayout+ViewPager+RecyclerView

時間 2019-11-19

標籤介紹三個 android 支持控件 tablayout+viewpager+recyclerview tablayout viewpager recyclerview 欄目 Android 简体版

原文原文鏈接

本文主要介紹以下三個Android支持庫控件的配合使用：html

TabLayout：android.support.design.widget.TabLayout
ViewPager：android.support.v4.view.ViewPager
RecyclerView：android.support.v7.widget.RecyclerView

對於支持庫的使用，這裏稍做介紹：
Android支持庫包含經常使用的v四、v七、v13以及v17，註解支持（annotation），設計支持（material design）等。
目前v4和v7已經根據不一樣的功能進行了拆分，以減少目標Apk的大小，可針對某項具體的功能引入特定的包，而不用總體引入support-v4包。
好比，如下爲筆者經常使用的支持庫，讀者能夠參考：android

// 實現各類 UI 相關組件，例如 ViewPager、NestedScrollView 和 ExploreByTouchHelper。
supportCoreUi       : 'com.android.support:support-core-ui:24.2.0',
// 添加對使用片斷封裝用戶界面和功能的支持，從而使應用可以提供能夠在大屏幕設備與小屏幕設備之間進行調節的佈局。
// 此模塊依賴於 compat、core-utils、core-ui 和 media-compat。
supportFragment     : 'com.android.support:support-fragment:24.2.0',
// 此庫添加了對操做欄用戶界面設計模式的支持。此庫包含對 Material Design 用戶界面實現的支持。
supportAppCompat    : 'com.android.support:appcompat-v7:24.2.0',
// recyclerview 庫添加了 RecyclerView 類。此類可以爲 RecyclerView 小部件提供支持，
// RecyclerView 是一種經過提供有限的數據項窗口有效顯示大數據集的視圖。
supportRecyclerView : 'com.android.support:recyclerview-v7:24.2.0',
// 此庫添加了對 CardView 小部件的支持，讓您可以在卡片內顯示信息，從而使應用具有一致的外觀。
supportCardView     : 'com.android.support:cardview-v7:24.2.0',
// 註解軟件包提供的 API 支持嚮應用中添加註解元數據。
supportAnnotations  : 'com.android.support:support-annotations:24.2.0',
// 設計軟件包提供的 API 支持嚮應用中添加 Material Design 組件和模式。
supportDesign       : 'com.android.support:design:24.2.0',

最後，須要注意，支持庫的版本須要保持一致，否則容易出現編譯錯誤。
更多關於支持庫的使用，請參考官方文檔。設計模式

先上效果圖：app

（左滑的比較慢，是爲了看清效果）ide

1、TabLayout

TabLayout是design支持庫中引入的支持Tab頁的控件，配合ViewPager使用，實現Table頁面的滑動。使用時：佈局

使用setTabMode(TabLayout.MODE_FIXED)來設置TabLayout的模式；
經過addTab來添加Tab頁面；
最後經過setupWithViewPager來關聯ViewPager.

// 設置TabLayout的模式
goodsTypeTl.setTabMode(TabLayout.MODE_FIXED);
// 添加Fragment顯示
for (int i = 0; i < 2; i++) {
    PickingTaskGoodsFragment itemFragment = PickingTaskGoodsFragment.newInstance(
            i == 0 ? unCompletedPickingSku : pickingCompletedSku);
    fragmentList.add(itemFragment);
    goodsTypeTl.addTab(goodsTypeTl.newTab().setText(titleList.get(i)));
}
// 實例化ViewPage的適配器
FragmentPagerAdapter fAdapter = new PickingFragmentPagerAdapter(
        getSupportFragmentManager(), fragmentList, titleList);
// viewpager加載adapter
goodsDetailVp.setAdapter(fAdapter);
// TabLayout加載viewpager
goodsTypeTl.setupWithViewPager(goodsDetailVp);

2、ViewPager

ViewPager是在v4包中引入的控件，在佈局文件中，緊接着TabLayout進行佈局。ViewPager繼承自ViewGroup，在使用時，最關鍵的是爲其添加PagerAdapter，通常ViewPage會包含Fragment，那麼這裏PagerAdapter會使用FragmentPagerAdapter：大數據

public abstract class FragmentPagerAdapter extends PagerAdapter

FragmentPagerAdapter是一個抽象類，在使用時通常繼承自FragmentPagerAdapter自定義實現：ui

public class PickingFragmentPagerAdapter extends FragmentPagerAdapter {

    private List<Fragment> fragmentList;
    private List<String> titleList;

    public PickingFragmentPagerAdapter(FragmentManager fm,
                                       List<Fragment> fragmentList, List<String> titleList) {
        super(fm);
        this.fragmentList = fragmentList;
        this.titleList = titleList;
    }

    @Override
    public Fragment getItem(int position) {
        return fragmentList.get(position);
    }

    @Override
    public int getCount() {
        return titleList.size();
    }

    @Override
    public CharSequence getPageTitle(int position) {
        return titleList.get(position);
    }
}

getItem和getCount方法必需要求實現，分別返回List<Fragment>的內容就好了。this

在實例化PickingFragmentPagerAdapter時，須要傳入FragmentManager，通常採用getSupportFragmentManager()。spa

3、RecyclerView

RecyclerView是v7支持庫中引入的控件，使用時須要依賴com.android.support:recyclerview-v7:22.2.1，使用RecyclerView須要注意兩點：

設置LayoutManager

recyclerView.setLayoutManager(new LinearLayoutManager(context));

固然，這裏還能夠設置GridLayoutManager。

設置Adapter

recyclerView.setAdapter(new PickingTaskGoodsAdapter(pickingTaskDParams, mListener));

RecyclerView的Adapter是須要重點關注的。其中，須要實現的方法有三個：onCreateViewHolder、onBindViewHolder和getItemCount。

onCreateViewHolder：這個方法的返回值是ViewHolder，而這個ViewHolder通常都須要自定義，固然，默認RecyclerView也有ViewHolder。

View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.out_picking_goods_detail_item, parent, false);
return new ViewHolder(view, new MySkuItemData());

View是直接經過Inflater提取出來的（注意item的根ViewGroup的height不能設置爲match parent，否則多行item沒法正常顯示），ViewHolder的入參須要傳入View。ViewHolder的定義有點講究，與ListView中有不一致：

public class ViewHolder extends RecyclerView.ViewHolder {
    final View mView;

    AutofitTextView goodsNumberTv;
    TextView goodsNameTv;
    TextView goodsLeftNumberTv;
    ImageView skuState;
    Button pickingSku;

    ViewHolder(View view) {
        super(view);
        mView = view;

        goodsNumberTv = (AutofitTextView) view.findViewById(R.id.out_picking_task_goods_number_tv);
        goodsNameTv = (TextView) view.findViewById(R.id.out_picking_task_goods_name_tv);
        goodsLeftNumberTv = (TextView) view.findViewById(R.id.out_picking_task_goods_left_number_tv);
        skuState = (ImageView) view.findViewById(R.id.out_picking_task_goods_sku_state_iv);
        pickingSku = (Button) view.findViewById(R.id.out_picking_task_goods_picking_btn);
    }
}

首先，須要定義一個帶參構造器，第一個參數必定是View，ViewHolder也須要包含View的域，另外，ViewHolder能夠包含各個View的監聽器，而這種監聽器通常都須要自定義，由於其中會包含重要的參數。

onBindViewHolder是具體實現數據更新的地方，onBindViewHolder的入參爲ViewHolder holder, int position，所以，首先經過position獲取數據，而後對ViewHolder的控件依次設置：

@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    PickingTaskDParam dParam = taskDParamList.get(position);
    holder.goodsNumberTv.setText(dParam.getSkuNo());
    holder.goodsNameTv.setText(dParam.getSkuName());
    holder.goodsLeftNumberTv.setText(String.valueOf(dParam.getPlannedPickQty().intValue()));

    if (dParam.getOptStatus() == 1 || dParam.getOptStatus() == 2) {
        // 大小設置
        holder.pickingSku.setVisibility(View.GONE);
        holder.skuState.setVisibility(View.VISIBLE);
    } else {
        holder.skuState.setVisibility(View.GONE);
        if (pickingVisible) {
            holder.pickingSku.setVisibility(View.VISIBLE);
            holder.pickingSku.setOnClickListener(new MyItemOnClickListener(dParam));
        } else {
            holder.pickingSku.setVisibility(View.GONE);
        }
    }
}

getItemCount就直接返回數據List的size()就能夠啦。

RecyclerView添加分割：分爲設置垂直方向距離和設置分隔條兩種方式：

垂直方向距離：

public class VerticalSpaceItemDecoration extends RecyclerView.ItemDecoration {

    private final int verticalSpaceHeight;

    public VerticalSpaceItemDecoration(int verticalSpaceHeight) {
        this.verticalSpaceHeight = verticalSpaceHeight;
    }

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent,
            RecyclerView.State state) {
        outRect.bottom = verticalSpaceHeight;
    }
}

分隔條：

public class DividerItemDecoration extends RecyclerView.ItemDecoration {

    private static final int[] ATTRS = new int[]{android.R.attr.listDivider};

    private Drawable divider;

    /**
     * Default divider will be used
     */
    public DividerItemDecoration(Context context) {
        final TypedArray styledAttributes = context.obtainStyledAttributes(ATTRS);
        divider = styledAttributes.getDrawable(0);
        styledAttributes.recycle();
    }

    /**
     * Custom divider will be used
     */
    public DividerItemDecoration(Context context, int resId) {
        divider = ContextCompat.getDrawable(context, resId);
    }

    @Override
    public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
        int left = parent.getPaddingLeft();
        int right = parent.getWidth() - parent.getPaddingRight();

        int childCount = parent.getChildCount();
        for (int i = 0; i < childCount; i++) {
            View child = parent.getChildAt(i);

            RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child.getLayoutParams();

            int top = child.getBottom() + params.bottomMargin;
            int bottom = top + divider.getIntrinsicHeight();

            divider.setBounds(left, top, right, bottom);
            divider.draw(c);
        }
    }
}

以上關於分隔條內容可參考Stack Overflow：How to add dividers and spaces between items in RecyclerView?

4、One more thing

最後，複習下Fragment和Activity的數據傳遞：

從Activity到Fragment：Bundle，經過Fragment的newInstance方法：

public static PickingTaskGoodsFragment newInstance(List<PickingTaskDParam> pickingTaskDParams) {
    PickingTaskGoodsFragment fragment = new PickingTaskGoodsFragment();
    Bundle args = new Bundle();
    args.putParcelable(PICKING_TASK_D_PARAM, Parcels.wrap(pickingTaskDParams));
    fragment.setArguments(args);
    return fragment;
}

從Fragment到Activity：接口回調，在Fragment中定義接口，讓包含該Fragment的Activity必須實現接口：

@Override
public void onAttach(Context context) {
    super.onAttach(context);
    if (context instanceof OnListFragmentInteractionListener) {
        mListener = (OnListFragmentInteractionListener) context;
    } else {
        throw new RuntimeException(context.toString()
                + " must implement OnListFragmentInteractionListener");
    }
}
@Override
public void onDetach() {
    super.onDetach();
    mListener = null;
}
public interface OnListFragmentInteractionListener {

    void onListFragmentInteraction(PickingTaskDParam item);
}

以上。