Fixed Header Table Layout for Android
FixedHeaderTableLayout is a powerful Android library for displaying complex data structures and rendering tabular data composed of rows, columns and cells with multi direction scrolling and zooming.
This repository also contains a sample app that is designed to show you how to create your own FixedHeaderTableLayout in your application.
FixedHeaderTableLayout is similar in construction and use as to Android's TableLayout
Note
This Library is current in development and is considered in an Alpha state
Features
- 1 to X number of rows can be fixed as column headers at the top of the table
- 1 to X number of rows can be fixed as row headers at the left of the table
- Multi direction scrolling is available if the table is larger than the screen
- Pinch Zoom is available
- Standard scrollbars are available
- Each column width value will be automatically adjusted to fit the largest cell in the column.
- Each row height value will be automatically adjusted to fit the largest cell in the row.
- Support for API 16 upwards
Feature TODO list
- Nothing is clickable in the table yet.
- Scale around pinch center.
- Corner layout location and layout direction to support Right to Left Languages
- Some type of column span (Nested Tables) support
- Making the fixed headers optional (at least one of each is required at the moment)
- Documentation
- Automated Tests
- Probably lots more
Limitations
- As per Android's TableLayout constructing/drawing very large tables takes some time.
What's new
You can check new implementations of TableView
on the release page.
Installation
To use this library in your Android project
Add Maven Central to the project's build.gradle
:
allprojects {
repositories {
google()
jcenter()
mavenCentral()
}
}
Add the following dependency into your module's build.gradle
:
dependencies {
implementation 'com.github.Zardozz:fixedheadertablelayout:0.0.0.2'
}
Documentation
Please check out the project's wiki.
Contributors
Contributions of any kind are welcome!
If you wish to contribute to this project, please refer to our contributing guide.
License
MIT License
Copyright (c) 2021 Andrew Beck
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.