fdc library

High-performance RAD data components for Flutter data applications.

This is the primary Community entrypoint. It exposes datasets, data-aware editors, grids, filtering, sorting, searching, aggregates, export support, localization, focus management, and shared theme APIs through one stable import:

import 'package:flutter_data_components/fdc.dart';

A typical application defines an FdcDataSet, binds an FdcGrid or editor controls to it, and optionally uses an adapter when data must be loaded or applied through an external source. Lightweight entrypoints are also available for app configuration, editors, and export-only integrations.

Classes

FdcActionColumn
Grid column that renders standardized row-level actions.
FdcApp
App/subtree-level settings scope for Flutter Data Components.
FdcBadgeColumn<T>
Grid column that renders field values as compact badge labels.
FdcBadgeValue
Value object for badge editors when text, color, icon, or text style varies per row.
FdcBinaryExportPayload
Binary payload returned by writers such as PDF or spreadsheet exporters.
FdcBooleanColumn<T>
Grid column for boolean fields with checkbox or switch-style interaction.
FdcBooleanEdit
Data-aware editor for boolean dataset fields.
FdcBooleanField
Boolean dataset field definition.
FdcCellContext
Runtime cell context passed to FdcCustomColumn.cellBuilder.
FdcChangeSet
Immutable collection of pending dataset insert, update, and delete actions.
FdcChangeSetEntry
One inserted, updated, or deleted record in an FdcChangeSet.
FdcColumnFilterConfig
Per-column configuration for grid-managed header filtering.
FdcColumnSummary
Per-column summary configuration.
FdcColumnValueChangedContext<T>
Grid-column context supplied after the primary edited value has been written locally.
FdcColumnValueChangingContext<T>
Grid-column context supplied before an edited value is written to the dataset.
FdcComboColumn<T>
Grid column for fields whose values come from a predefined option set.
FdcComboEdit<T>
Data-aware selection editor backed by a predefined set of options.
FdcComboSearchOptions
Search configuration for combo editors and combo grid columns.
FdcCommonTranslations
Common FDC text shared by multiple component families.
FdcConfirmationDialog
Modal yes/no confirmation dialog using FDC translations and button styling.
FdcCounterStyle
Visual style for text-length counters used by editors and grid cells.
FdcCustomColumn<T>
Field-bound custom column.
FdcDataAdapter
Contract between an FdcDataSet and an external data source.
FdcDataAdapterCapabilities
Declares which query and aggregate operations an adapter can execute.
FdcDataAdapterFilter
Source-level filter descriptor passed to a data adapter.
FdcDataAdapterSort
Source-level ordering descriptor passed to a data adapter.
FdcDataAggregateItem
One aggregate expression requested from an adapter.
FdcDataAggregateKey
Stable key identifying one aggregate expression and its result value.
FdcDataAggregateRequest
Adapter aggregate request over the full effective query result set.
FdcDataAggregateResult
Values returned for an FdcDataAggregateRequest.
FdcDataApplyError
Structured error for a record rejected during adapter apply.
FdcDataApplyFailure
Failed adapter apply result containing structured row-level errors.
FdcDataApplyResult
Result returned by IFdcDataAdapter.applyUpdates().
FdcDataApplySuccess
Successful adapter apply result.
FdcDataLoadRequest
Query request sent by a dataset to an adapter.
FdcDataLoadResult
Rows and paging metadata returned by an adapter load.
FdcDataPagingOptions
Configures adapter-backed dataset paging.
FdcDataRecordKey
Stable dataset/business key used for adapter-aware row selection.
FdcDataSet
Flutter-friendly in-memory dataset with typed schema metadata, edit lifecycle management, validation, filtering, sorting and cached updates.
FdcDataSetAggregatesApi
Public aggregate facade for FdcDataSet.
FdcDataSetBookmark
An immutable position marker for a record in an FdcDataSet.
FdcDataSetBookmarksApi
Public bookmark facade for FdcDataSet.
FdcDataSetError
Read-only dataset error entry emitted by the dataset error pipeline.
FdcDataSetErrorMessagesApi
Read-only message view over the current FdcDataSet errors.
FdcDataSetErrorsApi
Public error-message facade for FdcDataSet.
FdcDataSetFilter
Describes one field predicate in the active dataset filter.
FdcDataSetFilterContext
Runtime context used while preparing and evaluating dataset filters.
FdcDataSetFilters
Dataset-level filter API.
FdcDataSetOperationOptions
Tunables for long-running dataset operations.
FdcDataSetPagingApi
Public paging facade for FdcDataSet.
FdcDataSetSearchApi
Dataset-level global search API.
FdcDataSetSearchState
Immutable dataset search state.
FdcDataSetSelectionApi
Public row-selection facade for FdcDataSet.
FdcDataSetSort
Describes one field ordering rule in the active dataset sort.
FdcDataSetSorts
Dataset-level sort API.
FdcDataSetWork
Lightweight observable work state owned by a dataset.
FdcDataSetWorkInfo
Immutable snapshot for a dataset work lifecycle transition.
FdcDateColumn<T>
Grid column specialized for date-only dataset fields.
FdcDateEdit
Data-aware editor for date-only dataset fields.
FdcDateField
Dataset field metadata for date-only values.
FdcDateTimeColumn<T>
Grid column for date-and-time fields with locale-aware display and editing.
FdcDateTimeEdit
Data-aware editor for full date-and-time dataset fields.
FdcDateTimeField
Date-and-time dataset field definition storing full DateTime values.
FdcDecimal
Fixed-scale decimal value used by decimal field runtime values.
FdcDecimalColumn<T>
Grid column for fixed-precision decimal fields with numeric formatting and editing.
FdcDecimalEdit
Data-aware editor for decimal dataset fields.
FdcDecimalField
Decimal field metadata.
FdcDefaultFormatResolver
Default FDC format resolver.
FdcDefaultTranslationResolver
Default built-in FDC translation resolver.
FdcDialogTranslations
Dialog text resources.
FdcEditorComboPopupStyle
Visual styling for combo-editor popup surfaces, search UI, and option rows.
FdcEditorControlsStyle
Visual styling for non-text editor controls such as boolean and combo UI.
FdcEditorInputStyle
Visual styling for text-like FDC editor inputs.
FdcEditorTheme
Optional Flutter ThemeExtension bridge for FDC editors.
FdcEditorThemeData
Complete visual theme for standalone FDC editors.
FdcEditorThemes
Built-in editor theme presets supplied by FDC.
FdcErrorIndicatorMarker
Small top-left error marker shared by grid cells and standalone editors.
FdcErrorIndicatorMarkerStyle
Visual styling for the compact triangular validation marker.
FdcErrorIndicatorOptions
Configures how a component presents validation and data-entry errors.
FdcExportColumn
Maps one source field to its exported identity and presentation metadata.
FdcExporter
Coordinates FDC exports by resolving rows, columns and format writers.
FdcExportFormat
Export output format descriptor.
FdcExportFormatStyle
Base type for format-specific visual export styles.
FdcExportOptions
Cross-format options that control row selection, column selection and text serialization behavior for FDC exports.
FdcExportPayload
Serialized content produced by an FdcExportWriter.
FdcExportRegistry
Global registry of export writers available to FDC.
FdcExportResult
Completed export together with its format metadata and serialized payload.
FdcExportStyle
App- or subtree-level default styles resolved by export writers.
FdcExportWriter
Contract implemented by built-in and extension export format writers.
FdcExportWriterContext
Immutable export request passed to an FdcExportWriter.
FdcExportWriterOptions
Marker base type for format-specific writer configuration.
FdcField
Runtime accessor for a dataset field on the current record/edit buffer.
FdcFieldContext<T>
Runtime field context passed to FdcCustomColumn.cellBuilder.
FdcFieldDef
Base metadata definition for a dataset field.
FdcFieldFocusContext<T>
Context supplied when a dataset-bound field gains or loses focus.
FdcFieldStorage
Storage/persistence metadata for a dataset field.
FdcFieldValueChangeAccepted<T>
Accepts the proposed field value without replacing it.
FdcFieldValueChangeCanceled<T>
Rejects a proposed field change, optionally with a user-facing message.
FdcFieldValueChangedContext<T>
Read-only context emitted after a field value change has been accepted.
FdcFieldValueChangeReplacement<T>
Accepts a field change but substitutes a different value.
FdcFieldValueChangeResult<T>
Decision returned from an onValueChanging callback.
FdcFieldValueChangingContext<T>
Mutable context supplied before a proposed field value is committed.
FdcFilterBuilder
Fluent AND-only builder for dataset filters.
FdcFilterConditionBuilder
Fluent condition step for one dataset field.
FdcFilterOperatorTranslations
Header filter operator text resources.
FdcFilterOrderStep
Ordering step returned while composing a fluent filter query.
FdcFilterRangeValue
Raw two-ended value used by the grid header range filter editor.
FdcFocusOptions
App/subtree-level focus behavior defaults for Flutter Data Components.
FdcFocusScope
Subtree-level FDC focus options provider.
FdcFormatResolver
Resolves FDC data-entry formats from a Flutter locale.
FdcFormatSettings
Formatting settings applied to flutter_data_components widgets.
FdcGrid
High-performance data grid widget from the Community package.
FdcGridButton
Standard action button that can be placed in a grid toolbar or status bar.
FdcGridCellIndicator
Configures the visual indicator drawn around or beside the focused grid cell.
FdcGridCellIndicatorStyle
Configures active-cell indicator colors and geometry for grid interaction states.
FdcGridCellPointerContext
Immutable context supplied by grid cell pointer callbacks.
FdcGridCellStyle
Visual style applied to data cells in a column.
FdcGridColumn<T>
Base metadata shared by every grid column type.
FdcGridColumnGroup
Visual definition for a column group rendered in the grid header.
FdcGridColumnGroupStyle
Visual styling for a single FdcGridColumnGroup header cell.
FdcGridColumnPinning
Configures interactive column pinning and labels for pinned header bands.
FdcGridController
Public runtime command surface for an FdcGrid.
FdcGridControlsStyle
Shared visual metrics and colors for grid-owned buttons and compact controls.
FdcGridCustomItem
Fully custom widget item for a grid toolbar or status bar.
FdcGridExportButton
Built-in toolbar item that exports dataset rows through the FDC export pipeline.
FdcGridFilterOptions
Configures default operator and debounce behavior for grid-managed filters.
FdcGridHeader
Configuration for the grid header region and its column-header behavior.
FdcGridHeaderFilters
Configures visibility and styling of the grid-managed header filter row.
FdcGridHeaderFilterStyle
Visual configuration for the optional filter row below grid headers.
FdcGridHeaderStyle
Visual configuration for column headers, separators, and header interaction states.
FdcGridItem
Base class for items rendered inside a grid toolbar or status bar.
FdcGridMainMenuButton
Built-in toolbar item that exposes the grid main menu.
FdcGridMenuContext
Read-only context supplied to grid and column body-cell context menus.
FdcGridOptions
Behavioral and layout options for an FdcGrid.
FdcGridPageSizeSelector
Selects the dataset page size while preserving the first visible global record offset where possible.
FdcGridPagingNavigator
Page navigation control for adapter-backed dataset paging.
FdcGridPagingRecordInfo
Displays the global record range of the currently loaded page.
FdcGridPopupMenuStyle
Colors and state styling for grid popup and column menus.
FdcGridProgressBar
Dataset work progress indicator for the grid status bar.
FdcGridProgressStyle
Placement and text presentation options for dataset progress shown by a grid.
FdcGridResolvedCellIndicatorStyle
Fully resolved paint values for the active-cell indicator border.
FdcGridRowContext
Lightweight, read-only row callback context used by FdcGrid callbacks.
FdcGridRowIndicator
Configures the leading grid region used for row status, numbering, selection, and the main menu.
FdcGridRowIndicatorOptions
Selects which status, numbering, and row-selection affordances appear in the row indicator.
FdcGridSearchBar
Built-in toolbar item for dataset-wide grid search.
FdcGridSeparator
Vertical separator for a grid toolbar or status bar.
FdcGridSpacer
Fixed horizontal spacing for a grid toolbar or status bar.
FdcGridStatusBar
Configures the optional grid status bar and its ordered item collection.
FdcGridStatusBarStyle
Layout and surface styling for the grid status bar and its item zones.
FdcGridStatusText
Built-in dataset status text containing record, state, filter, and sort info.
FdcGridStyle
Visual style configuration for an FdcGrid.
FdcGridSummary
Configuration for the grid summary region and aggregate presentation.
FdcGridSummaryCellStyle
Per-column visual style override for grid summary row values.
FdcGridSummaryStyle
Visual configuration for the aggregate summary row below the viewport.
FdcGridTheme
Optional Flutter ThemeExtension bridge for FdcGrid.
FdcGridThemeData
Complete visual theme preset for FdcGrid.
FdcGridThemes
Built-in FdcGrid theme presets.
FdcGridToolbar
Configuration for the optional toolbar displayed with an FdcGrid.
FdcGridToolbarStyle
Layout and search-control styling for the grid toolbar surface.
FdcGridTranslations
Grid text resources.
FdcGuid
Immutable GUID/UUID value used by GUID field runtime values.
FdcGuidField
GUID/UUID scalar field.
FdcIntegerColumn<T>
Grid column for integer fields with numeric editing and display affixes.
FdcIntegerEdit
Data-aware editor for integer dataset fields.
FdcIntegerField
Integer dataset field definition with optional inclusive range validation.
FdcKeyboardShortcut
Framework-neutral keyboard shortcut used by FDC public APIs.
FdcLocalizations
Flutter Localizations integration for FDC components.
FdcLocalizationsDelegate
Default LocalizationsDelegate for FdcLocalizations.
FdcLookupContext
Shared context passed to grid and standalone editor lookup callbacks.
FdcLookupResult
Result returned by grid and standalone editor lookup callbacks.
FdcMemoColumn<T>
Grid column specialized for long or multiline text fields.
FdcMemoEdit
Data-aware multiline editor for long text dataset fields.
FdcMemoryDataAdapter
In-memory adapter for local rows, tests, demos, and small client-side data.
FdcMenuAction
A selectable menu entry that invokes an action callback.
FdcMenuCheckAction
A checkable menu action with optional custom child content.
FdcMenuEntry
Shared internal menu entry model used by FDC controls.
FdcMenuSeparator
A non-interactive separator between logical groups of menu entries.
FdcMenuTitle
A non-interactive caption used to label a group of menu entries.
FdcMenuWidgetEntry
A menu entry that renders arbitrary child content without action semantics.
FdcMessageDialog
Modal informational dialog with a single dismiss action.
FdcObjectField
Field for custom object values that should be stored as-is in the dataset.
FdcOption<T>
Static value used by combo-like controls and filters.
FdcProgressBar
Dataset-aware progress bar for FDC shell/status surfaces.
FdcProgressBarStyle
Visual style for FdcProgressBar.
FdcProgressColumn<T>
Grid column that renders numeric values as compact progress indicators.
FdcProgressValue
Value object for progress editors when styling varies per row.
FdcRowAction
A standardized row-level action rendered by FdcActionColumn.
FdcRowActionContext
Context passed to row actions rendered by FdcActionColumn.
FdcRowContext
Public read-only row context used by calculated fields and validators.
FdcSortBuilder
Fluent builder for dataset sorting.
FdcSortOrderStep
Direction step returned while composing a fluent dataset sort.
FdcStringField
Dataset field metadata for text values.
FdcSubMenu
A menu entry that opens a nested collection of child entries.
FdcTextColumn<T>
Grid column for text dataset fields.
FdcTextEdit
Data-aware single-line editor for text dataset fields.
FdcTextExportPayload
UTF-8 text payload returned by text-based export writers.
FdcTheme
Subtree-level FDC visual theme provider.
FdcThemeData
Application/subtree-level visual theme for Flutter Data Components.
FdcTime
Time-of-day value used by FdcDataSet time fields.
FdcTimeColumn<T>
Grid column specialized for time-of-day dataset fields.
FdcTimeEdit
Data-aware editor for time-of-day dataset fields.
FdcTimeField
Dataset field metadata for time-of-day values.
FdcTranslationResolver
Resolves FDC translations for a Flutter Locale.
FdcTranslations
User-facing FDC text resources.
FdcValidationCodes
Stable validation error codes emitted by built-in dataset validators.
FdcValidationError
Structured validation failure for a field or whole record.
FdcValidationTranslations
Validation text resources.
IFdcDataAdapter
Contract implemented by dataset data adapters.
IFdcSynchronousDataAdapter
Adapter contract for sources that can execute an immediate synchronous load.

