Tables

Fast-Rich provides beautiful, customizable tables with Unicode borders, auto-sizing columns, and cell styling.

Quick Example

use fast_rich::prelude::*;

fn main() {
    let console = Console::new();

    let mut table = Table::new();
    table.add_column("Name");
    table.add_column("Role");
    table.add_row_strs(&["Alice", "Admin"]);
    table.add_row_strs(&["Bob", "Developer"]);

    console.print_renderable(&table);
}

Output:

╭───────┬───────────╮
│ Name  │ Role      │
├───────┼───────────┤
│ Alice │ Admin     │
│ Bob   │ Developer │
╰───────┴───────────╯

---

Creating Tables

Basic Structure

let mut table = Table::new();

// Add columns (headers)
table.add_column("Column 1");
table.add_column("Column 2");
table.add_column("Column 3");

// Add rows (data)
table.add_row_strs(&["A1", "B1", "C1"]);
table.add_row_strs(&["A2", "B2", "C2"]);

Table Title

Add a centered title above the table:

let mut table = Table::new().title("User Statistics");
table.add_column("Metric");
table.add_column("Value");
table.add_row_strs(&["Users", "1,234"]);

Output:

     User Statistics     
╭────────┬───────╮
│ Metric │ Value │
├────────┼───────┤
│ Users  │ 1,234 │
╰────────┴───────╯

---

Column Configuration

Column Alignment

Control how content is aligned within columns:

use fast_rich::table::ColumnAlign;

let mut table = Table::new();
table.add_column_with("ID", Column::new().align(ColumnAlign::Right));
table.add_column_with("Name", Column::new().align(ColumnAlign::Left));
table.add_column_with("Status", Column::new().align(ColumnAlign::Center));

table.add_row_strs(&["1", "Alice", "Active"]);
table.add_row_strs(&["123", "Bob", "Pending"]);

Output:

╭─────┬───────┬─────────╮
│  ID │ Name  │ Status  │
├─────┼───────┼─────────┤
│   1 │ Alice │ Active  │
│ 123 │ Bob   │ Pending │
╰─────┴───────┴─────────╯

Alignment Options

Alignment	Description
ColumnAlign::Left	Left-align content (default)
ColumnAlign::Right	Right-align content
ColumnAlign::Center	Center content

---

Border Styles

Tables support multiple border styles:

Rounded (Default)SquareHeavyDoubleASCIIMinimal

table.border_style(BorderStyle::Rounded);

╭────────┬─────────╮
│ Name   │ Value   │
├────────┼─────────┤
│ Item   │ Data    │
╰────────┴─────────╯

table.border_style(BorderStyle::Square);

┌────────┬─────────┐
│ Name   │ Value   │
├────────┼─────────┤
│ Item   │ Data    │
└────────┴─────────┘

table.border_style(BorderStyle::Heavy);

┏━━━━━━━━┳━━━━━━━━━┓
┃ Name   ┃ Value   ┃
┣━━━━━━━━╋━━━━━━━━━┫
┃ Item   ┃ Data    ┃
┗━━━━━━━━┻━━━━━━━━━┛

table.border_style(BorderStyle::Double);

╔════════╦═════════╗
║ Name   ║ Value   ║
╠════════╬═════════╣
║ Item   ║ Data    ║
╚════════╩═════════╝

table.border_style(BorderStyle::Ascii);

+--------+---------+
| Name   | Value   |
+--------+---------+
| Item   | Data    |
+--------+---------+

table.border_style(BorderStyle::Minimal);

 ────────────────── 
  Name     Value   
 ────────────────── 
  Item     Data    
 ────────────────── 

---

Styled Cells

Add colors and formatting to individual cells:

use fast_rich::prelude::*;

let mut table = Table::new();
table.add_column("Level");
table.add_column("Message");

// Use Text objects with styles
table.add_row(vec![
    fast_rich::markup::parse("[green]INFO[/]"),
    Text::plain("System started"),
]);
table.add_row(vec![
    fast_rich::markup::parse("[yellow]WARN[/]"),
    Text::plain("Low memory"),
]);
table.add_row(vec![
    fast_rich::markup::parse("[red]ERROR[/]"),
    Text::plain("Connection failed"),
]);

Output:

╭───────┬───────────────────╮
│ Level │ Message           │
├───────┼───────────────────┤
│ INFO  │ System started    │
│ WARN  │ Low memory        │
│ ERROR │ Connection failed │
╰───────┴───────────────────╯

---

Real Terminal Output

Run the tables demo

Command:

cargo run --example tables_demo

What you'll see:

---

Tips

Auto-sizing

Columns automatically expand to fit their content. The table adapts to the terminal width.

Unicode Headers

Use emoji and symbols in headers:

table.add_column("✅ Status");
table.add_column("📊 Metric");

Wide Content

Very wide content may cause horizontal scrolling or wrapping depending on terminal width. Consider truncating or abbreviating long text.