Android -- 开源库表格 SmartTable 的基本使用

Posted 2023-03-10 Kevin-Dev

介绍

1. 功能

1. 快速配置自动生成表格；
2. 自动计算表格宽高；
3. 表格列标题组合；
4. 表格固定左序列、顶部序列、第一行、列标题、统计行；
5. 自动统计，排序（自定义统计规则）；
6. 表格图文、序列号、列标题格式化；
7. 表格各组成背景、文字、网格、padding等配置；
8. 表格批注；
9. 表格内容、列标题点击事件；
10. 缩放模式和滚动模式；
11. 注解模式；
12. 内容多行显示；
13. 分页模式；
14. 首尾动态添加数据;
15. 丰富的格式化;
16. 支持二维数组展示（用于类似日程表，电影选票等）；
17. 导入excel(支持颜色，字体，背景，批注，对齐，图片等基本Excel属性)；
18. 表格合并单元(支持注解合并，支持自动合并)；
19. 支持其他刷新框架SmartRefreshLayout；
20. 可配置表格最小宽度(小于该宽度自动适配)；
21. 支持直接List或数组字段转列；
22. 支持Json数据直接转换成表格；
23. 支持表格网格指定行列显示；
24. 支持自动生成表单。

android 自动生成表格框架，GitHub 地址： SmartTable

2. 基本方法

Column 类的常用方法

• setAutoCount(boolean isAutoCount)：设置自动排序（默认升序）
• isReverseSort：是否是反序排列
• setComparator：设置排序比较
• setCountFormat：统计格式化
• OnColumnItemClickListener：列内容点击事件
• setFixed：滑动到表格左边时固定列
• setTextAlign：设置开启自动合并
• setMaxMergeCount：设置开启最大数量
• setDrawFormat：设置绘制样式格式化
• setFormat：设置文字格式化

TableData 类常用方法

• setSortColumn：设置排序列
• settitleDrawFormat：设置列标题格式化
• setXSequenceFormat：设置顶部序列号格式化
• setYSequenceFormat：设置左边序列号格式化
• setShowCount：设置是否显示统计
• setTitleDrawFormat：设置列标题绘制格式化
• setXSequenceFormat: 设置 X 序号行文字格式化
• setYSequenceFormat : 设置 Y 序号行文字格式化
• setUserCellRange(List userCellRange) :设置添加自定义合并规则

TableConfig 类常用方法

• setContentStyle :设置内容文字样式
• setYSequenceStyle :设置左边序列文字样式
• setXSequenceStyle :设置顶部序列文字样式
• setColumnTitleStyle :设置列标题文字样式
• setTableTitleStyle :设置表格标题文字样式
• setCountStyle :设置统计行样式
• setColumnTitleGridStyle :设置列标题网格样式
• setGridStyle :设置内容网格样式
• setVerticalPadding :设置网格列 padding
• setHorizontalPadding :设置网格行 padding
• setYSequenceBackgroundColor :设置左序列背景
• setXSequenceBackgroundColor :设置横序行背景
• setColumnTitleBackgroundColor :设置列标题背景
• setContentBackgroundColor :设置内容背景
• setCountBackgroundColor :设置统计行背景
• setFixedYSequence :固定左侧
• setFixedXSequence :固定顶部
• setFixedTitle :固定列标题
• setFixedCountRow :固定统计行
• setColumnTitleVerticalPadding :列标题上下 padding
• setColumnTitleHorizontalPadding :增加列标题左右 padding
• setSequenceGridStyle :序列网格样式
• columnTitleGridStyle :列标题网格样式
• setShowXSequence :设置是否显示顶部序号列
• setShowYSequence :设置是否显示左侧序号列
• setShowTableTitle :设置是否显示表格标题
• isShowColumnTitle :设置是否显示列标题
• setMinTableWidth :设置表格最小宽度

SmartTable 类的常用方法

• setOnColumnClickListener :设置列标题点击事件
• setSortColumn :设置排序列
• setZoom(boolean zoom,float maxZoom,float minZoom) :设置是否开启缩放
• addData(List t, boolean isFoot) :添加新数据
• setSelectFormat :设置选中 Cell 样式
• notifyDataChanged :重新计算布局

使用

0. 效果图

1. 前期准备

1. 在项目 build.gradle 添加 JitPack repository :

repositories 
        ...
        maven  url 'https://www.jitpack.io' 
    

2. 在 app/build.gradle 添加如下依赖库：

implementation 'com.github.huangyanbin:SmartTable:2.2.0'

2. 使用

1. 在布局文件中使用

<com.bin.david.form.core.SmartTable
        android:id="@+id/table"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"/>

2. 通过注解的方式模拟数据

@SmartTable(name = "销售计划表")
public class UserInfo 
    //    name：版块名称，count：目标值，restaurant：餐饮数量，ka：KA数量，wholesale：流通批发数量，industry：工业加工数量，other：其它数量
    @SmartColumn(id = 0, name = "部门/渠道", autoMerge = true)
    private String city;
    @SmartColumn(id = 1, name = "板块")
    private int name;
    @SmartColumn(id = 2, name = "目标值")
    private int count;
    @SmartColumn(id = 3, name = "餐饮")
    private int restaurant;
    @SmartColumn(id = 4, name = "KA")
    private int ka;
    @SmartColumn(id = 5, name = "流通批发")
    private int wholesale;
    @SmartColumn(id = 6, name = "工业加工")
    private int industry;
    @SmartColumn(id = 7, name = "其他")
    private int other;

    public UserInfo(String city, int name, int count, int restaurant, int ka, int wholesale, int industry, int other) 
        this.city = city;
        this.name = name;
        this.count = count;
        this.restaurant = restaurant;
        this.ka = ka;
        this.wholesale = wholesale;
        this.industry = industry;
        this.other = other;
    

3. 使用

public class TableActivity extends AppCompatActivity 
    private SmartTable table;

    private List<UserInfo> list;

    @Override
    protected void onCreate(Bundle savedInstanceState) 
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_table);

        initData();

        table = findViewById(R.id.table);

        table.setData(list);

        table.getConfig().setContentStyle(new FontStyle(50, Color.BLUE));
    

    private void initData() 
        list = new ArrayList<>();
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("乌鲁木齐",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("乌鲁木齐",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("乌鲁木齐",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("乌鲁木齐",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));
        list.add(new UserInfo("沈阳",100, 150, 50, 240, 1100, 450, 23458));