Skip to main content

Data Grid

FdcGrid is the data-aware grid surface in Flutter Data Components. It binds directly to an FdcDataSet, so navigation, editing, validation, filtering, sorting, searching, and persistence all share the same data state.

Choose the grid widget​

Community applications use FdcGrid. When a grid needs Pro-owned functionality, import the Pro package and use FdcProGrid instead:

import 'package:flutter_data_components/fdc.dart';
import 'package:flutter_data_components_pro/fdc_pro.dart';

FdcProGrid(
  dataSet: customers,
  columns: customerColumns,
  detailRow: customerDetailRow,
  rangeSelection: const FdcGridRangeSelection(),
)

FdcProGrid composes the complete Community grid surface and adds Pro configuration points such as detail rows, range selection, and layout persistence. It is a direct replacement for FdcGrid on grids that need those capabilities; do not wrap one grid widget inside the other.

FdcGrid(
  dataSet: customers,
  columns: const [
    FdcIntegerColumn<dynamic>(
      fieldName: 'id',
      label: 'ID',
      width: 80,
      readOnly: true,
    ),
    FdcTextColumn<dynamic>(
      fieldName: 'company',
      label: 'Company',
      width: 240,
    ),
    FdcTextColumn<dynamic>(
      fieldName: 'city',
      label: 'City',
      width: 160,
    ),
  ],
)

The grid does not copy dataset records into a second state model. Cell edits write through the dataset edit buffer, row navigation follows dataset lifecycle rules, and adapter-backed operations stay inside the same query flow.

Community and Pro capabilities​

The core FdcGrid includes columns, editing, validation feedback, filtering, sorting, search, row selection, summaries, column grouping, pinning, resizing, keyboard navigation, theming, toolbar and status-bar composition.

Pro capabilities appear in the same documentation flow where they belong. Use FdcProGrid when the grid itself needs detail rows, range selection, or layout persistence. Pro column types such as rating and sparkline columns can be included in its normal columns collection.