getuget/sticky-headers-table

Table with sticky headers

table_sticky_headers

This package for Flutter allows you to display two-dimension table with both sticky headers.

Key of this package is sticky headers. You can scroll table any direction and headers (top and left) will always stay. Cells themselves are fully customizable as you can fill them with Widgets.

To work with table you need to fill it with data. It has three builders for generating title column (List), title row (List) and content itself (List.

Simplest UseCase. You have two-dimensional array of Strings. Builder takes value from array and generates Text widget:

contentCellBuilder: (i, j) => Text(data[i][j]),

For more advanced usage - decorate Text with other widgets like borders, cell colors, etc. Check decorated_example.dart to see it in action. You can also wrap cell with tap listeners and add custom behavior on tap. Check tap_handler_example.dart.

The cell dimensions can be customized using the cellDimensions property of StickyHeadersTable. Use:

• CellDimensions.base: Default fixed values.
• CellDimensions.uniform: Same dimensions for each cell.
• CellDimensions.fixed: Custom fixed width and height for each content cell.
• CellDimensions.variableColumnWidth: Different width for each column.
• CellDimensions.variableRowHeight: Different height for each row.
• CellDimensions.variableColumnWidthAndRowHeight: Different width for each column and different height for each row.

The alignment of the cell contents can be customized using the cellAlignments property of StickyHeadersTable. Use:

• CellAlignments.base: Default alignment value (Alignment.center).
• CellAlignments.uniform: Same alignment for each cell.
• CellAlignments.fixed: Same alignment for each content cell, but different alignment for the sticky column, row and legend.
• CellAlignments.variableColumnAlignment: Different alignment for each column.
• CellAlignments.variableRowAlignment: Different alignment for each row.
• CellAlignments.variable: Different alignment for every cell.

Feature requests and PRs are welcome.

Widget usage example:

// titleColumn - List<String> (title column)
// titleColumn - List<String> (title row)
// titleColumn - List<List<String>> (data)

StickyHeadersTable(
          columnsLength: titleColumn.length,
          rowsLength: titleRow.length,
          columnsTitleBuilder: (i) => Text(titleColumn[i]),
          rowsTitleBuilder: (i) => Text(titleRow[i]),
          contentCellBuilder: (i, j) => Text(data[i][j]),
          legendCell: Text('Sticky Legend'),
        ),

Visit examples to see it in details

Support

Please file issues and feature requests.

Getting Started

This project is a starting point for a Dart package, a library module containing code that can be shared easily across multiple Flutter or Dart projects.

For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.