Enums

FdcAggregate
Built-in aggregate operations shared by data-aware FDC components.
FdcBooleanControl
Visual controls supported by boolean FDC editors.
FdcComboSearchMode
Defines how combo popup search matches option labels.
FdcConfirmationDefaultButton
Selects which confirmation action receives initial keyboard focus.
FdcDataAdapterFilterOperator
Operators that an adapter may receive in FdcDataAdapterFilter.
FdcDataApplyOperation
Persistent operation represented by a change-set entry.
FdcDataPageNavigation
Navigation intent for adapter paging.
FdcDataPagingMode
Dataset paging options and state helpers.
FdcDataSetOperationExecutionMode
How long-running dataset work should execute.
FdcDataSetState
Current lifecycle/editing state of an FdcDataSet.
FdcDataSetWorkMode
Whether the current dataset work can report a real percentage.
FdcDataSetWorkPhase
Coarse kind for dataset work reporting.
FdcDataType
Supported logical data types used by data-aware components.
FdcDebouncePolicy
Defines the available debounce policy values.
FdcEditorType
Supported visual editor modes.
FdcErrorIndicatorMode
Selects how a component presents validation/data-entry errors.
FdcExportScope
Row scope used by dataset/grid export operations.
FdcExportTextAlignment
Horizontal alignment hint used by presentation-oriented export writers.
FdcExportValueMode
Controls whether exported values remain typed/raw or are converted to text.
FdcFieldEventHost
Identifies the UI surface that emitted a field event.
FdcFieldFocusChangeReason
Describes why focus entered or left a dataset-bound field host.
FdcFilterEditor
Built-in header filter editor modes.
FdcFilterOperator
Supported filter operators used by data-aware components.
FdcFocusTraversalPolicy
Built-in focus traversal policy presets for FDC app/subtree scopes.
FdcGridCellIndicatorMode
Selects when the active-cell indicator is shown for editable and read-only cells.
FdcGridColumnAutoSizeMode
How a grid column participates in automatic width changes.
FdcGridColumnPin
Horizontal pinning mode for a grid column.
FdcGridExportColumnMode
Source used by the built-in grid toolbar export command.
FdcGridHorizontalAlignment
Horizontal alignment applied to a grid column.
FdcGridHorizontalScrollMode
Defines the available grid horizontal scroll mode values.
FdcGridItemPlacement
Placement zone used by shared grid items inside toolbars and status bars.
FdcGridLines
Controls which horizontal and vertical cell grid lines are rendered.
FdcGridScrollbars
Defines the available grid scrollbars values.
FdcGridSearchBarMode
Toolbar UI mode for the built-in grid search item.
FdcGridVerticalLines
Controls which vertical separators are drawn between grid regions and cells.
FdcGridVerticalScrollMode
Defines the available grid vertical scroll mode values.
FdcKeyboardKey
Keyboard keys supported by FdcKeyboardShortcut.
FdcLookupMode
Lookup invocation mode.
FdcPageRefreshMode
Controls which page is opened by FdcDataSet.paging.refreshPage.
FdcProgressBarDisplayMode
Controls how FdcProgressBar visualizes active dataset work.
FdcSearchMode
Global dataset search matching mode.
FdcSortType
Sort direction for dataset and adapter ordering.
FdcSummaryLabelAlignment
Layout of an optional summary label inside its summary cell.
FdcUpdateMode
How dataset changes are persisted through an adapter.

Extensions

FdcDecimalNumExtension on num
Convenience conversion from Dart numeric literals to FdcDecimal.
FdcDecimalStringExtension on String
Convenience conversion from decimal text to FdcDecimal.
FdcGridColumnPinProperties on FdcGridColumnPin
Adds grid column pin properties convenience APIs.

Functions

showFdcConfirmationDialog(BuildContext context, {required String title, required String message, String? yesText, String? noText, FdcConfirmationDefaultButton defaultButton = FdcConfirmationDefaultButton.no}) Future<bool>
Shows a confirmation dialog and returns whether the user confirmed.
showFdcMessageDialog(BuildContext context, {required String title, required String message, String? okText}) Future<void>
Shows an informational message dialog.

Typedefs

FdcBadgeColorBuilder<T> = Color Function(T? value)
Selects the badge color for the current cell value.
FdcBadgeTextBuilder<T> = String Function(T? value)
Builds the text displayed by a badge column for the current cell value.
FdcCalculatedFieldContext = FdcRowContext
Backwards-compatible type alias for calculated field callbacks.
FdcCalculatedFieldValue = Object? Function(FdcRowContext context)
Computes the value of a calculated field for the supplied row.
FdcCellValueFormatter = String Function(FdcGridColumn column, Object? value, {FdcColumnIdentity? runtimeColumnId})
Formats an arbitrary grid cell value for display text.
FdcColumnValueChanged<T> = void Function(FdcColumnValueChangedContext<T> context)
Column-level post-write notification.
FdcColumnValueChangeResult<T> = FdcFieldValueChangeResult<T>
Result returned by a column value-changing callback.
FdcColumnValueChanging<T> = FdcColumnValueChangeResult<T>? Function(FdcColumnValueChangingContext<T> context)
Column-level pre-write interceptor.
FdcCustomCellBuilder<T> = Widget Function(FdcFieldContext<T> field, FdcCellContext cell)
Builds a custom grid cell for a field-bound FdcCustomColumn.
FdcDataSetAfterCancel = void Function(FdcDataSet dataSet)
Called after original values have been restored, or an unposted insert has been discarded, and the dataset has returned to browse state.
FdcDataSetAfterClose = void Function(FdcDataSet dataSet)
Called after records, query state, selection, paging state, and edit buffers have been cleared and the dataset has entered the closed state.
FdcDataSetAfterDelete = void Function(FdcDataSet dataSet)
Called after an existing record has been removed or marked deleted and the dataset has returned to browse state, before listeners are notified.
FdcDataSetAfterEdit = void Function(FdcDataSet dataSet)
Called after the edit buffer has been created and the dataset entered edit state, before listeners are notified.
FdcDataSetAfterInsert = void Function(FdcDataSet dataSet)
Called after the new record has been inserted, activated, initialized with defaults, and placed in the current view, before listeners are notified.
FdcDataSetAfterOpen = void Function(FdcDataSet dataSet)
Called after an open operation has committed rows and entered browse state.
FdcDataSetAfterPost = void Function(FdcDataSet dataSet)
Called after posted values have been applied to the record and the dataset has returned to browse state, before listeners are notified.
FdcDataSetAfterScroll = void Function(FdcDataSet dataSet, int previousRecordNumber, int currentRecordNumber)
Called after the dataset current record changes through navigation.
FdcDataSetBeforeCancel = void Function(FdcDataSet dataSet)
Called before an active edit or insert buffer is discarded.
FdcDataSetBeforeClose = void Function(FdcDataSet dataSet)
Called immediately before a dataset is closed and its current view is cleared.
FdcDataSetBeforeDelete = void Function(FdcDataSet dataSet)
Called before an existing record is removed or marked deleted.
FdcDataSetBeforeEdit = void Function(FdcDataSet dataSet)
Called before the current record enters edit state and before an edit buffer is created.
FdcDataSetBeforeInsert = void Function(FdcDataSet dataSet)
Called before an inserted record is added to the record store or activated.
FdcDataSetBeforeOpen = void Function(FdcDataSet dataSet)
Called immediately before an open or reload operation begins.
FdcDataSetBeforePost = void Function(FdcDataSet dataSet)
Called before calculated values and validation are run for the active edit.
FdcDataSetBeforeScroll = void Function(FdcDataSet dataSet, int previousRecordNumber, int currentRecordNumber)
Called before the dataset current record changes through navigation.
FdcDataSetErrorEvent = void Function(FdcDataSet dataSet, List<FdcDataSetError> errors, Object? cause)
Called whenever the dataset records one or more user-visible errors.
FdcDataSetFieldChanged = void Function(FdcDataSet dataSet, FdcFieldDef field, Object? oldValue, Object? newValue)
Called after a field value changes in the active edit buffer or through a direct field-level update operation.
FdcDataSetNewRecord = void Function(FdcDataSet dataSet)
Called after a newly inserted record has been created, added to the dataset and placed in an active insert edit buffer.
FdcDataSetStateChanged = void Function(FdcDataSet dataSet, FdcDataSetState previousState, FdcDataSetState currentState)
Called synchronously whenever the dataset state value changes.
FdcDataSetValidationError = void Function(FdcDataSet dataSet, List<FdcValidationError> errors)
Called after post validation has produced one or more validation errors.
FdcDataSetValueResolver = Object? Function(Object? value)
Resolves a stored field value before local filter comparison.
FdcDataSetWorkCompleted = void Function(FdcDataSet dataSet, FdcDataSetWorkInfo work)
Called when a dataset work operation completes successfully.
FdcDataSetWorkError = void Function(FdcDataSet dataSet, FdcDataSetWorkInfo work, Object error, StackTrace stackTrace)
Called when a dataset work operation fails.
FdcDataSetWorkStarted = void Function(FdcDataSet dataSet, FdcDataSetWorkInfo work)
Called when a dataset work operation starts.
FdcDecimalPrecisionValidationMessageBuilder = String Function(int? precision, int? scale)
Builds a decimal precision and scale validation message.
FdcEditorLookup<T> = Future<FdcLookupResult?> Function(FdcLookupContext context)
Asynchronous lookup callback for a standalone data-aware editor.
FdcExportValueFormatter = String Function(Object? value)
Formats a source value as presentation text for presentation-oriented writers.
FdcFieldDefaultValueFactory = Object? Function()
Factory used by field default values that must be evaluated for each newly inserted/appended record.
FdcFieldFocusCallback<T> = void Function(FdcFieldFocusContext<T> context)
Callback invoked when focus enters or leaves a bound dataset field.
FdcFieldLimitValidationMessageBuilder = String Function(String fieldLabel, Object limit)
Builds a validation message for a field and limit value.
FdcFieldValidationMessageBuilder = String Function(String fieldLabel)
Builds a validation message for a field label.
FdcFieldValidator = String? Function(FdcRowContext row, Object? value)
Validates one field value in the context of its row.
FdcFieldValueChangedCallback<T> = void Function(FdcFieldValueChangedContext<T> context)
Callback invoked after an accepted field value change has been applied.
FdcFieldValueChangingCallback<T> = FdcFieldValueChangeResult<T>? Function(FdcFieldValueChangingContext<T> context)
Callback invoked before a proposed field value is committed.
FdcFieldValueFormatter = String Function(String fieldName, Object? value)
Formats a field value by dataset field name.
FdcFilterOptionBuilder = Widget Function(BuildContext context, FdcOption<Object?> option)
Builds the widget shown for one option in a column filter selector.
FdcGridCanEditColumn = bool Function(int rowIndex, FdcGridColumn column, FdcGridRowContext row)
Decides whether a specific column may be edited for a row.
FdcGridCanEditRow = bool Function(int rowIndex, FdcGridRowContext row)
Decides whether the row at rowIndex may enter edit traversal.
FdcGridCellChanged = FdcFieldValueChangedCallback<Object?>
Receives notification after an accepted grid cell value has been committed.
FdcGridCellChangedContext = FdcFieldValueChangedContext<Object?>
Grid specialization of the context delivered after an accepted cell change.
FdcGridCellFocusEvent = FdcFieldFocusCallback<Object?>
Receives cell focus enter/exit notifications after the grid resolves a focus transition.
FdcGridCellFocusEventContext = FdcFieldFocusContext<Object?>
Grid specialization of focus context used by cell enter/exit callbacks.
FdcGridCellPointerEvent = void Function(FdcGridCellPointerContext context)
Receives a completed grid cell pointer gesture notification.
FdcGridColumnFocusEvent = FdcFieldFocusCallback<Object?>
Receives column focus enter/exit notifications emitted by grid navigation.
FdcGridColumnFocusEventContext = FdcFieldFocusContext<Object?>
Grid specialization of focus context used by column enter/exit callbacks.
FdcGridExportCompleted = void Function(FdcExportResult result)
Called after the built-in grid export command has generated an FdcExportResult.
FdcGridFocusChangeReason = FdcFieldFocusChangeReason
Reason associated with a grid focus transition.
FdcGridLookup<T> = Future<FdcLookupResult?> Function(FdcLookupContext context)
Asynchronous lookup callback for a grid column.
FdcGridMenuBuilder = List<FdcMenuEntry> Function(FdcGridMenuContext context)
Builds body-cell context-menu entries.
FdcGridRowFocusEvent = FdcFieldFocusCallback<Object?>
Receives row focus enter/exit notifications emitted by grid navigation.
FdcGridRowFocusEventContext = FdcFieldFocusContext<Object?>
Grid specialization of focus context used by row enter/exit callbacks.
FdcProgressTextBuilder = String Function(num? value)
Formats the label shown for a progress-column value.
FdcRecordValidator = List<FdcValidationError> Function(FdcRowContext row)
Validates a row as a whole after field-level values are available.
FdcRowActionCallback = void Function(FdcRowActionContext context)
Callback used by FdcRowAction to execute row-level commands.
FdcRowActionPredicate = bool Function(FdcRowActionContext context)
Predicate used by FdcRowAction to resolve row-level state.
FdcSearchFieldTextFormatter = String Function(Object? value)
Converts a field value into searchable text for prepared dataset search.

Exceptions / Errors

FdcDataAdapterException
Canonical exception raised at the adapter/dataset boundary.
FdcDataSetAbortException
Signals an intentional cancellation of the current dataset operation.
FdcDataSetException
Base exception for dataset and adapter operation failures.
FdcDataSetValidationException
Exception containing one or more dataset validation errors.