Selectable dynamic table

The selectable dynamic table is an easy-to-use, lightweight library that lets you create a scrollable and customizable table with a static header and indexes, you can also select its rows and the cells as shown below.

Demos

Static header and indexes	Selectable cells and rows

Features:

• Dynamic rows and columns based on given data
• Selectable cells and rows
• Static header and indexes
• Can hide header and indexes
• Can disable selectable cells and rows
• Support for API Level 16+
• Highly customizable
• Lightweight and easy-to-use

Usage

Put selectable-dynamic-table in your desired XML file:

XML

    <dev.fazelx.selectable_dynamic_table.TableView
    android:id="@+id/selectableDataTableView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
/>

Then in your Java or Kotlin code create a list of list of Cell models (List<List>) and a list of Strings as headers, and pass them to the table using setData(headers, data) method.

In a Cell object, you should set an id, content that will be shown in the table cell, and a data parameter which basically can be anything.

After that use your desired customizing methods and then call fillToTable() method.

binding.selectableDataTableView.setData(headersList, dataList)
binding.selectableDataTableView.setSelectingStatus(selectableRow = true, selectableCell = true)
binding.selectableDataTableView.setRadius(15f)
binding.selectableDataTableView.setMaxVisibleItems(5)
...//other customizing methods
binding.selectableDataTableView.fillToTable()

You can access selected row or cell data by setting the proper listener to the selectable-dynamic-table like below:

set listener to row select status change:

//Set listener to get the data of the selected row, or notified when the selected row is unselected
binding.selectableDataTableView.setOnRowSelectChangeListener { isSelected , rowData, pos ->
    if (isSelected) {
        //do something
    }
}

set listener to cell select status change:

//set listener to get the data of the selected cell, or notified when the selected cell unselected
binding.selectableDataTableView.setOnCellSelectChangeListener { isSelected, cell ->
    if (isSelected) {
        //do something
    }
}

Check out the Sample app, for more information.

Gradle

• This library is available on jitpack.io . To use it

Step 1. Add JitPack repository to your root build.gradle at the end of repositories:

allprojects {
  repositories {
   ...
   maven { url 'https://jitpack.io' }
  }
 } 

Step 2. Add the following to ypur app level build.gradle

dependencies {
    implementation 'com.github.fazelx:selectable-dynamic-table:1.0'
}

XML

    <dev.fazelx.selectable_dynamic_table.TableView
    android:id="@+id/selectableDataTableView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:has_border="true"
    app:border_color="@color/black"
    app:rows_height="55dp"
    app:header_height="75dp"
/>

OR Programmatically

Contribute

Users are welcome to suggest ideas or feature requests or report bugs and issues here

I am always open to new suggestions and good contributions.

Contact

Feel free to reach out to me at fazelhey@gmail.com

License:

Copyright 2023 Fazel Heidari

   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.