Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/huangyanbin/smarttable
一款android自动生成表格框架---An Android automatically generated table framework
https://github.com/huangyanbin/smarttable
android android-library android-table android-view annotation table table-lib table-library
Last synced: 6 days ago
JSON representation
一款android自动生成表格框架---An Android automatically generated table framework
- Host: GitHub
- URL: https://github.com/huangyanbin/smarttable
- Owner: huangyanbin
- Created: 2017-11-08T01:11:14.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-03-11T09:08:26.000Z (almost 3 years ago)
- Last Synced: 2025-01-02T23:05:39.675Z (6 days ago)
- Topics: android, android-library, android-table, android-view, annotation, table, table-lib, table-library
- Language: Java
- Homepage: https://juejin.im/post/5a5dce7651882573256bd043
- Size: 61 MB
- Stars: 5,177
- Watchers: 108
- Forks: 861
- Open Issues: 203
-
Metadata Files:
- Readme: README.en.md
Awesome Lists containing this project
README
# SmartTable
[](https://jitpack.io/#huangyanbin/smartTable)
###### An Andr oid automatically generated table framework
* [Chinese README](/README.md/)
* [Apk download version1.7](/img/smartTable.apk)
* [Version of history](/README_old_version_en.md/)
> function introduction
1. fast configuration automatic generation of tables;
2. automatic calculation table width;
3. table column header combination;
4. the table holds the left sequence, the top sequence, the first row, the column heading, and the statistics row;
5. automatic statistics, sort (also can customize the statistical rules);
6. format graphic, serial number, column title formatting;
7. configuration, background, text, grid, padding and so on;
8. form notation;
9. table content, column title click event;
10. zoom mode and scroll mode;
11. annotation mode;
12. contents are displayed in many lines.
13. pagination mode;
14. dynamically added data at the end of the end.
15. rich formatting;
16. support two dimensional array display (for similar timetable, film ballot, etc.)
17. import excel (support color, font, background, annotation, alignment, picture and other basic Excel attributes)
18. form merge unit (supporting annotating merge, supporting auto merge)
19. support the other refresh framework SmartRefreshLayout
20. the minimum width of a configurable table (less than the width of this width)
21. support direct List or array field columns
22. JSON data direct conversion table
> Basic function display
> Zoom function
> refresh function(Use SmartRefreshLayout)
> Import Excel (using Jxl jar)
> Importing a two-dimensional array
> List or array column
> How Use
- Quote
> * Step 1. Add the JitPack repository to your build file
```gradle
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
```
> * 2. Add the dependency
```gradle
dependencies {
compile 'com.github.huangyanbin:SmartTable:1.8.3'
}
```
> * Use SmartTable
```
```
**- Annotation mode**
> * Add annotations to the class that you need to generate
```
@SmartTable(name="table name")
```
> * Add notes to fields you need to display
```
// ID sorts the table for the table in which the field is located
@SmartColumn(id =1,name = "ColumnName")
```
> * Setting table data
```
table = findViewById(R.id.table);
table.setData(list);
```
> The annotation pattern is so simple that you can run directly to see the effect. Of course, this is just the basic configuration of annotations. There are also automatic statistics, column combinations, and so on. If you want to know more about the annotation, please check the demo.
Table ```@SmartTable``` ###### notes, used to generate the table.
Header 1 header 2 |
---|---
Name | table name
Count is | statistics for
PageSize | page number
CurrentPage | the current page
###### ```@SmartColumn``` column for comment column.
Note | effect
---|---
Name | column headings
ID | position (column sorting is smaller at the front)
Parent | parent column name (not set no parent column)
Align | column alignment
Type | query set whether the next level
AutoMerge | is set to automatically merge
With the maximum number of maxMergeCount |
AutoCount | is on statistics
Whether the column fixed | fixed
> explanation:
- align
> set the column alignment, default Center
- type
> ColumnType.Own, ColumnType.Child two, a value can be set, assuming that UserInfo has an attribute Family family object, you want to attribute monther parsing faily object, father two properties, you need to set the Child, and in monther, add the corresponding notes @ SmartColumn father, otherwise only resolved to Family, the default is Own.
- autoMerge
If the data that you return is formatted, the same data near the column will be automatically merged into a cell that does not open the merge by default.
- autoCount
> table opens the display statistics line and sets the autoCount to true, then the column can be automatically counted, and the default is false.
- Fixed
> fixed is set to true, which can be automatically fixed when the column rolls to the left.
**- Basic mode**
```
//Common column
Column column1 = new Column<>("name", "name");
Column column2 = new Column<>("age", "age");
Column column3 = new Column<>("time", "time");
Column column4 = new Column<>("portrait", "portrait");
//Combination column
Column totalColumn1 = new Column("Combination name",column1,column2);
//tableData Datas is the data that needs to be filled
final TableData tableData = new TableData<>("表格名",userList,totalColumn1,column3);
//set data
table = findViewById(R.id.table);
//table.setZoom(true,3);//boolean isZoom
table.setTableData(tableData);
```
**- Basic method introduction**
There are two parameters in the > ```Column``` construction method, ```IFormat```, ```IDrawFormat```. ```IFormat``` is used to format the display text, such as the update time field ```time``` timestamp in the ```User``` object. We can rewrite this method if we want to display different formats. ```IDrawFormat``` is used to display the drawing format, such as ```User``` object avatars in the field ```portrait``` time stamp, you can use this method, provides a framework for including several ```IDrawFormat``` (text, Bitmap, Resoure pictures, with pictures).
> ```Column``` provides
1. whether the automatic sorting ```setAutoCount (Boolean isAutoCount).
2. whether to arrange ```isReverseSort``` in reverse order
3. set sort compare ```setComparator```
4. statistical formatting ```setCountFormat```
5. click event ```OnColumnItemClickListener```
The basic methods in > ```TableData```
1. set sequence ```setSortColumn```
2. set column headings to format ```settitleDrawFormat```
3. set the top serial number to format ```setXSequenceFormat```
4. set the left serial number to format ```setYSequenceFormat```
5. sets whether to display statistics ```setShowCount```
The basic methods in > ```TableConfig```
1. set content text style ```setContentStyle```
2. set the left sequence text style ```setYSequenceStyle```
3. set top sequence text style ```setXSequenceStyle```
4. set column heading text style ```setColumnTitleStyle```
5. set table title text style ```setTableTitleStyle```
6. set statistics row style ```setCountStyle```
7. set column header grid style ```setColumnTitleGridStyle```
8. set table grid style ```setGridStyle```
9. set grid column padding ```setVerticalPadding```
10. set grid row padding ```setHorizontalPadding```
11. set left sequence background ```setYSequenceBackgroundColor```
12. set right sequence background ```setXSequenceBackgroundColor```
13. set column header background ```setColumnTitleBackgroundColor```
14. set content background ```setContentBackgroundColor```
15. setting statistics row background ```setCountBackgroundColor```
16. fixed left ```setFixedYSequence```
17. fixed top ```setFixedXSequence```
18. fixed column headings ```setFixedTitle.
19. fixing the first column ```setFixedFirstColumn```
20. fixed statistics row```setFixedCountRow```
### summary
After writing SmartChart, you have a further understanding of Android drawing. To do SmartTable, just a small demo, after a week of work stealing a write, basically completed the main function table, there have been combined with other functions, because behind not using, then only the beginning design function, has to meet the daily needs.
> the use of tables in Android is very few, and the main screen is out of one page, and the user experience is bad. In the implementation process, try to experience a better sense, I feel through fixed title and first line experience is best, so the default set fixed. Of course, you can set it yourself. There are a lot of pits in it. I hope friends in need can use it.
## *License*
SmartTable is released under the Apache 2.0 license.
```
Copyright 2017 Huangyanbin.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at following link.
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitat