Skip to main content

Keyboard Navigation

The grid coordinates keyboard navigation with dataset row movement and cell edit state.

Tab stops and focus order​

const FdcTextColumn<dynamic>(
  fieldName: 'company',
  focusOrder: 10,
  tabStop: true,
)

Set tabStop: false for visual or action-oriented columns that should not participate in normal Tab traversal.

Lookup shortcut​

Columns with onLookup can expose a focused-cell lookup action. The default shortcut is F4.

FdcTextColumn<String>(
  fieldName: 'customer_code',
  onLookup: openCustomerLookup,
)

A custom lookupShortcut may be supplied, or set to null to disable keyboard lookup activation for that column.

Scrolling and scrollbars​

Configure vertical and horizontal scroll behavior independently:

const FdcGridOptions(
  verticalScrollMode: FdcGridVerticalScrollMode.smooth,
  horizontalScrollMode: FdcGridHorizontalScrollMode.columnSnap,
  scrollbars: FdcGridScrollbars.both,
)

Vertical scroll modes​

ModeBehavior
FdcGridVerticalScrollMode.smoothPixel-based scrolling. Scrolling does not make the first visible row current.
FdcGridVerticalScrollMode.recordScrollRow-oriented scrolling. The viewport snaps to row boundaries and the first visible row becomes the current dataset record.

Horizontal scroll modes​

ModeBehavior
FdcGridHorizontalScrollMode.smoothPixel-based horizontal scrolling without column snapping.
FdcGridHorizontalScrollMode.columnSnapSettles to the nearest column boundary when the scroll interaction ends.

Scrollbar visibility​

FdcGridScrollbars controls only which scrollbar thumbs are rendered:

  • both renders vertical and horizontal thumbs;
  • vertical renders only the vertical thumb;
  • horizontal renders only the horizontal thumb;
  • none hides both thumbs.

Hiding scrollbar thumbs does not disable scrolling. Pointer, wheel, drag, trackpad, and keyboard scrolling remain available.