Blocks / Table

Table

Typed columns, 44px rows; a clickable row opens on Enter.

import { Table } from "@forgeron/ui";
/01 → Default
NumberCustomerAmount
INV-2041Maison Roy€1,240.00
INV-2040Bernard & fils€86.50
INV-2039Atelier Martin€3,912.00
import { Table } from "@forgeron/ui";

type Invoice = { id: string; customer: string; amount: string };

const rows: Invoice[] = [
  { id: "INV-2041", customer: "Maison Roy", amount: "€1,240.00" },
  { id: "INV-2040", customer: "Bernard & fils", amount: "€86.50" },
  { id: "INV-2039", customer: "Atelier Martin", amount: "€3,912.00" },
];

export default function Default() {
  return (
    <div style={{ width: 380 }}>
      <Table<Invoice>
        label="Invoices"
        rowKey={(r) => r.id}
        rows={rows}
        columns={[
          { key: "id", header: "Number", mono: true },
          { key: "customer", header: "Customer" },
          { key: "amount", header: "Amount", align: "end", mono: true },
        ]}
      />
    </div>
  );
}
/02 → Clickable rows
NameEmailRoleStatus
Camille Roycamille@roy.frOwnerActive
Hugo Bernardhugo@roy.frMemberActive
Léa Martinlea@roy.frMemberInvited

Open a member

import { Badge, Table } from "@forgeron/ui";
import { useState } from "react";

type Member = { id: string; name: string; email: string; role: string; active: boolean };

const members: Member[] = [
  { id: "cr", name: "Camille Roy", email: "camille@roy.fr", role: "Owner", active: true },
  { id: "hb", name: "Hugo Bernard", email: "hugo@roy.fr", role: "Member", active: true },
  { id: "lm", name: "Léa Martin", email: "lea@roy.fr", role: "Member", active: false },
];

// A row is a button: click it, or Tab to it and press Enter.
export default function ClickableRows() {
  const [opened, setOpened] = useState<string | null>(null);
  return (
    <div style={{ display: "grid", gap: 12, width: "100%" }}>
      <Table<Member>
        label="Members"
        rowKey={(m) => m.id}
        rows={members}
        onRowClick={(m) => setOpened(m.name)}
        columns={[
          { key: "name", header: "Name" },
          { key: "email", header: "Email", mono: true },
          { key: "role", header: "Role" },
          {
            key: "active",
            header: "Status",
            align: "end",
            render: (m) =>
              m.active ? (
                <Badge tone="success" dot>
                  Active
                </Badge>
              ) : (
                <Badge dot>Invited</Badge>
              ),
          },
        ]}
      />
      <p style={{ margin: 0, color: "var(--ink-muted)" }}>
        {opened ? `Opened: ${opened}` : "Open a member"}
      </p>
    </div>
  );
}
/03 → Empty
DatePayerAmount
No payment this month
import { Table } from "@forgeron/ui";

export default function Empty() {
  return (
    <div style={{ width: "100%", maxWidth: 480 }}>
      <Table<{ id: string }>
        label="Payments"
        rowKey={(r) => r.id}
        rows={[]}
        empty="No payment this month"
        columns={[
          { key: "date", header: "Date" },
          { key: "payer", header: "Payer" },
          { key: "amount", header: "Amount", align: "end" },
        ]}
      />
    </div>
  );
}
API → Props
PropTypeDefaultDescription
columns{ key, header, align?, mono?, render? }[]—row[key] by default; render for anything else.
rowsRow[]—The data.
rowKey(row) => Key—Identifies a row.
onRowClick(row) => void—Makes each row a focusable button: click, Enter or Space.
emptyReactNode"Nothing to show"Shown when there is no row.
labelstring—Names the table when no heading does.
classNamestring—Extra classes.