Skip to content

Latest commit

 

History

History
115 lines (85 loc) · 4.38 KB

README.md

File metadata and controls

115 lines (85 loc) · 4.38 KB
Raw

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.
  • Clicks are passed to children views.
  • 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

Bonus Feature

The FixedHeaderSubTableLayout behaves like a normal TableLayout But it gives you direct access to the cell sizes.

Thus it is possible to align cells between independent tables allowing you to build more complicated tables with borders easier, easily split tables across print pages, viewpager, etc by using modular groups of aligned tables next to each other. It also allows a form of column spanning, a column in one table can be made to be the size of multiple columns in the adjacent table, so it looks like column spanning.

Some examples in the MultiTableExample in the Example App.

Feature TODO list

  • 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()
        mavenCentral()
    }
}

Add the following dependency into your module's build.gradle:

dependencies {
    implementation 'com.github.Zardozz:fixedheadertablelayout:0.0.0.5'
}

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.