KeyValueTable #

A lightweight, zero-dependency Flutter table widget that perfectly aligns key-value pairs. It calculates the intrinsic width of the longest key so all separators (colons, arrows, dashes) line up in vertical harmony.

Features #

• ✨ Automatic Column Alignment: Uses Flutter's IntrinsicColumnWidth so labels never cause staggered colons.
• 🧩 Rich Value Support: Accepts strings, numbers, or full Widgets (e.g. Chip, Badge, ElevatedButton).
• 🎨 Custom Separators: Change from : to →, -, or provide your own widget.
• 🦓 Zebra Striping & Borders: Support for alternating row background colors and borders.
• 👆 Row Callbacks: Built-in onRowTap and onRowLongPress for copy-to-clipboard or navigation flows.
• 📱 All Platforms: Works across Android, iOS, Web, macOS, Windows, Linux.

Getting started #

Add key_value_table to your pubspec.yaml:

dependencies:
  key_value_table: ^0.0.1

Or run:

flutter pub add key_value_table

Usage #

1. Basic Key-Value Display #

import 'package:key_value_table/key_value_table.dart';

KeyValueTable(
  data: const {
    'Full Name': 'Dr. Alexander Fleming',
    'Specialty': 'Microbiology',
    'Nobel Prize': 1945,
  },
)

2. Rendering Custom Widgets (Badges, Chips) #

KeyValueTable(
  data: {
    'Order ID': '#ORD-9921',
    'Status': Chip(
      label: Text('Delivered'),
      backgroundColor: Colors.green.shade100,
    ),
    'Total': '\$129.50',
  },
)

3. Custom Separator & Tap Action #

KeyValueTable(
  separator: '→',
  separatorWidth: 24.0,
  alternateRowColor: Colors.grey.shade50,
  data: const {
    'Host': '127.0.0.1',
    'Port': '8080',
  },
  onRowTap: (context, key, value) {
    Clipboard.setData(ClipboardData(text: value.toString()));
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('Copied $key!')),
    );
  },
)

Additional information #

Contribute or report issues on GitHub at github.com/Amrit1345/key_value_table.