In-place substitute for Flutter's stock DataTable and PaginatedDataTable widgets with fixed/sticky header/top row (and footer/paginator for PaginatedDataTable) and a few extra features. DataTable2 and PaginatedDataTable2 widgets are based on the sources of Flutter's originals, mimic the API and provide seamless integration.

If you've been using (or considered using) standard Flutter's widgets for displaying tables/data grids and missed the sticky headers - you've come to the right place. No need to learn yet another API of a new control, just stick to well described DataTable/PaginatedDataTable.

LIVE DEMO

image

- please check the example folder which recreates the Flutter Gallery's Data Table sample (with PgaintedDataTable and DataSource) as well as has a few more samples. There's also a DataGrid Sample in separate repo.

Differences

The differences/distrinctions from stock widgets:

  • Sticky headers (both widgets) and paginator (PabinatedDataTable2 only)
  • Vertiacally scrollable main area (with data rows)
  • All columns are fixed width, table automatically stretches horizontaly, individual column width is determined as (Width)/(Number of Columns)
    • Should you want to adjust sizes of columns, you can replace DataColumn definitions with DataColumn2 (which is a decendant of DataColumn). The class provides size property which can be set to one of 3 relative sizes (S, M and L)
    • You can limit the minimal width of the control and scroll it horizontaly if the viewport is narrow (by setting minWidth property) which is useful in portrait orientations with multiple columns
    • You can add bottom margin (by setting bottomMargin property) to allow slight overscroll
    • Fixed width columns are faster than default implementation of DataTable which does 2 passes to determine contents size and justify column widths
  • Data rows are wrapped with Flexible and SingleScrollView widgets to allow widget fill parent container and scroll
    • Vertical scroller is exposed via table's scrollController property. See example 'DataTable2 - Scroll-up' which shows 'up' button when scrolling down and allows to jump to the top of the table
  • There's DataRow2 alternative to stock DataRow which provide row level tap events (including right clicks)

Usage

  1. Add reference to pubspec.yaml.

  2. Import:

import 'package:data_table_2/data_table_2.dart';
  1. Code:
import 'package:data_table_2/data_table_2.dart';
import 'package:flutter/material.dart';
import 'package:flutter/rendering.dart';

/// Example without datasource
class DataTable2SimpleDemo extends StatelessWidget {
  const DataTable2SimpleDemo();

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(16),
      child: DataTable2(
          columnSpacing: 12,
          horizontalMargin: 12,
          minWidth: 600,
          columns: [
            DataColumn2(
              label: Text('Column A'),
              size: ColumnSize.L,
            ),
            DataColumn(
              label: Text('Column B'),
            ),
            DataColumn(
              label: Text('Column C'),
            ),
            DataColumn(
              label: Text('Column D'),
            ),
            DataColumn(
              label: Text('Column NUMBERS'),
              numeric: true,
            ),
          ],
          rows: List<DataRow>.generate(
              100,
              (index) => DataRow(cells: [
                    DataCell(Text('A' * (10 - index % 10))),
                    DataCell(Text('B' * (10 - (index + 5) % 10))),
                    DataCell(Text('C' * (15 - (index + 5) % 10))),
                    DataCell(Text('D' * (15 - (index + 10) % 10))),
                    DataCell(Text(((index + 0.1) * 25.4).toString()))
                  ]))),
    );
  }
}

If you're already using the stabndard widgets you can reference the package and add '2' to the names of the stock widgets (making them DataTable2 or PaginatedDataTable2) and that is it.

Libraries

data_table_2
paginated_data_table_2