Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zhouchaoyuan/excelPanel
An Android's two-dimensional RecyclerView. Not only can load historical data, but also can load future data.
https://github.com/zhouchaoyuan/excelPanel
Last synced: 3 months ago
JSON representation
An Android's two-dimensional RecyclerView. Not only can load historical data, but also can load future data.
- Host: GitHub
- URL: https://github.com/zhouchaoyuan/excelPanel
- Owner: zhouchaoyuan
- License: apache-2.0
- Created: 2017-01-15T14:36:50.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-06-14T03:29:17.000Z (over 1 year ago)
- Last Synced: 2024-06-16T02:43:00.603Z (5 months ago)
- Language: Java
- Homepage:
- Size: 7.49 MB
- Stars: 2,412
- Watchers: 41
- Forks: 345
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - excelPanel - 仿Excel表格的RecyclerView (表格(Table))
README
# excelPanel
A two-dimensional RecyclerView. Not only can load historical data, but also can load future data.
# Including in your project
```xml
compile 'cn.zhouchaoyuan:excelpanel:1.0.5'
```
# Usage
### 1、Write in xml
```xml
```
Configure using xml attributes
```xml
app:left_cell_width //left header cell's width, not support wrap_content
app:normal_cell_width //container cell's width, not support wrap_content
app:top_cell_height //top header cell's height, not support wrap_content
```
### 2、Define your Custom Adapter
Your adapter must extends BaseExcelPanelAdapter and override seven methods show as follow:
```java
public class Adapter extends BaseExcelPanelAdapter{
public Adapter(Context context) {
super(context);
}
//=========================================normal cell=========================================
@Override
public RecyclerView.ViewHolder onCreateCellViewHolder(ViewGroup parent, int viewType) {
return null;
}
@Override
public void onBindCellViewHolder(RecyclerView.ViewHolder holder, int verticalPosition, int horizontalPosition) {
}
//=========================================top cell===========================================
@Override
public RecyclerView.ViewHolder onCreateTopViewHolder(ViewGroup parent, int viewType) {
return null;
}
@Override
public void onBindTopViewHolder(RecyclerView.ViewHolder holder, int position) {
}
//=========================================left cell===========================================
@Override
public RecyclerView.ViewHolder onCreateLeftViewHolder(ViewGroup parent, int viewType) {
return null;
}
@Override
public void onBindLeftViewHolder(RecyclerView.ViewHolder holder, int position) {
}
//=========================================top left cell=======================================
@Override
public View onCreateTopLeftView() {
return null;
}
}
```
### 3、Use your Adapter
```java
//==============================
private List rowTitles;
private List colTitles;
private List> cells;
private ExcelPanel excelPanel;
private CustomAdapter adapter;
private View.OnClickListener blockListener
//..........................................
excelPanel = (ExcelPanel) findViewById(R.id.content_container);
adapter = new CustomAdapter(this, blockListener);
excelPanel.setAdapter(adapter);
excelPanel.setOnLoadMoreListener(this);//your Activity or Fragment implement ExcelPanel.OnLoadMoreListener
adapter.setAllData(colTitles, rowTitles, cells);
adapter.enableFooter();//load more, you can also call disableFooter()----default
adapter.enableHeader();//load history, you can also call disableHeader()----default
```
If using setOnLoadMoreListener(...) and enableHeader() you must call addHistorySize(int) to tell ExcelPanel how many data have been added.
# ChangeLog
- V1.0.1--------------Line i can be different to line i+1, but the same line's height must be equals
- V1.0.2--------------Support different viewType which using to config different row with different height
- V1.0.3--------------Remove adjust height, fix bug when excelPanel in ViewPager
- V1.0.4--------------Optimizing rolling
- V1.0.5--------------addOnScrollListener
# License
```xml
Copyright 2017 zhouchaoyuan
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
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
limitations under the License.
```