VTable class

A customizable, reusable table widget with pinned headers, scrollable rows, and flexible column layouts.

VTable provides a clean, accessible tabular data display with:

• Pinned header row that stays visible while rows scroll vertically
• Flexible column sizing via columnFlex ratios (proportional widths)
• Cell content flexibility supporting both String and Widget types
• Alignment control with centerColumns and rightColumns indices
• Density levels for different spacing needs via VTableDensity
• Consistent styling matching Forui's FCard aesthetic (borders, rounded corners, background)
• Separator dividers between rows using Forui's FDivider

Requirements

• headers.length must equal columnFlex.length
• rows.length can be 0 (empty table) or any positive integer
• Each row length should match headers.length for consistent column structure

Alignment Behavior

• Columns are left-aligned by default
• Right-alignment takes precedence over center-alignment if a column is in both lists

Example

VTable(
  height: 400,
  density: VTableDensity.comfortable,
  columnFlex: [1, 2, 1],
  centerColumns: [2],
  rightColumns: [0],
  headers: [
    'ID',
    'Customer Name',
    Row(children: [Icon(Icons.flag), SizedBox(width: 4), Text('Status')]),
  ],
  rows: [
    ['#1001', 'Alice Johnson', 'Active'],
    ['#1002', 'Bob Smith', 'Inactive'],
    ['#1003', 'Carol White', 'Active'],
  ],
);