Orient-Ui | 单RecyclerView实现花式表格

前言

表格是自打我进公司之后就使用的控件，起初使用的是ScrollablePanel，从一开始的被花式吊打，到后期的熟练使用。

大佬写的控件确实给个人工做带来了极大的方便，不过仍是有些问题存在：

• 没法实现不规则的表格
• 其核心是二层RecyclerView的嵌套，若是只用一层RecyclerView将会带来性能的提高
• 多个RecyclerView偶尔致使界面变形

在我深刻学习RecyclerView之后，想能不能只用一层RecyclerView，借助LayoutManager实现，写着写着，发现该思路可行，并实现了一款基于一个RecyclerView的表格控件TableView，先看一下效果：

# 照片墙

常常看到有同窗问相似的首页如何实现，如今不用自定义View也能够轻松实现了哈~

# 课程表

# 表格

Github地址：github.com/mCyp/Orient…

特色

TableView具备以下特色：

• 支持不规则表格
• 同时支持横向和纵向滚动
• 支持顶部和左侧悬浮
• 基于RecyclerView，因此RecyclerView自定义子视图、高效回收、子视图多样性这些特色它都有
• 摒弃多层RecyclerView嵌套，性能更棒

使用

第一步 | 添加xml文件

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".ui.fragment.table.TableFragment">

    <com.orient.me.widget.rv.adapter.TableView android:id="@+id/tb" android:layout_width="match_parent" android:layout_height="match_parent"/>

</FrameLayout>
复制代码

第二步 | 获取TableView

在展现代码以前，了解一下TableView中的主要函数：

方法	描述
setTitle(boolean isLeftOpen, boolean isTopOpen)	左侧或者上侧的悬浮标题是否显示，默认显示
setModeAndValue(int mode, int w, int h)	mode-表格模式、w-具体的宽度\一行容纳的单元格数、h-具体的高度\一列容纳的单元格数

这个setTitle(boolean isLeftOpen, boolean isTopOpen)有什么做用呢？为了确保表格的每个单元格的长度和宽度都同样（子视图能够在横纵方向上占有多个单元格），宽和高都使用两种方式：

• 设置具体的值，那么单元格的宽或者高的值就是具体的
• 设置一行或者一列能够容纳的单元格数量

因此宽高各有两种，模式的数量 = 2 * 2，总共有：

Mode模式	w的说明	h的说明
TableLayoutManager.MODE_A	父布局一行容纳的单元格数	父布局一列容纳的单元格数
TableLayoutManager.MODE_B	单元格宽度	单元格高度
TableLayoutManager.MODE_C	父布局一行容纳的单元格数	单元格高度
TableLayoutManager.MODE_D	单元格宽度	父布局一列容纳的单元格数

代码：

// if use butterknife
// or use findViewById
@BindView(R.id.tb)
 TableView mTable;

// 默认为 TableLayoutManager.MODE_A, 4, 8
mTable.setModeAndValue(TableLayoutManager.MODE_A, 6, 8);
复制代码

第三步 | 建立数据类

实现ICellItem接口：

public class TableCell implements ICellItem {

    private String name;
    private String value;
    private int type;
    private int row;
    private int col;
    private int widthSpan;
    private int heightSpan;

    //... 省略构造函数和Get Set方法

    @Override
    public int getRow() {
        return row;
    }

    @Override
    public int getCol() {
        return col;
    }

    @Override
    public int getWidthSpan() {
        return widthSpan;
    }

    @Override
    public int getHeightSpan() {
        return heightSpan;
    }
}
复制代码

第四步 | 设置适配器

private TableAdapter<TableCell> mAdapter;

protected void initWidget(View root) {
    // 假设在这个方法中初始化
    mTable.setAdapter(mAdapter = new TableAdapter<TableCell>(new ArrayList<>()) {
        @Override
        public int getItemLayout(TableCell tableCell, int pos) {
        	// ... 返回子视图布局文件
      		// 支持多类型
      		return R.layout.table_cell_content_item;
        }

        @Override
        public BaseAdapter.ViewHolder<TableCell> onCreateViewHolder(View root, int itemType) {
        	// itemType是子视图布局文件
          	// 根据布局返回具体的ViewHolder
          	return new ContentHolder(root);
        }
     });
}

// 具体的ViewHolder
class ContentHolder extends BaseAdapter.ViewHolder<TableCell>{

        TextView mContent;

        public ContentHolder(View itemView) {
            super(itemView);
            mContent = itemView.findViewById(R.id.tv_name);
        }

        @Override
        protected void onBind(TableCell tableCell) {
            mContent.setText(tableCell.getValue());
        }
 }
复制代码

第五步 | 从新测绘

若是TableView使用的模式是Mode_A、Mode_C和Mode_D，须要再从新测量：

mTable.post(() -> mTable.reMeasure());
复制代码

总结

总的来讲，TableView的核心是TableLayoutManager,也就是RecyclerView中的LayoutManager，相似于能够随时横纵向切换的GridLayoutManager，若是各位同窗对TableView感兴趣，我将会在后续的文章深刻原理。

探索不易，若是以为【Orient-Ui】不错，欢迎Star或者提出问题，年前的最后一篇技术文章啦，你们加油~

深刻原理以前，建议复习RecyclerView的原理：

《抽丝剥茧RecyclerView - 化整为零》
《抽丝剥茧RecyclerView - LayoutManager》