项目作者: xiaoowuu

项目描述 :
表格控件,TableLayout为TableView的升级版本,在原基础上增加支持滑动和选中
高级语言: Java
项目地址: git://github.com/xiaoowuu/TableLayout.git
创建时间: 2017-07-19T06:10:54Z
项目社区:https://github.com/xiaoowuu/TableLayout

开源协议:

下载


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

编辑模式预览

属性表
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的依赖
    1. dependencies {
    2. compile project(':tableLayout')
    3. }
  • 在xml中定义表格基础样式
    1. <win.smartown.android.library.tableLayout.TableLayout
    2. android:id="@+id/main_table"
    3. android:layout_width="wrap_content"
    4. android:layout_height="wrap_content"
    5. android:background="@android:color/white"
    6. app:backgroundColorSelected="@color/colorAccent"
    7. app:tableColumnPadding="32dp"
    8. app:tableDividerColor="#ddd"
    9. app:tableDividerSize="1px"
    10. app:tableRowHeight="48dp"
    11. app:tableTextColor="#333"
    12. app:tableTextColorSelected="#fff"
    13. app:tableTextSize="14dp" ></win.smartown.android.library.tableLayout.TableLayout>
  • 在Java代码中填充展示数据

    1. TableLayout tableLayout = (TableLayout) findViewById(R.id.main_table);
    2. contentList = new ArrayList<>();
    3. contentList.add(new Content("姓名", "语文", "数学", "英语", "物理", "化学", "生物"));
    4. contentList.add(new Content("张三", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));
    5. contentList.add(new Content("李四", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));
    6. contentList.add(new Content("王二", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));
    7. contentList.add(new Content("王尼玛", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));
    8. contentList.add(new Content("张全蛋", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));
    9. contentList.add(new Content("赵铁柱", newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber(), newRandomNumber()));
    10. tableLayout.setAdapter(new TableAdapter() {
    11. @Override
    12. public int getColumnCount() {
    13. return contentList.size();
    14. }
    15. @Override
    16. public String[] getColumnContent(int position) {
    17. return contentList.get(position).toArray();
    18. }
    19. });
    • 现在运行就可以看到下图的效果了

Demo

部分源码分析

这里由内而外的分析,从基础的单元开始。

  • win.smartown.android.library.tableLayout.TableColumn
    这个类表示表格中的一列,比较关键的点在于根据填充到此列的数据来确定此列的宽度

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

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

    2.遍历此列中所有的单元格,得到最大单元格的宽度maxTextViewWidth ,将其作为此列的宽度

    1. private void initContent() {
    2. int padding = callback.getTableLayout().getTableColumnPadding();
    3. maxTextViewWidth = 0;
    4. ArrayList<TextView> textViews = new ArrayList<>();
    5. for (String text : content) {
    6. TextView textView = new TextView(getContext());
    7. textView.setTextSize(TypedValue.COMPLEX_UNIT_PX, callback.getTableLayout().getTableTextSize());
    8. textView.setTextColor(callback.getTableLayout().getTableTextColor());
    9. maxTextViewWidth = Math.max(maxTextViewWidth, Util.measureTextViewWidth(textView, text));
    10. textView.setGravity(getTextGravity(callback.getTableLayout().getTableTextGravity()));
    11. textView.setPadding(padding, 0, padding, 0);
    12. textView.setText(text);
    13. textViews.add(textView);
    14. }
    15. LayoutParams layoutParams = new LayoutParams((int) (padding * 2 + maxTextViewWidth), callback.getTableLayout().getTableRowHeight());
    16. for (TextView textView : textViews) {
    17. addView(textView, layoutParams);
    18. }
    19. }
    20. @Override
    21. protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    22. super.onMeasure(widthMeasureSpec, heightMeasureSpec);
    23. setMeasuredDimension((int) (callback.getTableLayout().getTableColumnPadding() * 2 + maxTextViewWidth), callback.getTableLayout().getTableRowHeight() * getChildCount());
    24. }
  • win.smartown.android.library.tableLayout.TableLayout
    TableLayout就是最终呈现的完整表格,实际上他就是多个TableColumn的组合,其主要负责整个表格的大小测量、分割线绘制和接受数据填充。
    1.单元格大小测量

    1. @Override
    2. protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    3. super.onMeasure(widthMeasureSpec, heightMeasureSpec);
    4. int width = 0;
    5. int height = 0;
    6. int childCount = getChildCount();
    7. for (int i = 0; i < childCount; i++) {
    8. View child = getChildAt(i);
    9. width += child.getMeasuredWidth();
    10. height = Math.max(height, child.getMeasuredHeight());
    11. }
    12. setMeasuredDimension(width, height);
    13. }

    2.绘制分割线

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

    3.数据的填充

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

    1. @Override from GestureDetector (重写GestureDetector onScroll())
    2. public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
    3. View view = getChildAt(0);
    4. int childHeight = view.getHeight();
    5. int childWidth = view.getWidth();
    6. int toX, toY;
    7. if (distanceX > 0) {
    8. if (childWidth > getWidth()) {
    9. if (getScrollX() + getWidth() >= childWidth) {
    10. toX = childWidth - getWidth();
    11. } else {
    12. toX = (int) (getScrollX() + distanceX);
    13. }
    14. } else {
    15. toX = 0;
    16. }
    17. } else {
    18. if (getScrollX() + distanceX < 0) {
    19. toX = 0;
    20. } else {
    21. toX = (int) (getScrollX() + distanceX);
    22. }
    23. }
    24. if (distanceY > 0) {
    25. if (childHeight > getHeight()) {
    26. if (getScrollY() + getHeight() >= childHeight) {
    27. toY = childHeight - getHeight();
    28. } else {
    29. toY = (int) (getScrollY() + distanceY);
    30. }
    31. } else {
    32. toY = 0;
    33. }
    34. } else {
    35. if (getScrollY() + distanceY < 0) {
    36. toY = 0;
    37. } else {
    38. toY = (int) (getScrollY() + distanceY);
    39. }
    40. }
    41. scrollTo(toX, toY);
    42. return false;
    43. }

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

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

TableView