# Table A styled table for displaying structured data in rows and columns. Renders a native `` element and styles the ``, ``, ``, `` of column headings and a `` of data rows. | — | `Table` has no props of its own. All props, including `ref`, are forwarded to the underlying `
`, and `` elements you place inside it. Markdown tables throughout this documentation are rendered with `Table`. ```tsx demo import { Table } from "@tenstorrent/vesper/table"; export default function TableDemo() { return (
Model Name Device Deployed at Port
SD-XL 1.0-base 8B n300 5/11/2026, 1:15 PM 7000
Wan 2.2 14B n300 5/11/2026, 1:15 PM 7002
Llama-3.3-70B-Instruct n300 5/11/2026, 2:40 PM 7004
SpeechT5 (TTS task) 3.8M n300 5/11/2026, 4:27 PM 7006
); } ``` ## Options | Prop | Type | Description | Default | | --- | --- | --- | --- | | `children` | `ReactNode` | The table's content, typically a `
` element, and any `className` you pass is merged with Vesper's table styles. ## Examples ### Basic usage Build a `Table` from the same elements you would use in a native `
`. Place column headings in ``, and place your data in ``: ```tsx demo import { Table } from "@tenstorrent/vesper/table"; export default function BasicTable() { return (
` cells inside a `
` cells inside a `
Device Chips
n150 1
n300 2
T3000 8
); } ``` `Table` adds a divider beneath the ``, and gives every other row in the `` a subtle background tint, starting with the first. ### Rendering components in cells Cells accept any content, including other JSX: ```tsx demo import { Badge } from "@tenstorrent/vesper/badge"; import { StatusIndicator } from "@tenstorrent/vesper/status-indicator"; import { Table } from "@tenstorrent/vesper/table"; export default function TableWithComponents() { return (
Model Name Status Duration
SD-XL 1.0-base 8B ---
Llama-3.3-70B-Instruct ---
SpeechT5 (TTS task) 3.8M Failed 2h 21m
); } ``` ## Accessibility ### Labelling tables Give each `Table` an accessible name with [the `` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/caption) so people using assistive technology can tell what it contains, and tell several tables on the same page apart: ```tsx demo import { Table } from "@tenstorrent/vesper/table"; import { Typography } from "@tenstorrent/vesper/typography"; export default function LabelledTable() { return ( Available devices
Device Chips
n150 1
n300 2
); } ``` Rendering a `` with a visible label is best practise for accessibility. If you **really** don't want to render a visible label with a `
`, you can also render it with an `aria-label` to give it an accessible name, or `aria-labelledby` to link it to a descriptive element. ### Row headings When the first cell of each row identifies that row, render it as a `
` so assistive technology announces it alongside the other cells in the row: ```tsx demo import { Table } from "@tenstorrent/vesper/table"; export default function TableWithRowHeadings() { return (
Device Chips Cards
n150 1 1
n300 2 1
T3000 8 4
); } ```