# PropsTable

> The reference table a docs page prints for props, options, fields or a request body: name, type, default, required and description, with nested fields behind a native disclosure that expands in place.

```ts
import { PropsTable } from "@sdxc/ui/docs";
```

Renders the table inside a box that is its own size container. Above 36rem it reads as
five columns; at or below, each row stacks with the column label before each value. A
long type wraps inside its cell, so the table never widens the page.

## Examples

```tsx
<PropsTable aria-label={t("props")} labels={labels} rows={[
	{ name: "title", type: "string", description: "The file the block belongs to." },
	{ name: "retry", type: "object", children: [{ name: "attempts", type: "number", default: "3" }] },
]} />
```

## Props

| Prop | Type | Description |
| --- | --- | --- |
| `rows` | `readonly Row[]` |  |
| `labels` | `Labels` |  |
| `"aria-label"?` | `string` | Names the table for a reader who reaches it without the heading above it. |

Also accepts everything in `Omit<TagProps<"div">, "children">`.