Renders a scrollable table container.

The outer <div> has relative w-full overflow-auto so that wide tables scroll horizontally without breaking the page layout. The <table> inside uses w-full caption-bottom text-sm — it fills the container width and places captions below the table.

Example

<.table class="rounded-md border">
  <.table_header>...</.table_header>
  <.table_body>...</.table_body>
</.table>

Attributes

• class (:string) - Additional CSS classes for the outer wrapper div (e.g. rounded-md border). Defaults to nil.
• Global attributes are accepted. HTML attributes forwarded to the outer <div> wrapper.

Slots

• inner_block (required) - Table structure: table_header/1, table_body/1, table_footer/1, table_caption/1.

Renders the <tbody> section. Supports LiveView Streams via phx-update.

The [&_tr:last-child]:border-0 rule removes the bottom border from the last row, preventing a double border at the boundary between the table body and the table footer (or the container edge when no footer is present).

Static usage

<.table_body>
  <.table_row :for={row <- @rows}>
    <.table_cell><%= row.name %></.table_cell>
  </.table_row>
</.table_body>

Streams usage

<.table_body id="rows" phx-update="stream">
  <.table_row :for={{dom_id, row} <- @streams.rows} id={dom_id}>
    <.table_cell><%= row.name %></.table_cell>
  </.table_row>
</.table_body>

Attributes

• class (:string) - Additional CSS classes. Defaults to nil.

• Global attributes are accepted. HTML attributes forwarded to <tbody>. When using LiveView Streams, pass phx-update="stream" and id="unique-id" here:

  <.table_body id="users" phx-update="stream">

Slots

• inner_block (required) - Data rows — table_row/1 children (static or :for loop).

Renders a <caption> element for accessible table labelling.

The caption element is placed after the table content (caption-side: bottom via caption-bottom on the parent <table>). It is visible to all users by default — use it for data source attribution, last-updated timestamps, or brief table descriptions.

The <caption> element is the preferred way to label a table for accessibility because it is directly associated with the table in the accessibility tree, unlike an aria-label or heading placed outside.

Example

<.table>
  <.table_caption>Revenue data as of March 2026</.table_caption>
  ...
</.table>

Attributes

• class (:string) - Additional CSS classes. Defaults to nil.
• Global attributes are accepted. HTML attributes forwarded to <caption>.

Slots

• inner_block (required) - Caption text describing the table's purpose for screen readers and sighted users.

Renders a <td> data cell.

The default px-4 py-3 padding is consistent with table_head/1 headers so columns align correctly. Use the :class attr to override padding or alignment for specific columns:

<%!-- Right-align a numeric column --%>
<.table_cell class="text-right font-mono tabular-nums">$1,234.56</.table_cell>

<%!-- Tighter padding for a compact icon-only column --%>
<.table_cell class="px-2 py-1">
  <.button variant={:ghost} size={:icon}><.icon name="edit" /></.button>
</.table_cell>

Attributes

• class (:string) - Additional CSS classes for padding or alignment overrides. Defaults to nil.
• Global attributes are accepted. HTML attributes forwarded to <td> (e.g. colspan, rowspan, data-*).

Slots

• inner_block (required) - Cell content — plain text, formatted numbers, badges, buttons, avatars, etc.

Renders the <tfoot> section for totals and summary rows.

Uses bg-muted/50 font-medium to visually distinguish footer rows from regular data rows. A top border (border-t) separates it from the body.

Example

<.table_footer>
  <.table_row>
    <.table_cell>Total</.table_cell>
    <.table_cell>$60,540</.table_cell>
    <.table_cell></.table_cell>
  </.table_row>
</.table_footer>

Attributes

• class (:string) - Additional CSS classes. Defaults to nil.
• Global attributes are accepted. HTML attributes forwarded to <tfoot>.

Slots

• inner_block (required) - Footer rows — typically totals, averages, or summary statistics.

Renders a <th> column header cell.

Uses text-xs uppercase tracking-wider for an enterprise-style compact header aesthetic. Content is left-aligned by default (text-left).

Example

<.table_head class="text-right">Amount</.table_head>
<.table_head>Status</.table_head>

Attributes

• class (:string) - Additional CSS classes. Defaults to nil.
• Global attributes are accepted. HTML attributes forwarded to <th>.

Slots

• inner_block (required) - Header cell content — column name, sort button, or checkbox.

Renders the <thead> section.

The [&_tr]:border-b rule adds a bottom border to all header rows, creating a visual separator between the header and the first data row.

Example

<.table_header>
  <.table_row>
    <.table_head>Name</.table_head>
    <.table_head>Email</.table_head>
  </.table_row>
</.table_header>

Attributes

• class (:string) - Additional CSS classes. Defaults to nil.
• Global attributes are accepted. HTML attributes forwarded to <thead>.

Slots

• inner_block (required) - Header rows — typically one table_row/1 containing table_head/1 cells.

Renders a <tr> table row.

All rows have:

• border-b — bottom divider (removed on last child by the tbody rule)
• transition-colors — smooth background transition on hover/selection
• hover:bg-muted/50 — subtle hover highlight

When selected={true}, the row gets data-state="selected" which activates the data-[state=selected]:bg-muted style.

Example

<.table_row selected={user.id in @selected_ids}>
  <.table_cell><%= user.name %></.table_cell>
</.table_row>

Attributes

• class (:string) - Additional CSS classes for conditional row styling. Defaults to nil.

• selected (:boolean) - When true, sets data-state="selected" on the <tr>, which triggers the data-[state=selected]:bg-muted Tailwind rule to highlight the row. Use this for externally managed selection state (e.g. from a form).

  Defaults to false.

• Global attributes are accepted. HTML attributes forwarded to <tr>. When using streams, pass id={dom_id} so LiveView can track the element across patches.

Slots

• inner_block (required) - table_head/1 or table_cell/1 children.