Table
Typed columns, 44px rows; a clickable row opens on Enter.
import { Table } from "@forgeron/ui";| Number | Customer | Amount |
|---|---|---|
| INV-2041 | Maison Roy | €1,240.00 |
| INV-2040 | Bernard & fils | €86.50 |
| INV-2039 | Atelier 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>
);
}| Name | Role | Status | |
|---|---|---|---|
| Camille Roy | camille@roy.fr | Owner | Active |
| Hugo Bernard | hugo@roy.fr | Member | Active |
| Léa Martin | lea@roy.fr | Member | Invited |
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>
);
}| Date | Payer | Amount |
|---|---|---|
| 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
| Prop | Type | Default | Description |
|---|---|---|---|
columns | { key, header, align?, mono?, render? }[] | — | row[key] by default; render for anything else. |
rows | Row[] | — | The data. |
rowKey | (row) => Key | — | Identifies a row. |
onRowClick | (row) => void | — | Makes each row a focusable button: click, Enter or Space. |
empty | ReactNode | "Nothing to show" | Shown when there is no row. |
label | string | — | Names the table when no heading does. |
className | string | — | Extra classes. |