【Android开发笔记】自定义表格控件

来源:互联网 发布:cat linux 指定行 编辑:程序博客网 时间:2024/06/09 18:14

2017年8月15日更新

升级版 TableLayout

针对简友的反馈,在TableView的基础上做了一些小的提升:
- 内容超出屏幕范围可以滑动显示
- 单元格可被选中

在编辑模式下预览,可以看出修改不同属性产生的变化

编辑模式预览

属性表
attr meaning defaultValue 备注 tableRowHeight 单元格的高度 36dp tableDividerSize 分割线大小 1px tableDividerColor 分割线颜色 Color.GRAY tableColumnPadding 单元格左右padding 0 tableTextGravity 单元格对齐方式 center 可选center/leftCenter/rightCenter tableTextSize 字体大小 12dp tableTextColor 文字颜色 Color.GRAY tableTextColorSelected 选中后文字颜色 Color.BLACK backgroundColorSelected 单元格选中后的背景色 Color.TRANSPARENT
使用方法
  • 在GitHub上检出此项目,将tableLayout这个library module导入到项目中,并在application module中添加对tableLayout的依赖
dependencies {    compile project(':tableLayout')}
  • 在xml中定义表格基础样式
    <win.smartown.android.library.tableLayout.TableLayout        android:id="@+id/main_table"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:background="@android:color/white"        app:backgroundColorSelected="@color/colorAccent"        app:tableColumnPadding="32dp"        app:tableDividerColor="#ddd"        app:tableDividerSize="1px"        app:tableRowHeight="48dp"        app:tableTextColor="#333"        app:tableTextColorSelected="#fff"        app:tableTextSize="14dp" />
  • 在Java代码中填充展示数据
        TableLayout tableLayout = (TableLayout) findViewById(R.id.main_table);        contentList = new ArrayList<>();        contentList.add(new Content("姓名", "语文", "数学", "英语", "物理", "化学", "生物"));        contentList.add(new Content("张三", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));        contentList.add(new Content("李四", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));        contentList.add(new Content("王二", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));        contentList.add(new Content("王尼玛", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));        contentList.add(new Content("张全蛋", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));        contentList.add(new Content("赵铁柱", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));        tableLayout.setAdapter(new TableAdapter() {            @Override            public int getColumnCount() {                return contentList.size();            }            @Override            public String[] getColumnContent(int position) {                return contentList.get(position).toArray();            }        });
  • 现在运行就可以看到下图的效果了

Demo

部分源码分析

这里由内而外的分析,从基础的单元开始。
- win.smartown.android.library.tableLayout.TableColumn
这个类表示表格中的一列,比较关键的点在于根据填充到此列的数据来确定此列的宽度

1.根据填充内容确定一个单元格(TextView)显示这些文本要占用的宽度:

// 计算出该TextView中文字的长度(像素)
public static float measureTextViewWidth(TextView textView, String text) {
// 得到使用该paint写上text的时候,像素为多少
return textView.getPaint().measureText(text);
}

2.遍历此列中所有的单元格,得到最大单元格的宽度maxTextViewWidth ,将其作为此列的宽度
“`
private void initContent() {
int padding = callback.getTableLayout().getTableColumnPadding();
maxTextViewWidth = 0;
ArrayList textViews = new ArrayList<>();
for (String text : content) {
TextView textView = new TextView(getContext());
textView.setTextSize(TypedValue.COMPLEX_UNIT_PX, callback.getTableLayout().getTableTextSize());
textView.setTextColor(callback.getTableLayout().getTableTextColor());
maxTextViewWidth = Math.max(maxTextViewWidth, Util.measureTextViewWidth(textView, text));
textView.setGravity(getTextGravity(callback.getTableLayout().getTableTextGravity()));
textView.setPadding(padding, 0, padding, 0);
textView.setText(text);
textViews.add(textView);
}
LayoutParams layoutParams = new LayoutParams((int) (padding * 2 + maxTextViewWidth), callback.getTableLayout().getTableRowHeight());
for (TextView textView : textViews) {
addView(textView, layoutParams);
}
}

@Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {    super.onMeasure(widthMeasureSpec, heightMeasureSpec);    setMeasuredDimension((int) (callback.getTableLayout().getTableColumnPadding() * 2 + maxTextViewWidth), callback.getTableLayout().getTableRowHeight() * getChildCount());}

“`

  • win.smartown.android.library.tableLayout.TableLayout
    TableLayout就是最终呈现的完整表格,实际上他就是多个TableColumn的组合,其主要负责整个表格的大小测量、分割线绘制和接受数据填充。
    1.单元格大小测量

    @Overrideprotected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {    super.onMeasure(widthMeasureSpec, heightMeasureSpec);    int width = 0;    int height = 0;    int childCount = getChildCount();    for (int i = 0; i < childCount; i++) {        View child = getChildAt(i);        width += child.getMeasuredWidth();        height = Math.max(height, child.getMeasuredHeight());    }    setMeasuredDimension(width, height);}

    2.绘制分割线

    在ViewGroup要重写onDraw(),需要设置setWillNotDraw(false),否者onDown()中的绘制不会生效,具体的分割线绘制参见TableLayout源码的onDraw();

    3.数据的填充

    public void setAdapter(TableAdapter adapter) {    this.adapter = adapter;    useAdapter();}//设置adapter后,先清空原来的数据,然后根据新数据添加TableColumnprivate void useAdapter() {    removeAllViews();    int count = adapter.getColumnCount();    for (int i = 0; i < count; i++) {        addView(new TableColumn(getContext(), adapter.getColumnContent(i), this));    }}
  • win.smartown.android.library.tableLayout.FreeScrollView
    顾名思义,此类用来实现子View的自用滚动,当子view大小超过FreeScrollView的大小,就可以拖动显示超出的内容
    1.处理滚动

            @Override from GestureDetector (重写GestureDetector 的onScroll())        public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {            View view = getChildAt(0);            int childHeight = view.getHeight();            int childWidth = view.getWidth();            int toX, toY;            if (distanceX > 0) {                if (childWidth > getWidth()) {                    if (getScrollX() + getWidth() >= childWidth) {                        toX = childWidth - getWidth();                    } else {                        toX = (int) (getScrollX() + distanceX);                    }                } else {                    toX = 0;                }            } else {                if (getScrollX() + distanceX < 0) {                    toX = 0;                } else {                    toX = (int) (getScrollX() + distanceX);                }            }            if (distanceY > 0) {                if (childHeight > getHeight()) {                    if (getScrollY() + getHeight() >= childHeight) {                        toY = childHeight - getHeight();                    } else {                        toY = (int) (getScrollY() + distanceY);                    }                } else {                    toY = 0;                }            } else {                if (getScrollY() + distanceY < 0) {                    toY = 0;                } else {                    toY = (int) (getScrollY() + distanceY);                }            }            scrollTo(toX, toY);            return false;        }

    2.处理点击事件,达到选中效果

            //由于FreeScrollView拦截了TouchEvent,所以要在FreeScrollView处理点击事件,        //通过计算坐标来定位点击的是哪个单元格,点击处理顺序:        //FreeScrollView.onSingleTapUp() -> TableLayout.onClick()  -> TableLayout.onClick() -> TableColumn.onClick()        @Override from GestureDetector         public boolean onSingleTapUp(MotionEvent e) {            View view = getChildAt(0);            if (view instanceof TableLayout) {                ((TableLayout) view).onClick(e.getX() + getScrollX(), e.getY() + getScrollY());            }            return false;        }
Github
  • TableLayout
  • TableView
    TableView