Table

The composable table primitive. You author the rows; the table provides the CSS-Grid layout, sticky and frozen headers, column pinning, sort and selection state, striping, and loading / empty states.

Live preview Open in Storybook

Client Amount Status Acme Corp $1,200.00 Paid Globex $3,120.00 Pending Initech $480.00 Overdue

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Invoices" striped>
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
      <md-table-row value="inv-2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
      </md-table-row>
      <md-table-row value="inv-3">
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$480.00</md-table-cell>
        <md-table-cell>Overdue</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="2fr 1fr 1fr" label="Invoices" striped>
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="inv-1">
              <MdTableCell head scope="row">Acme Corp</MdTableCell>
              <MdTableCell numeric>$1,200.00</MdTableCell>
              <MdTableCell>Paid</MdTableCell>
            </MdTableRow>
            <MdTableRow value="inv-2">
              <MdTableCell head scope="row">Globex</MdTableCell>
              <MdTableCell numeric>$3,120.00</MdTableCell>
              <MdTableCell>Pending</MdTableCell>
            </MdTableRow>
            <MdTableRow value="inv-3">
              <MdTableCell head scope="row">Initech</MdTableCell>
              <MdTableCell numeric>$480.00</MdTableCell>
              <MdTableCell>Overdue</MdTableCell>
            </MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Invoices" striped>
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
      <md-table-row value="inv-2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
      </md-table-row>
      <md-table-row value="inv-3">
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$480.00</md-table-cell>
        <md-table-cell>Overdue</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Invoices" striped>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="inv-1">
          <md-table-cell head scope="row">Acme Corp</md-table-cell>
          <md-table-cell numeric>$1,200.00</md-table-cell>
          <md-table-cell>Paid</md-table-cell>
        </md-table-row>
        <md-table-row value="inv-2">
          <md-table-cell head scope="row">Globex</md-table-cell>
          <md-table-cell numeric>$3,120.00</md-table-cell>
          <md-table-cell>Pending</md-table-cell>
        </md-table-row>
        <md-table-row value="inv-3">
          <md-table-cell head scope="row">Initech</md-table-cell>
          <md-table-cell numeric>$480.00</md-table-cell>
          <md-table-cell>Overdue</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Invoices" striped>
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
      <md-table-row value="inv-2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
      </md-table-row>
      <md-table-row value="inv-3">
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$480.00</md-table-cell>
        <md-table-cell>Overdue</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Not a Material Design 3 component

M3 has no data-table page. The anatomy here is derived from M3 · Lists · Guidelines; everything else is a house rule.

Install

Already installed? See the Installation guide for one-time package setup (core + tokens, fonts). Each tab below shows two patterns for using md-table in your project: Option A registers every AWC UI component at once (simplest), Option B imports only this component for tree-shake-friendly bundles.

HTML React Angular Vue Svelte

Copy

<!-- ─── Option A: global registration (all components) ─── -->
<script type="module">
  import '@awc-ui/core/define';
</script>


<!-- ─── Option B: single import (tree-shake only md-table) ─── -->
<script type="module">
  import '@awc-ui/core/components/md-table';
</script>


<md-table></md-table>

Copy

// ─── Option A: typed React wrapper (registers all components) ───
//   Importing from '@awc-ui/react' calls defineCustomElements() as a
//   side effect, so every md-* element becomes available in the browser.
import { MdTable } from '@awc-ui/react';

export function Example() {
  return <MdTable></MdTable>;
}


// ─── Option B: single import (tree-shake to only md-table) ───
//   Skip the wrapper and use the raw custom element. Smallest bundle,
//   but you lose typed props/events on JSX.
import '@awc-ui/core/components/md-table';

export function ExampleTreeShaken() {
  return <md-table></md-table>;
}

Copy

// ─── Option A: schema module (any md-* element accepted) ───
//   Pair with `defineCustomElements(window)` in main.ts.
import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@Component({
  standalone: true,
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `<md-table></md-table>`,
})
export class ExampleComponent {}


// ─── Option B: typed directive (tree-shake friendly) ───
//   Pair with `import '@awc-ui/core/components/md-table'` in main.ts.
import { Component } from '@angular/core';
import { MdTable } from '@awc-ui/angular';

@Component({
  standalone: true,
  imports: [MdTable],
  template: `<md-table></md-table>`,
})
export class ExampleTreeShakenComponent {}

Copy

<!-- ─── Option A: typed Vue wrapper (registers all components) ─── -->
<script setup lang="ts">
import { MdTable } from '@awc-ui/vue';
</script>

<template>
  <MdTable></MdTable>
</template>


<!-- ─── Option B: single import (tree-shake to only md-table) ─── -->
<script setup lang="ts">
import '@awc-ui/core/components/md-table';
</script>

<template>
  <md-table></md-table>
</template>

Copy

<!-- ─── Option A: global registration (done once in main entry) ─── -->
<!-- main.ts:                                                          -->
<!--   import { defineCustomElements } from '@awc-ui/svelte';        -->
<!--   defineCustomElements(window);                                   -->

<md-table></md-table>


<!-- ─── Option B: single import (tree-shake to only md-table) ─── -->
<script lang="ts">
  import '@awc-ui/core/components/md-table';
</script>

<md-table></md-table>

When to use

• A table whose rows you compose by hand: mixed content, embedded controls, bespoke cells, server-rendered markup.
• You need column pinning or frozen headers.

When not to use

Situation	Use instead
A vertical list of records	md-list
Rich, self-contained items	a md-card collection
Hierarchy / reporting lines	md-organization-chart
Comparing two values	Plain text
Layout (the old <table> misuse)	CSS Grid

Layout: CSS Grid, not a native <table>

This is the single most important thing to internalise. The shadow .md-table__grid owns the column tracks; each md-table-row is a real grid item that lays its cells on those shared tracks via grid-template-columns: subgrid. The rowgroups — md-table-head, md-table-body, md-table-foot — are display: contents, so their rows land directly on the parent’s tracks.

Two consequences follow, and both bite:

You must declare the tracks, and you must not wrap the rows

1. Declare column-template or columns. Content does not define the grid. With neither set, the column count is derived from the first row’s cells — a fallback, not a design.
2. Never wrap rows in your own <div>. display: contents on the rowgroups is what makes cells land on the shared tracks; an extra box breaks the grid.

Need	Setting
Explicit column widths	column-template — a raw CSS grid-template-columns value (minmax(), fr, auto all allowed)
Just a column count	columns — becomes repeat(<columns>, minmax(0, 1fr))
A floor before horizontal scrolling kicks in	min-width (or --md-table-min-width)

column-template wins over columns when both are set.

columns vs column-template Open in Storybook

Equal Thirds Each ABC Flexible 1fr 120px AB42

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined"><md-table columns="3" label="Derived from the columns prop">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Equal</md-table-cell>
      <md-table-cell head scope="col">Thirds</md-table-cell>
      <md-table-cell head scope="col">Each</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell>C</md-table-cell></md-table-row>
  </md-table-body>
</md-table></md-table-container>

<md-table-container variant="outlined" style="margin-block-start: 20px;"><md-table column-template="minmax(160px, 2fr) 1fr 120px" label="Explicit template">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Flexible</md-table-cell>
      <md-table-cell head scope="col">1fr</md-table-cell>
      <md-table-cell head scope="col" numeric>120px</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell numeric>42</md-table-cell></md-table-row>
  </md-table-body>
</md-table></md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined"><MdTable columns="3" label="Derived from the columns prop">
        <MdTableHead>
          <MdTableRow rowgroup="head">
            <MdTableCell head scope="col">Equal</MdTableCell>
            <MdTableCell head scope="col">Thirds</MdTableCell>
            <MdTableCell head scope="col">Each</MdTableCell>
          </MdTableRow>
        </MdTableHead>
        <MdTableBody>
          <MdTableRow><MdTableCell>A</MdTableCell><MdTableCell>B</MdTableCell><MdTableCell>C</MdTableCell></MdTableRow>
        </MdTableBody>
      </MdTable></MdTableContainer>

      <MdTableContainer variant="outlined" style={{ marginBlockStart: '20px' }}><MdTable columnTemplate="minmax(160px, 2fr) 1fr 120px" label="Explicit template">
        <MdTableHead>
          <MdTableRow rowgroup="head">
            <MdTableCell head scope="col">Flexible</MdTableCell>
            <MdTableCell head scope="col">1fr</MdTableCell>
            <MdTableCell head scope="col" numeric>120px</MdTableCell>
          </MdTableRow>
        </MdTableHead>
        <MdTableBody>
          <MdTableRow><MdTableCell>A</MdTableCell><MdTableCell>B</MdTableCell><MdTableCell numeric>42</MdTableCell></MdTableRow>
        </MdTableBody>
      </MdTable></MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined"><md-table columns="3" label="Derived from the columns prop">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Equal</md-table-cell>
      <md-table-cell head scope="col">Thirds</md-table-cell>
      <md-table-cell head scope="col">Each</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell>C</md-table-cell></md-table-row>
  </md-table-body>
</md-table></md-table-container>

<md-table-container variant="outlined" style="margin-block-start: 20px;"><md-table column-template="minmax(160px, 2fr) 1fr 120px" label="Explicit template">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Flexible</md-table-cell>
      <md-table-cell head scope="col">1fr</md-table-cell>
      <md-table-cell head scope="col" numeric>120px</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell numeric>42</md-table-cell></md-table-row>
  </md-table-body>
</md-table></md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined"><md-table columns="3" label="Derived from the columns prop">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Equal</md-table-cell>
        <md-table-cell head scope="col">Thirds</md-table-cell>
        <md-table-cell head scope="col">Each</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell>C</md-table-cell></md-table-row>
    </md-table-body>
  </md-table></md-table-container>

  <md-table-container variant="outlined" style="margin-block-start: 20px;"><md-table column-template="minmax(160px, 2fr) 1fr 120px" label="Explicit template">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Flexible</md-table-cell>
        <md-table-cell head scope="col">1fr</md-table-cell>
        <md-table-cell head scope="col" numeric>120px</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell numeric>42</md-table-cell></md-table-row>
    </md-table-body>
  </md-table></md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined"><md-table columns="3" label="Derived from the columns prop">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Equal</md-table-cell>
      <md-table-cell head scope="col">Thirds</md-table-cell>
      <md-table-cell head scope="col">Each</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell>C</md-table-cell></md-table-row>
  </md-table-body>
</md-table></md-table-container>

<md-table-container variant="outlined" style="margin-block-start: 20px;"><md-table column-template="minmax(160px, 2fr) 1fr 120px" label="Explicit template">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Flexible</md-table-cell>
      <md-table-cell head scope="col">1fr</md-table-cell>
      <md-table-cell head scope="col" numeric>120px</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    <md-table-row><md-table-cell>A</md-table-cell><md-table-cell>B</md-table-cell><md-table-cell numeric>42</md-table-cell></md-table-row>
  </md-table-body>
</md-table></md-table-container>

Rows being real boxes is what makes hover, stripes, dividers, sticky headers and focus rings work — and it means a wrong cell count skews one row rather than the whole table.

Two Storybook stories put the whole surface together at once: a full data table (toolbar with quick-filter and CSV export, selection, sorting, sticky header and column, pagination) and a fully customised one.

Anatomy

The whole anatomy — toolbar, sticky header, sort label, totals row and pagination

Name Amount Status Acme Corp $1,200 Globex $3,120 Initech $480 Umbrella $2,450 Total $7,250

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="248px">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Q1 2025"></md-table-toolbar>

  <md-table column-template="2fr 1fr 1fr" sticky-header striped label="Invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">
          <md-table-sort-label column="name">Name</md-table-sort-label>
        </md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>

    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120</md-table-cell>
        <md-table-cell><md-chip label="Pending" color="warning"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-3">
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$480</md-table-cell>
        <md-table-cell><md-chip label="Overdue" color="error"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-4">
        <md-table-cell head scope="row">Umbrella</md-table-cell>
        <md-table-cell numeric>$2,450</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
    </md-table-body>

    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$7,250</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>

  <md-table-pagination slot="bottom" count="4" rows-per-page="5"></md-table-pagination>
</md-table-container>

Copy

import { MdChip, MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableFoot, MdTableHead, MdTablePagination, MdTableRow, MdTableSortLabel, MdTableToolbar } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined" maxHeight="248px">
        <MdTableToolbar slot="top" headline="Invoices" supportingText="Q1 2025"></MdTableToolbar>

        <MdTable columnTemplate="2fr 1fr 1fr" stickyHeader striped label="Invoices">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">
                <MdTableSortLabel column="name">Name</MdTableSortLabel>
              </MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>

          <MdTableBody>
            <MdTableRow value="inv-1">
              <MdTableCell head scope="row">Acme Corp</MdTableCell>
              <MdTableCell numeric>$1,200</MdTableCell>
              <MdTableCell><MdChip label="Paid" color="success"></MdChip></MdTableCell>
            </MdTableRow>
            <MdTableRow value="inv-2">
              <MdTableCell head scope="row">Globex</MdTableCell>
              <MdTableCell numeric>$3,120</MdTableCell>
              <MdTableCell><MdChip label="Pending" color="warning"></MdChip></MdTableCell>
            </MdTableRow>
            <MdTableRow value="inv-3">
              <MdTableCell head scope="row">Initech</MdTableCell>
              <MdTableCell numeric>$480</MdTableCell>
              <MdTableCell><MdChip label="Overdue" color="error"></MdChip></MdTableCell>
            </MdTableRow>
            <MdTableRow value="inv-4">
              <MdTableCell head scope="row">Umbrella</MdTableCell>
              <MdTableCell numeric>$2,450</MdTableCell>
              <MdTableCell><MdChip label="Paid" color="success"></MdChip></MdTableCell>
            </MdTableRow>
          </MdTableBody>

          <MdTableFoot>
            <MdTableRow rowgroup="foot" selectable="false">
              <MdTableCell head scope="row">Total</MdTableCell>
              <MdTableCell numeric>$7,250</MdTableCell>
              <MdTableCell></MdTableCell>
            </MdTableRow>
          </MdTableFoot>
        </MdTable>

        <MdTablePagination slot="bottom" count="4" rowsPerPage="5"></MdTablePagination>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined" max-height="248px">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Q1 2025"></md-table-toolbar>

  <md-table column-template="2fr 1fr 1fr" sticky-header striped label="Invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">
          <md-table-sort-label column="name">Name</md-table-sort-label>
        </md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>

    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120</md-table-cell>
        <md-table-cell><md-chip label="Pending" color="warning"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-3">
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$480</md-table-cell>
        <md-table-cell><md-chip label="Overdue" color="error"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-4">
        <md-table-cell head scope="row">Umbrella</md-table-cell>
        <md-table-cell numeric>$2,450</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
    </md-table-body>

    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$7,250</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>

  <md-table-pagination slot="bottom" count="4" rows-per-page="5"></md-table-pagination>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined" max-height="248px">
    <md-table-toolbar slot="top" headline="Invoices" supporting-text="Q1 2025"></md-table-toolbar>

    <md-table column-template="2fr 1fr 1fr" sticky-header striped label="Invoices">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">
            <md-table-sort-label column="name">Name</md-table-sort-label>
          </md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>

      <md-table-body>
        <md-table-row value="inv-1">
          <md-table-cell head scope="row">Acme Corp</md-table-cell>
          <md-table-cell numeric>$1,200</md-table-cell>
          <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
        </md-table-row>
        <md-table-row value="inv-2">
          <md-table-cell head scope="row">Globex</md-table-cell>
          <md-table-cell numeric>$3,120</md-table-cell>
          <md-table-cell><md-chip label="Pending" color="warning"></md-chip></md-table-cell>
        </md-table-row>
        <md-table-row value="inv-3">
          <md-table-cell head scope="row">Initech</md-table-cell>
          <md-table-cell numeric>$480</md-table-cell>
          <md-table-cell><md-chip label="Overdue" color="error"></md-chip></md-table-cell>
        </md-table-row>
        <md-table-row value="inv-4">
          <md-table-cell head scope="row">Umbrella</md-table-cell>
          <md-table-cell numeric>$2,450</md-table-cell>
          <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
        </md-table-row>
      </md-table-body>

      <md-table-foot>
        <md-table-row rowgroup="foot" selectable="false">
          <md-table-cell head scope="row">Total</md-table-cell>
          <md-table-cell numeric>$7,250</md-table-cell>
          <md-table-cell></md-table-cell>
        </md-table-row>
      </md-table-foot>
    </md-table>

    <md-table-pagination slot="bottom" count="4" rows-per-page="5"></md-table-pagination>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="248px">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Q1 2025"></md-table-toolbar>

  <md-table column-template="2fr 1fr 1fr" sticky-header striped label="Invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">
          <md-table-sort-label column="name">Name</md-table-sort-label>
        </md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>

    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120</md-table-cell>
        <md-table-cell><md-chip label="Pending" color="warning"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-3">
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$480</md-table-cell>
        <md-table-cell><md-chip label="Overdue" color="error"></md-chip></md-table-cell>
      </md-table-row>
      <md-table-row value="inv-4">
        <md-table-cell head scope="row">Umbrella</md-table-cell>
        <md-table-cell numeric>$2,450</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
    </md-table-body>

    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$7,250</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>

  <md-table-pagination slot="bottom" count="4" rows-per-page="5"></md-table-pagination>
</md-table-container>

• md-table-container is the surface and the scroll box. Its top / bottom slots sit outside the scroll region — that’s where the toolbar and pagination belong.
• rowgroup="head|body|foot" goes on each row, not just the wrapper. The wrapper does not cascade it.
• Header cells need head and scope together on md-table-cell — see Accessibility.

Variants

md-table-container carries the surface treatment. elevated (the default) floats the table on a shadow, outlined draws a hairline border instead, filled sits on a tonal surface, and flat removes both — including the background — so the table inherits whatever surface it sits on. Use flat only inside something you have already framed; on a bare page its rows have nothing to sit on.

The four container variants

variant="elevated" Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending variant="outlined" Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending variant="filled" Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending

variant="flat" Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="elevated">
    <md-table column-template="2fr 1fr 1fr" label="Elevated container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="elevated"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Outlined container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="outlined"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="filled">
    <md-table column-template="2fr 1fr 1fr" label="Filled container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="filled"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <!-- flat paints no surface of its own — it inherits the one it sits on.
  Framed here the way you would actually use it, inside a panel. -->
  <div style="padding: 16px; border-radius: 16px; background: var(--md-sys-color-surface);">
    <md-table-container variant="flat">
      <md-table column-template="2fr 1fr 1fr" label="Flat container">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">variant="flat"</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gap: '20px' }}>
        <MdTableContainer variant="elevated">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Elevated container">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">variant="elevated"</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Outlined container">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">variant="outlined"</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="filled">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Filled container">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">variant="filled"</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <!-- flat paints no surface of its own — it inherits the one it sits on.
        Framed here the way you would actually use it, inside a panel. -->
        <div style={{ padding: '16px', borderRadius: '16px', background: 'var(--md-sys-color-surface)' }}>
          <MdTableContainer variant="flat">
            <MdTable columnTemplate="2fr 1fr 1fr" label="Flat container">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">variant="flat"</MdTableCell>
                  <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                  <MdTableCell head scope="col">Status</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: grid; gap: 20px;">
  <md-table-container variant="elevated">
    <md-table column-template="2fr 1fr 1fr" label="Elevated container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="elevated"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Outlined container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="outlined"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="filled">
    <md-table column-template="2fr 1fr 1fr" label="Filled container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="filled"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <!-- flat paints no surface of its own — it inherits the one it sits on.
  Framed here the way you would actually use it, inside a panel. -->
  <div style="padding: 16px; border-radius: 16px; background: var(--md-sys-color-surface);">
    <md-table-container variant="flat">
      <md-table column-template="2fr 1fr 1fr" label="Flat container">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">variant="flat"</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: grid; gap: 20px;">
    <md-table-container variant="elevated">
      <md-table column-template="2fr 1fr 1fr" label="Elevated container">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">variant="elevated"</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Outlined container">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">variant="outlined"</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="filled">
      <md-table column-template="2fr 1fr 1fr" label="Filled container">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">variant="filled"</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <!-- flat paints no surface of its own — it inherits the one it sits on.
    Framed here the way you would actually use it, inside a panel. -->
    <div style="padding: 16px; border-radius: 16px; background: var(--md-sys-color-surface);">
      <md-table-container variant="flat">
        <md-table column-template="2fr 1fr 1fr" label="Flat container">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">variant="flat"</md-table-cell>
              <md-table-cell head scope="col" numeric>Amount</md-table-cell>
              <md-table-cell head scope="col">Status</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
            <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="elevated">
    <md-table column-template="2fr 1fr 1fr" label="Elevated container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="elevated"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Outlined container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="outlined"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="filled">
    <md-table column-template="2fr 1fr 1fr" label="Filled container">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">variant="filled"</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <!-- flat paints no surface of its own — it inherits the one it sits on.
  Framed here the way you would actually use it, inside a panel. -->
  <div style="padding: 16px; border-radius: 16px; background: var(--md-sys-color-surface);">
    <md-table-container variant="flat">
      <md-table column-template="2fr 1fr 1fr" label="Flat container">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">variant="flat"</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Vibrant tonality

vibrant on the container tints the whole table with the primary/tertiary container roles — a header band in primary, tinted stripes, and selection in tertiary. Use it for a table that is the centrepiece of its screen; keep the plain surface for tables that sit alongside other content.

Vibrant tonality — primary-tinted header over striped rows Open in Storybook

Name Role Team Salary Ada LovelaceMathematicianEngineering$120,000 Alan TuringCryptanalystSecurity$145,000 Grace HopperCompiler EngineerPlatform$132,000 Linus TorvaldsKernel EngineerInfrastructure$168,000 Margaret HamiltonSoftware LeadAvionics$175,000 Donald KnuthAuthor / ResearcherResearch$195,000

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html <head> — the icon font the components draw from -->
<link rel="stylesheet"
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap">

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="elevated" vibrant>
  <md-table-toolbar slot="top" headline="Employees" supporting-text="Vibrant tonality" auto-bind>
    <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
  </md-table-toolbar>
  <md-table id="vib-table" selection="multiple" striped column-template="auto 1.5fr 1.2fr 1fr 1fr" label="Vibrant employees">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"><md-checkbox id="vib-all" aria-label="Select all rows"></md-checkbox></md-table-cell>
        <md-table-cell head scope="col">Name</md-table-cell>
        <md-table-cell head scope="col">Role</md-table-cell>
        <md-table-cell head scope="col">Team</md-table-cell>
        <md-table-cell head scope="col" numeric>Salary</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="v1"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Ada Lovelace"></md-checkbox></md-table-cell><md-table-cell head scope="row">Ada Lovelace</md-table-cell><md-table-cell>Mathematician</md-table-cell><md-table-cell>Engineering</md-table-cell><md-table-cell numeric>$120,000</md-table-cell></md-table-row>
      <md-table-row value="v2"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Alan Turing"></md-checkbox></md-table-cell><md-table-cell head scope="row">Alan Turing</md-table-cell><md-table-cell>Cryptanalyst</md-table-cell><md-table-cell>Security</md-table-cell><md-table-cell numeric>$145,000</md-table-cell></md-table-row>
      <md-table-row value="v3"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Grace Hopper"></md-checkbox></md-table-cell><md-table-cell head scope="row">Grace Hopper</md-table-cell><md-table-cell>Compiler Engineer</md-table-cell><md-table-cell>Platform</md-table-cell><md-table-cell numeric>$132,000</md-table-cell></md-table-row>
      <md-table-row value="v4"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Linus Torvalds"></md-checkbox></md-table-cell><md-table-cell head scope="row">Linus Torvalds</md-table-cell><md-table-cell>Kernel Engineer</md-table-cell><md-table-cell>Infrastructure</md-table-cell><md-table-cell numeric>$168,000</md-table-cell></md-table-row>
      <md-table-row value="v5"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Margaret Hamilton"></md-checkbox></md-table-cell><md-table-cell head scope="row">Margaret Hamilton</md-table-cell><md-table-cell>Software Lead</md-table-cell><md-table-cell>Avionics</md-table-cell><md-table-cell numeric>$175,000</md-table-cell></md-table-row>
      <md-table-row value="v6"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Donald Knuth"></md-checkbox></md-table-cell><md-table-cell head scope="row">Donald Knuth</md-table-cell><md-table-cell>Author / Researcher</md-table-cell><md-table-cell>Research</md-table-cell><md-table-cell numeric>$195,000</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { useRef } from 'react';
import {
MdCheckbox, MdIconButton, MdTable, MdTableBody, MdTableCell, MdTableContainer,
MdTableHead, MdTableRow, MdTableToolbar,
} from '@awc-ui/react';

const STAFF = [
{ id: 'v1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
{ id: 'v2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
{ id: 'v3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
// … three more …
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

export function VibrantEmployees() {
const tableRef = useRef(null);

return (
  // `vibrant` belongs on the CONTAINER — it tints the header band, the
  // stripes and the selection colour in one go.
  <MdTableContainer variant="elevated" vibrant>
    <MdTableToolbar slot="top" headline="Employees" supportingText="Vibrant tonality" autoBind>
      <MdIconButton slot="actions" icon="filter_list" aria-label="Filter" />
      <MdIconButton slot="selection-actions" icon="delete" aria-label="Delete" />
    </MdTableToolbar>

    <MdTable
      ref={tableRef}
      selection="multiple"
      striped
      columnTemplate="auto 1.5fr 1.2fr 1fr 1fr"
      label="Vibrant employees"
    >
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head padding="checkbox">
            <MdCheckbox aria-label="Select all rows" onMdChange={() => tableRef.current?.toggleSelectAll()} />
          </MdTableCell>
          <MdTableCell head scope="col">Name</MdTableCell>
          <MdTableCell head scope="col">Role</MdTableCell>
          <MdTableCell head scope="col">Team</MdTableCell>
          <MdTableCell head scope="col" numeric>Salary</MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {STAFF.map((p) => (
          <MdTableRow key={p.id} value={p.id}>
            <MdTableCell padding="checkbox"><MdCheckbox aria-label={`Select ${p.name}`} /></MdTableCell>
            <MdTableCell head scope="row">{p.name}</MdTableCell>
            <MdTableCell>{p.role}</MdTableCell>
            <MdTableCell>{p.team}</MdTableCell>
            <MdTableCell numeric>{money(p.salary)}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
    </MdTable>
  </MdTableContainer>
);
}

Copy

// vibrant-employees.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA, ElementRef, ViewChild } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Person { id: string; name: string; role: string; team: string; salary: number; }

@Component({
selector: 'app-vibrant-employees',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <!-- vibrant goes on the container; striped is a separate table flag. -->
  <md-table-container variant="elevated" vibrant>
    <md-table-toolbar slot="top" headline="Employees" supporting-text="Vibrant tonality" auto-bind>
      <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
      <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
    </md-table-toolbar>

    <md-table #table selection="multiple" striped column-template="auto 1.5fr 1.2fr 1fr 1fr" label="Vibrant employees">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox">
            <md-checkbox aria-label="Select all rows" (mdChange)="selectAll()"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col">Team</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let p of staff; trackBy: trackById" [attr.value]="p.id">
          <md-table-cell padding="checkbox">
            <md-checkbox [attr.aria-label]="'Select ' + p.name"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="row">{{ p.name }}</md-table-cell>
          <md-table-cell>{{ p.role }}</md-table-cell>
          <md-table-cell>{{ p.team }}</md-table-cell>
          <md-table-cell numeric>{{ p.salary | currency:'USD':'symbol':'1.0-0' }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
`,
})
export class VibrantEmployeesComponent {
@ViewChild('table') tableRef!: ElementRef<HTMLElement & { toggleSelectAll(): Promise<void> }>;

staff: Person[] = [
  { id: 'v1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
  { id: 'v2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
  { id: 'v3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
];

selectAll() { void this.tableRef.nativeElement.toggleSelectAll(); }
trackById = (_: number, p: Person) => p.id;
}

Copy

<script setup>
import { ref } from 'vue';
import '@awc-ui/core/define';

const STAFF = [
{ id: 'v1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
{ id: 'v2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
{ id: 'v3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
// … three more …
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

const table = ref(null);
</script>

<template>
<!-- vibrant goes on the container; striped is a separate table flag. -->
<md-table-container variant="elevated" vibrant>
  <md-table-toolbar slot="top" headline="Employees" supporting-text="Vibrant tonality" auto-bind>
    <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
  </md-table-toolbar>

  <md-table ref="table" selection="multiple" striped column-template="auto 1.5fr 1.2fr 1fr 1fr" label="Vibrant employees">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox">
          <md-checkbox aria-label="Select all rows" @mdChange="table.toggleSelectAll()"></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="col">Name</md-table-cell>
        <md-table-cell head scope="col">Role</md-table-cell>
        <md-table-cell head scope="col">Team</md-table-cell>
        <md-table-cell head scope="col" numeric>Salary</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="p in STAFF" :key="p.id" :value="p.id">
        <md-table-cell padding="checkbox"><md-checkbox :aria-label="'Select ' + p.name"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">{{ p.name }}</md-table-cell>
        <md-table-cell>{{ p.role }}</md-table-cell>
        <md-table-cell>{{ p.team }}</md-table-cell>
        <md-table-cell numeric>{{ money(p.salary) }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
</template>

Copy

<script>
import '@awc-ui/core/define';

const STAFF = [
  { id: 'v1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
  { id: 'v2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
  { id: 'v3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
  // … three more …
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

let table;
</script>

<!-- vibrant goes on the container; striped is a separate table flag. -->
<md-table-container variant="elevated" vibrant>
<md-table-toolbar slot="top" headline="Employees" supporting-text="Vibrant tonality" auto-bind>
  <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
  <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
</md-table-toolbar>

<md-table bind:this={table} selection="multiple" striped column-template="auto 1.5fr 1.2fr 1fr 1fr" label="Vibrant employees">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head padding="checkbox">
        <md-checkbox aria-label="Select all rows" on:mdChange={() => table.toggleSelectAll()}></md-checkbox>
      </md-table-cell>
      <md-table-cell head scope="col">Name</md-table-cell>
      <md-table-cell head scope="col">Role</md-table-cell>
      <md-table-cell head scope="col">Team</md-table-cell>
      <md-table-cell head scope="col" numeric>Salary</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each STAFF as p (p.id)}
      <md-table-row value={p.id}>
        <md-table-cell padding="checkbox"><md-checkbox aria-label={'Select ' + p.name}></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">{p.name}</md-table-cell>
        <md-table-cell>{p.role}</md-table-cell>
        <md-table-cell>{p.team}</md-table-cell>
        <md-table-cell numeric>{money(p.salary)}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>
</md-table-container>

Sticky vs frozen headers

Two different mechanisms, routinely confused:

Prop	What it does	Pair with
sticky-header	The header stays inside the scroll region and pins to its top (classic in-flow sticky)	md-table-container[max-height]
frozen-header	The header is lifted out of the vertical scroll area into its own grid (the header-grid part), so the scrollbar spans only the body	md-table-container[max-height]
sticky-footer	Pins the foot row(s) to the bottom of the scroll container	md-table-foot

max-height on the container controls the size; frozen-header controls the architecture. Without a bounded container there is nothing to stick within — the page scrolls instead.

In frozen mode, scrollbar picks the vertical bar’s presentation: overlay (default) floats a thumb over the rows’ right edge and reserves no gutter; gutter reserves a stable strip and lets the native bar render in it.

The two modes differ in what scrolls. sticky-header keeps the head inside the scroll area and pins it there, so the container’s scrollbar spans the whole table — including alongside the header — and a half-scrolled row can show a sliver beneath the pinned head. frozen-header lifts the head out of the scroll area entirely: it spans the full width, never moves, and the scrollbar is confined to the body below it. Reach for frozen-header whenever the header must stay visually separate from the scrolling data.

sticky-header against frozen-header — scroll both bodies Open in Storybook

sticky-header

Name Score Ada Lovelace98 Grace Hopper96 Alan Turing95 Katherine Johnson94 Margaret Hamilton93 Barbara Liskov92

frozen-header

Name Score Ada Lovelace98 Grace Hopper96 Alan Turing95 Katherine Johnson94 Margaret Hamilton93 Barbara Liskov92

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
  <div style="flex: 1 1 320px; min-inline-size: 280px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>sticky-header</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table column-template="2fr 1fr" sticky-header label="Sticky header">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col" numeric>Score</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <div style="flex: 1 1 320px; min-inline-size: 280px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>frozen-header</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table column-template="2fr 1fr" frozen-header label="Frozen header">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col" numeric>Score</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'flex', gap: '24px', flexWrap: 'wrap', alignItems: 'flex-start' }}>
        <div style={{ flex: '1 1 320px', minInlineSize: '280px' }}>
          <p style={{ margin: '0 0 8px', font: 'var(--md-sys-typescale-label-large)', color: 'var(--md-sys-color-on-surface-variant)' }}><code>sticky-header</code></p>
          <MdTableContainer variant="outlined" maxHeight="212px">
            <MdTable columnTemplate="2fr 1fr" stickyHeader label="Sticky header">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">Name</MdTableCell>
                  <MdTableCell head scope="col" numeric>Score</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow><MdTableCell>Ada Lovelace</MdTableCell><MdTableCell numeric>98</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Grace Hopper</MdTableCell><MdTableCell numeric>96</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Alan Turing</MdTableCell><MdTableCell numeric>95</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Katherine Johnson</MdTableCell><MdTableCell numeric>94</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Margaret Hamilton</MdTableCell><MdTableCell numeric>93</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Barbara Liskov</MdTableCell><MdTableCell numeric>92</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
        <div style={{ flex: '1 1 320px', minInlineSize: '280px' }}>
          <p style={{ margin: '0 0 8px', font: 'var(--md-sys-typescale-label-large)', color: 'var(--md-sys-color-on-surface-variant)' }}><code>frozen-header</code></p>
          <MdTableContainer variant="outlined" maxHeight="212px">
            <MdTable columnTemplate="2fr 1fr" frozenHeader label="Frozen header">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">Name</MdTableCell>
                  <MdTableCell head scope="col" numeric>Score</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow><MdTableCell>Ada Lovelace</MdTableCell><MdTableCell numeric>98</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Grace Hopper</MdTableCell><MdTableCell numeric>96</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Alan Turing</MdTableCell><MdTableCell numeric>95</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Katherine Johnson</MdTableCell><MdTableCell numeric>94</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Margaret Hamilton</MdTableCell><MdTableCell numeric>93</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Barbara Liskov</MdTableCell><MdTableCell numeric>92</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
  <div style="flex: 1 1 320px; min-inline-size: 280px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>sticky-header</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table column-template="2fr 1fr" sticky-header label="Sticky header">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col" numeric>Score</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <div style="flex: 1 1 320px; min-inline-size: 280px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>frozen-header</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table column-template="2fr 1fr" frozen-header label="Frozen header">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col" numeric>Score</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
    <div style="flex: 1 1 320px; min-inline-size: 280px;">
      <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>sticky-header</code></p>
      <md-table-container variant="outlined" max-height="212px">
        <md-table column-template="2fr 1fr" sticky-header label="Sticky header">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">Name</md-table-cell>
              <md-table-cell head scope="col" numeric>Score</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
    <div style="flex: 1 1 320px; min-inline-size: 280px;">
      <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>frozen-header</code></p>
      <md-table-container variant="outlined" max-height="212px">
        <md-table column-template="2fr 1fr" frozen-header label="Frozen header">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">Name</md-table-cell>
              <md-table-cell head scope="col" numeric>Score</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
  <div style="flex: 1 1 320px; min-inline-size: 280px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>sticky-header</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table column-template="2fr 1fr" sticky-header label="Sticky header">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col" numeric>Score</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <div style="flex: 1 1 320px; min-inline-size: 280px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>frozen-header</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table column-template="2fr 1fr" frozen-header label="Frozen header">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col" numeric>Score</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell numeric>98</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell numeric>96</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell numeric>95</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Katherine Johnson</md-table-cell><md-table-cell numeric>94</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell numeric>93</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Barbara Liskov</md-table-cell><md-table-cell numeric>92</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Scroll sideways — the first column stays put Open in Storybook

Client Q1 Q2 Q3 Q4 Total Acme Corp120180150210660 Globex90140170160560 Initech608095110345

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="220px">
  <md-table column-template="200px 140px 140px 140px 140px 140px" label="Wide table" sticky-header min-width="900px">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col" sticky="start">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
        <md-table-cell head scope="col" numeric>Q4</md-table-cell>
        <md-table-cell head scope="col" numeric>Total</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="s1"><md-table-cell head scope="row" sticky="start">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
      <md-table-row value="s2"><md-table-cell head scope="row" sticky="start">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
      <md-table-row value="s3"><md-table-cell head scope="row" sticky="start">Initech</md-table-cell><md-table-cell numeric>60</md-table-cell><md-table-cell numeric>80</md-table-cell><md-table-cell numeric>95</md-table-cell><md-table-cell numeric>110</md-table-cell><md-table-cell numeric>345</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined" maxHeight="220px">
        <MdTable columnTemplate="200px 140px 140px 140px 140px 140px" label="Wide table" stickyHeader minWidth="900px">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col" sticky="start">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Q1</MdTableCell>
              <MdTableCell head scope="col" numeric>Q2</MdTableCell>
              <MdTableCell head scope="col" numeric>Q3</MdTableCell>
              <MdTableCell head scope="col" numeric>Q4</MdTableCell>
              <MdTableCell head scope="col" numeric>Total</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="s1"><MdTableCell head scope="row" sticky="start">Acme Corp</MdTableCell><MdTableCell numeric>120</MdTableCell><MdTableCell numeric>180</MdTableCell><MdTableCell numeric>150</MdTableCell><MdTableCell numeric>210</MdTableCell><MdTableCell numeric>660</MdTableCell></MdTableRow>
            <MdTableRow value="s2"><MdTableCell head scope="row" sticky="start">Globex</MdTableCell><MdTableCell numeric>90</MdTableCell><MdTableCell numeric>140</MdTableCell><MdTableCell numeric>170</MdTableCell><MdTableCell numeric>160</MdTableCell><MdTableCell numeric>560</MdTableCell></MdTableRow>
            <MdTableRow value="s3"><MdTableCell head scope="row" sticky="start">Initech</MdTableCell><MdTableCell numeric>60</MdTableCell><MdTableCell numeric>80</MdTableCell><MdTableCell numeric>95</MdTableCell><MdTableCell numeric>110</MdTableCell><MdTableCell numeric>345</MdTableCell></MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined" max-height="220px">
  <md-table column-template="200px 140px 140px 140px 140px 140px" label="Wide table" sticky-header min-width="900px">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col" sticky="start">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
        <md-table-cell head scope="col" numeric>Q4</md-table-cell>
        <md-table-cell head scope="col" numeric>Total</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="s1"><md-table-cell head scope="row" sticky="start">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
      <md-table-row value="s2"><md-table-cell head scope="row" sticky="start">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
      <md-table-row value="s3"><md-table-cell head scope="row" sticky="start">Initech</md-table-cell><md-table-cell numeric>60</md-table-cell><md-table-cell numeric>80</md-table-cell><md-table-cell numeric>95</md-table-cell><md-table-cell numeric>110</md-table-cell><md-table-cell numeric>345</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined" max-height="220px">
    <md-table column-template="200px 140px 140px 140px 140px 140px" label="Wide table" sticky-header min-width="900px">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col" sticky="start">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Q1</md-table-cell>
          <md-table-cell head scope="col" numeric>Q2</md-table-cell>
          <md-table-cell head scope="col" numeric>Q3</md-table-cell>
          <md-table-cell head scope="col" numeric>Q4</md-table-cell>
          <md-table-cell head scope="col" numeric>Total</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="s1"><md-table-cell head scope="row" sticky="start">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
        <md-table-row value="s2"><md-table-cell head scope="row" sticky="start">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
        <md-table-row value="s3"><md-table-cell head scope="row" sticky="start">Initech</md-table-cell><md-table-cell numeric>60</md-table-cell><md-table-cell numeric>80</md-table-cell><md-table-cell numeric>95</md-table-cell><md-table-cell numeric>110</md-table-cell><md-table-cell numeric>345</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="220px">
  <md-table column-template="200px 140px 140px 140px 140px 140px" label="Wide table" sticky-header min-width="900px">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col" sticky="start">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
        <md-table-cell head scope="col" numeric>Q4</md-table-cell>
        <md-table-cell head scope="col" numeric>Total</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="s1"><md-table-cell head scope="row" sticky="start">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
      <md-table-row value="s2"><md-table-cell head scope="row" sticky="start">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
      <md-table-row value="s3"><md-table-cell head scope="row" sticky="start">Initech</md-table-cell><md-table-cell numeric>60</md-table-cell><md-table-cell numeric>80</md-table-cell><md-table-cell numeric>95</md-table-cell><md-table-cell numeric>110</md-table-cell><md-table-cell numeric>345</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Without a sticky column the same table simply scrolls as one plane — min-width is what forces the overflow rather than letting the columns crush:

A table wider than its container Open in Storybook

Client Q1 Q2 Q3 Q4 Total Acme Corp120180150210660 Globex90140170160560

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="repeat(6, 160px)" label="Horizontal scroll" min-width="960px">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
        <md-table-cell head scope="col" numeric>Q4</md-table-cell>
        <md-table-cell head scope="col" numeric>Total</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="h1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
      <md-table-row value="h2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="repeat(6, 160px)" label="Horizontal scroll" minWidth="960px">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Q1</MdTableCell>
              <MdTableCell head scope="col" numeric>Q2</MdTableCell>
              <MdTableCell head scope="col" numeric>Q3</MdTableCell>
              <MdTableCell head scope="col" numeric>Q4</MdTableCell>
              <MdTableCell head scope="col" numeric>Total</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="h1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>120</MdTableCell><MdTableCell numeric>180</MdTableCell><MdTableCell numeric>150</MdTableCell><MdTableCell numeric>210</MdTableCell><MdTableCell numeric>660</MdTableCell></MdTableRow>
            <MdTableRow value="h2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>90</MdTableCell><MdTableCell numeric>140</MdTableCell><MdTableCell numeric>170</MdTableCell><MdTableCell numeric>160</MdTableCell><MdTableCell numeric>560</MdTableCell></MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="repeat(6, 160px)" label="Horizontal scroll" min-width="960px">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
        <md-table-cell head scope="col" numeric>Q4</md-table-cell>
        <md-table-cell head scope="col" numeric>Total</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="h1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
      <md-table-row value="h2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="repeat(6, 160px)" label="Horizontal scroll" min-width="960px">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Q1</md-table-cell>
          <md-table-cell head scope="col" numeric>Q2</md-table-cell>
          <md-table-cell head scope="col" numeric>Q3</md-table-cell>
          <md-table-cell head scope="col" numeric>Q4</md-table-cell>
          <md-table-cell head scope="col" numeric>Total</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="h1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
        <md-table-row value="h2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="repeat(6, 160px)" label="Horizontal scroll" min-width="960px">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
        <md-table-cell head scope="col" numeric>Q4</md-table-cell>
        <md-table-cell head scope="col" numeric>Total</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="h1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>120</md-table-cell><md-table-cell numeric>180</md-table-cell><md-table-cell numeric>150</md-table-cell><md-table-cell numeric>210</md-table-cell><md-table-cell numeric>660</md-table-cell></md-table-row>
      <md-table-row value="h2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>90</md-table-cell><md-table-cell numeric>140</md-table-cell><md-table-cell numeric>170</md-table-cell><md-table-cell numeric>160</md-table-cell><md-table-cell numeric>560</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

scrollbar=overlay against scrollbar=gutter — scroll each body Open in Storybook

scrollbar="overlay"

Client Amount Acme Corp$1,200.00 Globex$3,120.00 Initech$860.00 Umbrella$2,450.00 Soylent$1,975.00 Hooli$4,300.00 Stark Industries$8,120.00 Cyberdyne$2,010.00

scrollbar="gutter"

Client Amount Acme Corp$1,200.00 Globex$3,120.00 Initech$860.00 Umbrella$2,450.00 Soylent$1,975.00 Hooli$4,300.00 Stark Industries$8,120.00 Cyberdyne$2,010.00

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
  <div style="flex: 1 1 340px; min-inline-size: 300px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="overlay"</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table frozen-header scrollbar="overlay" column-template="2fr 1fr" label="overlay scrollbar">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <div style="flex: 1 1 340px; min-inline-size: 300px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="gutter"</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table frozen-header scrollbar="gutter" column-template="2fr 1fr" label="gutter scrollbar">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'flex', gap: '24px', flexWrap: 'wrap', alignItems: 'flex-start' }}>
        <div style={{ flex: '1 1 340px', minInlineSize: '300px' }}>
          <p style={{ margin: '0 0 8px', font: 'var(--md-sys-typescale-label-large)', color: 'var(--md-sys-color-on-surface-variant)' }}><code>scrollbar="overlay"</code></p>
          <MdTableContainer variant="outlined" maxHeight="212px">
            <MdTable frozenHeader scrollbar="overlay" columnTemplate="2fr 1fr" label="overlay scrollbar">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">Client</MdTableCell>
                  <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow><MdTableCell>Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Initech</MdTableCell><MdTableCell numeric>$860.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Umbrella</MdTableCell><MdTableCell numeric>$2,450.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Soylent</MdTableCell><MdTableCell numeric>$1,975.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Hooli</MdTableCell><MdTableCell numeric>$4,300.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Stark Industries</MdTableCell><MdTableCell numeric>$8,120.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Cyberdyne</MdTableCell><MdTableCell numeric>$2,010.00</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
        <div style={{ flex: '1 1 340px', minInlineSize: '300px' }}>
          <p style={{ margin: '0 0 8px', font: 'var(--md-sys-typescale-label-large)', color: 'var(--md-sys-color-on-surface-variant)' }}><code>scrollbar="gutter"</code></p>
          <MdTableContainer variant="outlined" maxHeight="212px">
            <MdTable frozenHeader scrollbar="gutter" columnTemplate="2fr 1fr" label="gutter scrollbar">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">Client</MdTableCell>
                  <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow><MdTableCell>Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Initech</MdTableCell><MdTableCell numeric>$860.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Umbrella</MdTableCell><MdTableCell numeric>$2,450.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Soylent</MdTableCell><MdTableCell numeric>$1,975.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Hooli</MdTableCell><MdTableCell numeric>$4,300.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Stark Industries</MdTableCell><MdTableCell numeric>$8,120.00</MdTableCell></MdTableRow>
                <MdTableRow><MdTableCell>Cyberdyne</MdTableCell><MdTableCell numeric>$2,010.00</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
  <div style="flex: 1 1 340px; min-inline-size: 300px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="overlay"</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table frozen-header scrollbar="overlay" column-template="2fr 1fr" label="overlay scrollbar">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <div style="flex: 1 1 340px; min-inline-size: 300px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="gutter"</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table frozen-header scrollbar="gutter" column-template="2fr 1fr" label="gutter scrollbar">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
    <div style="flex: 1 1 340px; min-inline-size: 300px;">
      <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="overlay"</code></p>
      <md-table-container variant="outlined" max-height="212px">
        <md-table frozen-header scrollbar="overlay" column-template="2fr 1fr" label="overlay scrollbar">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">Client</md-table-cell>
              <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
    <div style="flex: 1 1 340px; min-inline-size: 300px;">
      <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="gutter"</code></p>
      <md-table-container variant="outlined" max-height="212px">
        <md-table frozen-header scrollbar="gutter" column-template="2fr 1fr" label="gutter scrollbar">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">Client</md-table-cell>
              <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
            <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: flex; gap: 24px; flex-wrap: wrap; align-items: flex-start;">
  <div style="flex: 1 1 340px; min-inline-size: 300px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="overlay"</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table frozen-header scrollbar="overlay" column-template="2fr 1fr" label="overlay scrollbar">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <div style="flex: 1 1 340px; min-inline-size: 300px;">
    <p style="margin: 0 0 8px; font: var(--md-sys-typescale-label-large); color: var(--md-sys-color-on-surface-variant);"><code>scrollbar="gutter"</code></p>
    <md-table-container variant="outlined" max-height="212px">
      <md-table frozen-header scrollbar="gutter" column-template="2fr 1fr" label="gutter scrollbar">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row><md-table-cell>Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell></md-table-row>
          <md-table-row><md-table-cell>Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Related stories: a sticky column, horizontal scroll, scrollbar modes.

Column pinning & visibility

Pinning is imperative: call pinColumn(index, 'start' | 'end' | 'none') with the column’s original 0-based index (its position before any pinning). The table re-sequences every row’s cells, maintains the sticky attributes, permutes the column template, and emits mdPinChange. Selection and expansion state survive — the elements just move. The move is a deliberate snap, not a FLIP.

pinColumn toggles — it is not a plain setter

Passing the side a column is already pinned to unpins it, exactly as 'none' does. The promise resolves to the column’s effective side afterwards ('start', 'end' or null), so read that rather than assuming your argument took. Pin once at setup; re-running the same pin calls on a later state change (a pin-mode switch, a re-render) silently undoes the pinning. Changing pin-mode needs no re-pin — the table recomputes the sticky offsets itself.

pin-mode decides how multiple pins on one side behave:

pin-mode	Behaviour
stack (default)	All pinned columns stick at the same edge, so later ones slide over earlier ones — only the top one stays fully visible
static	Each gets a cumulative inset, so they all stay visible side-by-side (spreadsheet-style)

setColumnVisibility(index, visible) hides or shows a column: the cells stay in the DOM (state survives) and only their track leaves the template. The last visible column cannot be hidden. pin-icon sets a table-wide pin glyph; a cell’s own pin-icon wins over the cast.

const table = document.querySelector('md-table');

await table.pinColumn(0, 'start');          // freeze the first column
await table.setColumnVisibility(3, false);  // hide the fourth column

Pinned headers carry a pin marker of their own — suppress it per cell with no-pin-indicator.

Pinned columns — scroll sideways, and switch the pin mode

pin-mode="stack" pin-mode="static"

Name Team Role Location Salary Actions Ada LovelaceEngineeringMathematicianLondon$120,000 Alan TuringSecurityCryptanalystManchester$145,000 Grace HopperPlatformCompiler EngineerNew York$132,000 Linus TorvaldsInfrastructureKernel EngineerPortland$168,000 Margaret HamiltonAvionicsSoftware LeadBoston$175,000

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html <head> — the icon font the components draw from -->
<link rel="stylesheet"
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap">

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 12px; justify-items: start;">
  <div style="display: flex; gap: 8px;">
    <md-chip id="pin-stack" variant="filter" selected>pin-mode="stack"</md-chip>
    <md-chip id="pin-static" variant="filter">pin-mode="static"</md-chip>
  </div>
  <md-table-container variant="outlined" style="inline-size: 100%;">
    <md-table id="pin-table" pin-mode="stack" column-template="180px 160px 200px 160px 140px 120px" min-width="960px" label="Pinned columns">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Team</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col">Location</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
          <md-table-cell head scope="col">Actions</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row><md-table-cell>Ada Lovelace</md-table-cell><md-table-cell>Engineering</md-table-cell><md-table-cell>Mathematician</md-table-cell><md-table-cell>London</md-table-cell><md-table-cell numeric>$120,000</md-table-cell><md-table-cell><md-icon-button icon="edit" aria-label="Edit Ada Lovelace" density="-2"></md-icon-button><md-icon-button icon="delete" aria-label="Delete Ada Lovelace" density="-2"></md-icon-button></md-table-cell></md-table-row>
        <md-table-row><md-table-cell>Alan Turing</md-table-cell><md-table-cell>Security</md-table-cell><md-table-cell>Cryptanalyst</md-table-cell><md-table-cell>Manchester</md-table-cell><md-table-cell numeric>$145,000</md-table-cell><md-table-cell><md-icon-button icon="edit" aria-label="Edit Alan Turing" density="-2"></md-icon-button><md-icon-button icon="delete" aria-label="Delete Alan Turing" density="-2"></md-icon-button></md-table-cell></md-table-row>
        <md-table-row><md-table-cell>Grace Hopper</md-table-cell><md-table-cell>Platform</md-table-cell><md-table-cell>Compiler Engineer</md-table-cell><md-table-cell>New York</md-table-cell><md-table-cell numeric>$132,000</md-table-cell><md-table-cell><md-icon-button icon="edit" aria-label="Edit Grace Hopper" density="-2"></md-icon-button><md-icon-button icon="delete" aria-label="Delete Grace Hopper" density="-2"></md-icon-button></md-table-cell></md-table-row>
        <md-table-row><md-table-cell>Linus Torvalds</md-table-cell><md-table-cell>Infrastructure</md-table-cell><md-table-cell>Kernel Engineer</md-table-cell><md-table-cell>Portland</md-table-cell><md-table-cell numeric>$168,000</md-table-cell><md-table-cell><md-icon-button icon="edit" aria-label="Edit Linus Torvalds" density="-2"></md-icon-button><md-icon-button icon="delete" aria-label="Delete Linus Torvalds" density="-2"></md-icon-button></md-table-cell></md-table-row>
        <md-table-row><md-table-cell>Margaret Hamilton</md-table-cell><md-table-cell>Avionics</md-table-cell><md-table-cell>Software Lead</md-table-cell><md-table-cell>Boston</md-table-cell><md-table-cell numeric>$175,000</md-table-cell><md-table-cell><md-icon-button icon="edit" aria-label="Edit Margaret Hamilton" density="-2"></md-icon-button><md-icon-button icon="delete" aria-label="Delete Margaret Hamilton" density="-2"></md-icon-button></md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

<script type="module">
  var table = document.getElementById('pin-table');
  // Pin Name + Team to the start and Actions to the end, so the middle columns
  // are what actually scrolls. Pin ONCE: pinColumn toggles, so re-running these
  // three calls would UNPIN the very columns they pinned. Switching pin-mode
  // does not need a re-pin — the table recomputes the offsets on its own.
  table.pinColumn(0, 'start');
  table.pinColumn(1, 'start');
  table.pinColumn(5, 'end');
  var stack = document.getElementById('pin-stack');
  var stat = document.getElementById('pin-static');
  var setMode = function (mode) {
    table.pinMode = mode;
    stack.selected = mode === 'stack';
    stat.selected = mode === 'static';
  };
  stack.addEventListener('mdSelect', function () { setMode('stack'); });
  stat.addEventListener('mdSelect', function () { setMode('static'); });
</script>

Copy

import { useEffect, useRef, useState } from 'react';
import {
MdChip, MdIconButton, MdTable, MdTableBody, MdTableCell, MdTableContainer,
MdTableHead, MdTableRow,
} from '@awc-ui/react';

const PEOPLE = [
{ name: 'Ada Lovelace', team: 'Engineering', role: 'Mathematician', location: 'London', salary: 120000 },
{ name: 'Alan Turing', team: 'Security', role: 'Cryptanalyst', location: 'Manchester', salary: 145000 },
{ name: 'Grace Hopper', team: 'Platform', role: 'Compiler Engineer', location: 'New York', salary: 132000 },
{ name: 'Linus Torvalds', team: 'Infrastructure', role: 'Kernel Engineer', location: 'Portland', salary: 168000 },
{ name: 'Margaret Hamilton', team: 'Avionics', role: 'Software Lead', location: 'Boston', salary: 175000 },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

export function PinnedColumns() {
const tableRef = useRef(null);
const [mode, setMode] = useState('stack');

// pinColumn is a method, not a prop — call it once the element exists, and
// ONLY once: it toggles, so a second identical call unpins. That is why this
// effect has an empty dep array and deliberately does NOT re-run on `mode`;
// changing pinMode recomputes the sticky offsets inside the component.
useEffect(() => {
  const table = tableRef.current;
  if (!table) return;
  void (async () => {
    await table.pinColumn(0, 'start');
    await table.pinColumn(1, 'start');
    await table.pinColumn(5, 'end');   // side 'none' unpins, as does re-passing 'end'
  })();
}, []);

return (
  <>
    <div style={{ display: 'flex', gap: 8 }}>
      <MdChip variant="filter" selected={mode === 'stack'} onMdSelect={() => setMode('stack')}>
        pin-mode="stack"
      </MdChip>
      <MdChip variant="filter" selected={mode === 'static'} onMdSelect={() => setMode('static')}>
        pin-mode="static"
      </MdChip>
    </div>

    <MdTableContainer variant="outlined">
      {/* pinColumn needs an explicit column-template (no repeat()) and one
          cell per column in every row. */}
      <MdTable
        ref={tableRef}
        pinMode={mode}
        columnTemplate="180px 160px 200px 160px 140px 120px"
        minWidth="960px"
        label="Pinned columns"
        onMdPinChange={(e) => console.log('pin:', e.detail)}
      >
        <MdTableHead>
          <MdTableRow rowgroup="head">
            {['Name', 'Team', 'Role', 'Location'].map((h) => (
              <MdTableCell key={h} head scope="col">{h}</MdTableCell>
            ))}
            <MdTableCell head scope="col" numeric>Salary</MdTableCell>
            <MdTableCell head scope="col">Actions</MdTableCell>
          </MdTableRow>
        </MdTableHead>
        <MdTableBody>
          {PEOPLE.map((p) => (
            <MdTableRow key={p.name}>
              <MdTableCell>{p.name}</MdTableCell>
              <MdTableCell>{p.team}</MdTableCell>
              <MdTableCell>{p.role}</MdTableCell>
              <MdTableCell>{p.location}</MdTableCell>
              <MdTableCell numeric>{money(p.salary)}</MdTableCell>
              <MdTableCell>
                <MdIconButton icon="edit" aria-label={`Edit ${p.name}`} density={-2} />
                <MdIconButton icon="delete" aria-label={`Delete ${p.name}`} density={-2} />
              </MdTableCell>
            </MdTableRow>
          ))}
        </MdTableBody>
      </MdTable>
    </MdTableContainer>
  </>
);
}

Copy

// pinned-columns.component.ts
import { AfterViewInit, Component, CUSTOM_ELEMENTS_SCHEMA, ElementRef, ViewChild } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

type PinSide = 'start' | 'end' | 'none';
type PinnableTable = HTMLElement & { pinMode: string; pinColumn(i: number, side: PinSide): Promise<unknown> };

@Component({
selector: 'app-pinned-columns',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <div style="display: flex; gap: 8px;">
    <md-chip variant="filter" [attr.selected]="mode === 'stack' ? '' : null" (mdSelect)="setMode('stack')">
      pin-mode="stack"
    </md-chip>
    <md-chip variant="filter" [attr.selected]="mode === 'static' ? '' : null" (mdSelect)="setMode('static')">
      pin-mode="static"
    </md-chip>
  </div>

  <md-table-container variant="outlined">
    <md-table
      #table
      [attr.pin-mode]="mode"
      column-template="180px 160px 200px 160px 140px 120px"
      min-width="960px"
      label="Pinned columns"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Team</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col">Location</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
          <md-table-cell head scope="col">Actions</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let p of people; trackBy: trackByName">
          <md-table-cell>{{ p.name }}</md-table-cell>
          <md-table-cell>{{ p.team }}</md-table-cell>
          <md-table-cell>{{ p.role }}</md-table-cell>
          <md-table-cell>{{ p.location }}</md-table-cell>
          <md-table-cell numeric>{{ p.salary | currency:'USD':'symbol':'1.0-0' }}</md-table-cell>
          <md-table-cell>
            <md-icon-button icon="edit" [attr.aria-label]="'Edit ' + p.name" density="-2"></md-icon-button>
            <md-icon-button icon="delete" [attr.aria-label]="'Delete ' + p.name" density="-2"></md-icon-button>
          </md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
`,
})
export class PinnedColumnsComponent implements AfterViewInit {
@ViewChild('table') tableRef!: ElementRef<PinnableTable>;

mode: 'stack' | 'static' = 'stack';
people = [
  { name: 'Ada Lovelace', team: 'Engineering', role: 'Mathematician', location: 'London', salary: 120000 },
  { name: 'Alan Turing', team: 'Security', role: 'Cryptanalyst', location: 'Manchester', salary: 145000 },
  { name: 'Grace Hopper', team: 'Platform', role: 'Compiler Engineer', location: 'New York', salary: 132000 },
  { name: 'Linus Torvalds', team: 'Infrastructure', role: 'Kernel Engineer', location: 'Portland', salary: 168000 },
  { name: 'Margaret Hamilton', team: 'Avionics', role: 'Software Lead', location: 'Boston', salary: 175000 },
];

ngAfterViewInit() { void this.applyPins(); }

setMode(mode: 'stack' | 'static') {
  // No re-pin here on purpose: pinColumn toggles, so calling applyPins()
  // again would unpin all three columns. The table recomputes the sticky
  // offsets itself when pin-mode changes.
  this.mode = mode;
}

/** Called exactly once, after the view exists. */
private async applyPins() {
  const table = this.tableRef.nativeElement;
  await table.pinColumn(0, 'start');
  await table.pinColumn(1, 'start');
  await table.pinColumn(5, 'end');
}

trackByName = (_: number, p: { name: string }) => p.name;
}

Copy

<script setup>
import { onMounted, ref } from 'vue';
import '@awc-ui/core/define';

const PEOPLE = [
{ name: 'Ada Lovelace', team: 'Engineering', role: 'Mathematician', location: 'London', salary: 120000 },
{ name: 'Alan Turing', team: 'Security', role: 'Cryptanalyst', location: 'Manchester', salary: 145000 },
{ name: 'Grace Hopper', team: 'Platform', role: 'Compiler Engineer', location: 'New York', salary: 132000 },
{ name: 'Linus Torvalds', team: 'Infrastructure', role: 'Kernel Engineer', location: 'Portland', salary: 168000 },
{ name: 'Margaret Hamilton', team: 'Avionics', role: 'Software Lead', location: 'Boston', salary: 175000 },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

const table = ref(null);
const mode = ref('stack');

// pinColumn is a method — call it after mount, and ONLY then. It toggles, so
// re-pinning on a mode change would unpin all three columns; pin-mode changes
// recompute the sticky offsets inside the component with no help from us.
const applyPins = async () => {
await table.value.pinColumn(0, 'start');
await table.value.pinColumn(1, 'start');
await table.value.pinColumn(5, 'end');   // 'none' unpins — and so does a second 'end'
};

onMounted(applyPins);
</script>

<template>
<div style="display: flex; gap: 8px;">
  <md-chip variant="filter" :selected="mode === 'stack'" @mdSelect="mode = 'stack'">pin-mode="stack"</md-chip>
  <md-chip variant="filter" :selected="mode === 'static'" @mdSelect="mode = 'static'">pin-mode="static"</md-chip>
</div>

<md-table-container variant="outlined">
  <md-table
    ref="table"
    :pin-mode="mode"
    column-template="180px 160px 200px 160px 140px 120px"
    min-width="960px"
    label="Pinned columns"
    @mdPinChange="console.log('pin:', $event.detail)"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Name</md-table-cell>
        <md-table-cell head scope="col">Team</md-table-cell>
        <md-table-cell head scope="col">Role</md-table-cell>
        <md-table-cell head scope="col">Location</md-table-cell>
        <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        <md-table-cell head scope="col">Actions</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="p in PEOPLE" :key="p.name">
        <md-table-cell>{{ p.name }}</md-table-cell>
        <md-table-cell>{{ p.team }}</md-table-cell>
        <md-table-cell>{{ p.role }}</md-table-cell>
        <md-table-cell>{{ p.location }}</md-table-cell>
        <md-table-cell numeric>{{ money(p.salary) }}</md-table-cell>
        <md-table-cell>
          <md-icon-button icon="edit" :aria-label="'Edit ' + p.name" density="-2"></md-icon-button>
          <md-icon-button icon="delete" :aria-label="'Delete ' + p.name" density="-2"></md-icon-button>
        </md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
</template>

Copy

<script>
import { onMount } from 'svelte';
import '@awc-ui/core/define';

const PEOPLE = [
  { name: 'Ada Lovelace', team: 'Engineering', role: 'Mathematician', location: 'London', salary: 120000 },
  { name: 'Alan Turing', team: 'Security', role: 'Cryptanalyst', location: 'Manchester', salary: 145000 },
  { name: 'Grace Hopper', team: 'Platform', role: 'Compiler Engineer', location: 'New York', salary: 132000 },
  { name: 'Linus Torvalds', team: 'Infrastructure', role: 'Kernel Engineer', location: 'Portland', salary: 168000 },
  { name: 'Margaret Hamilton', team: 'Avionics', role: 'Software Lead', location: 'Boston', salary: 175000 },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

let table;
let mode = 'stack';

// pinColumn is a method — call it after mount, once. It toggles, so a second
// identical call unpins; and pin-mode changes recompute the sticky offsets
// inside the component, so there is nothing to re-pin.
const applyPins = async () => {
  await table.pinColumn(0, 'start');
  await table.pinColumn(1, 'start');
  await table.pinColumn(5, 'end');   // 'none' unpins — and so does a second 'end'
};

const setMode = (next) => { mode = next; };

onMount(applyPins);
</script>

<div style="display: flex; gap: 8px;">
<md-chip variant="filter" selected={mode === 'stack'} on:mdSelect={() => setMode('stack')}>pin-mode="stack"</md-chip>
<md-chip variant="filter" selected={mode === 'static'} on:mdSelect={() => setMode('static')}>pin-mode="static"</md-chip>
</div>

<md-table-container variant="outlined">
<md-table
  bind:this={table}
  pin-mode={mode}
  column-template="180px 160px 200px 160px 140px 120px"
  min-width="960px"
  label="Pinned columns"
  on:mdPinChange={(e) => console.log('pin:', e.detail)}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Name</md-table-cell>
      <md-table-cell head scope="col">Team</md-table-cell>
      <md-table-cell head scope="col">Role</md-table-cell>
      <md-table-cell head scope="col">Location</md-table-cell>
      <md-table-cell head scope="col" numeric>Salary</md-table-cell>
      <md-table-cell head scope="col">Actions</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each PEOPLE as p (p.name)}
      <md-table-row>
        <md-table-cell>{p.name}</md-table-cell>
        <md-table-cell>{p.team}</md-table-cell>
        <md-table-cell>{p.role}</md-table-cell>
        <md-table-cell>{p.location}</md-table-cell>
        <md-table-cell numeric>{money(p.salary)}</md-table-cell>
        <md-table-cell>
          <md-icon-button icon="edit" aria-label={'Edit ' + p.name} density="-2"></md-icon-button>
          <md-icon-button icon="delete" aria-label={'Delete ' + p.name} density="-2"></md-icon-button>
        </md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>
</md-table-container>

Sorting is state, not behaviour

md-table sorts nothing

sort-by / sort-order are display state and mdSortChange is a request — you reorder your own rows in response to it.

A md-table-sort-label inside a header cell renders the arrow (3-state: asc → desc → none) and asks the table to change sort; the table pushes the new state down to every sort label and emits mdSortChange.

Call animateNextChange() before you re-render the sorted rows — it snapshots the current row boxes and FLIP-animates whatever the next synchronous DOM mutation does to them. Re-render without it and the reorder animation is lost. (Sort and pagination driven through the table’s own events are bracketed automatically; custom filters, async refetches and any other out-of-band reorder need the explicit call. Async mutations settle as a clean no-op.)

motion="expressive" is the default; set motion="none" to opt out (e.g. when you drive your own FLIP wiring). prefers-reduced-motion always wins.

table.addEventListener('mdSortChange', (e) => {
  table.animateNextChange();          // opt into the reorder animation
  renderRows(sortData(e.detail));     // YOU sort
});

setSort(column, order) sets the state programmatically without a click.

Sortable columns — click a header to sort, click again to reverse Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Initech$860.00Paid Umbrella$2,450.00Draft

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table id="sortable" column-template="2fr 1fr 1fr" label="Sortable invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="status">Status</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body id="sortable-body">
      <md-table-row value="r1" data-idx="0"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2" data-idx="1"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="r3" data-idx="2"><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r4" data-idx="3"><md-table-cell head scope="row">Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

<script type="module">
  var COLS = { client: 0, amount: 1, status: 2 };
  var body = document.getElementById('sortable-body');
  document.getElementById('sortable').addEventListener('mdSortChange', function (e) {
    var column = e.detail.column;
    var order = e.detail.order;
    var rows = Array.prototype.slice.call(body.querySelectorAll('md-table-row'));
    rows.sort(function (a, b) {
      // order 'none' is the third click — restore the authored order.
      if (order === 'none' || !(column in COLS)) return a.dataset.idx - b.dataset.idx;
      var i = COLS[column];
      var av = (a.children[i].textContent || '').trim();
      var bv = (b.children[i].textContent || '').trim();
      var cmp = column === 'amount'
        ? parseFloat(av.replace(/[^0-9.-]/g, '')) - parseFloat(bv.replace(/[^0-9.-]/g, ''))
        : av.localeCompare(bv);
      return order === 'desc' ? -cmp : cmp;
    });
    rows.forEach(function (r) { body.appendChild(r); });
  });
</script>

Copy

import { useMemo, useState } from 'react';
import {
MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow, MdTableSortLabel,
} from '@awc-ui/react';

const INVOICES = [
{ id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
{ id: 'r4', client: 'Umbrella', amount: 2450, status: 'Draft' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

export function SortableInvoices() {
const [sort, setSort] = useState({ column: '', order: 'none' });

const rows = useMemo(() => {
  if (!sort.column || sort.order === 'none') return INVOICES;
  const dir = sort.order === 'desc' ? -1 : 1;
  return [...INVOICES].sort((a, b) => {
    const av = a[sort.column];
    const bv = b[sort.column];
    return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
  });
}, [sort]);

return (
  <MdTableContainer variant="outlined">
    {/* md-table tracks which column is active and which way it points; the
        event just tells you what to sort by. */}
    <MdTable
      columnTemplate="2fr 1fr 1fr"
      label="Sortable invoices"
      onMdSortChange={(e) => setSort(e.detail)}
    >
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head scope="col"><MdTableSortLabel column="client">Client</MdTableSortLabel></MdTableCell>
          <MdTableCell head scope="col" numeric><MdTableSortLabel column="amount">Amount</MdTableSortLabel></MdTableCell>
          <MdTableCell head scope="col"><MdTableSortLabel column="status">Status</MdTableSortLabel></MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {rows.map((row) => (
          <MdTableRow key={row.id} value={row.id}>
            <MdTableCell head scope="row">{row.client}</MdTableCell>
            <MdTableCell numeric>{money(row.amount)}</MdTableCell>
            <MdTableCell>{row.status}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
    </MdTable>
  </MdTableContainer>
);
}

Copy

// sortable-invoices.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Invoice { id: string; client: string; amount: number; status: string; }

@Component({
selector: 'app-sortable-invoices',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined">
    <md-table
      column-template="2fr 1fr 1fr"
      label="Sortable invoices"
      (mdSortChange)="onSort($event)"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col"><md-table-sort-label column="status">Status</md-table-sort-label></md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of sorted; trackBy: trackById" [attr.value]="row.id">
          <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
          <md-table-cell numeric>{{ row.amount | currency }}</md-table-cell>
          <md-table-cell>{{ row.status }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
`,
})
export class SortableInvoicesComponent {
private readonly invoices: Invoice[] = [
  { id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
  { id: 'r4', client: 'Umbrella', amount: 2450, status: 'Draft' },
];

sorted = this.invoices;

onSort(event: Event) {
  const { column, order } = (event as CustomEvent<{ column: string; order: string }>).detail;
  if (!column || order === 'none') {
    this.sorted = this.invoices;
    return;
  }
  const dir = order === 'desc' ? -1 : 1;
  this.sorted = [...this.invoices].sort((a, b) => {
    const av = a[column as keyof Invoice];
    const bv = b[column as keyof Invoice];
    return (typeof av === 'number' && typeof bv === 'number'
      ? av - bv
      : String(av).localeCompare(String(bv))) * dir;
  });
}

trackById = (_: number, row: Invoice) => row.id;
}

Copy

<script setup>
import { computed, ref } from 'vue';
import '@awc-ui/core/define';

const INVOICES = [
{ id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
{ id: 'r4', client: 'Umbrella', amount: 2450, status: 'Draft' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

const sort = ref({ column: '', order: 'none' });

const rows = computed(() => {
if (!sort.value.column || sort.value.order === 'none') return INVOICES;
const dir = sort.value.order === 'desc' ? -1 : 1;
return [...INVOICES].sort((a, b) => {
  const av = a[sort.value.column];
  const bv = b[sort.value.column];
  return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
});
});
</script>

<template>
<md-table-container variant="outlined">
  <md-table
    column-template="2fr 1fr 1fr"
    label="Sortable invoices"
    @mdSortChange="sort = $event.detail"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="status">Status</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in rows" :key="row.id" :value="row.id">
        <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.amount) }}</md-table-cell>
        <md-table-cell>{{ row.status }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
</template>

Copy

<script>
import '@awc-ui/core/define';

const INVOICES = [
  { id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
  { id: 'r4', client: 'Umbrella', amount: 2450, status: 'Draft' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

let sort = { column: '', order: 'none' };

$: rows = !sort.column || sort.order === 'none'
  ? INVOICES
  : [...INVOICES].sort((a, b) => {
      const dir = sort.order === 'desc' ? -1 : 1;
      const av = a[sort.column];
      const bv = b[sort.column];
      return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
    });
</script>

<md-table-container variant="outlined">
<md-table
  column-template="2fr 1fr 1fr"
  label="Sortable invoices"
  on:mdSortChange={(e) => (sort = e.detail)}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col"><md-table-sort-label column="status">Status</md-table-sort-label></md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each rows as row (row.id)}
      <md-table-row value={row.id}>
        <md-table-cell head scope="row">{row.client}</md-table-cell>
        <md-table-cell numeric>{money(row.amount)}</md-table-cell>
        <md-table-cell>{row.status}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>
</md-table-container>

The sortable story wires the full round-trip — click a header, reorder your own array, feed it back.

Selection

selection	Behaviour
none (default)	No selection
single	Radio-like — selecting a row deselects every other; selectAll() and the select-all checkbox are inert
multiple	Checkbox-like — select-all checkbox plus selectAll() / deselectAll() / toggleSelectAll()

Give each selectable row a value — that is what comes back in the selection state. Mark totals rows selectable="false" so selectAll() skips them.

You author the checkboxes; the table handles them. Slot a md-checkbox into a padding="checkbox" cell in each row, and one more into the head row for the select-all box. From there the table takes over: it listens for their mdChange itself, selects the row (or runs select-all / deselect-all from the head box), and keeps that box’s indeterminate “some but not all” state in sync. Plain markup works with zero wiring. The handling is deliberately declarative — it applies the checkbox’s end state rather than toggling — so a handler of your own calling toggleSelectAll() on top of it converges to the same result rather than cancelling out; it is simply redundant. Call toggleSelectAll() when something other than the select-all checkbox drives select-all: a toolbar button, a menu item, a keyboard shortcut.

const { count, total, values, all, indeterminate } = await table.getSelection();

mdSelectionChange carries the same MdTableSelectionState shape on every change.

Multiple selection — row checkboxes, select-all, and the toolbar's selection mode Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Initech$860.00Paid

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html <head> — the icon font the components draw from -->
<link rel="stylesheet"
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap">

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Select rows to act on them" auto-bind>
    <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive"></md-icon-button>
  </md-table-toolbar>
  <md-table id="selectable" column-template="auto 2fr 1fr 1fr" label="Selectable invoices" selection="multiple">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"><md-checkbox id="select-all" aria-label="Select all rows"></md-checkbox></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Acme Corp"></md-checkbox></md-table-cell><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Globex"></md-checkbox></md-table-cell><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="r3"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Initech"></md-checkbox></md-table-cell><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

<script type="module">
  import '@awc-ui/core/define';

  const table = document.getElementById('selectable');

  // No checkbox wiring here on purpose. You AUTHOR the checkboxes (the table
  // does not generate them), but with selection="multiple" the table handles
  // them: a slotted md-checkbox in a body row selects that row, and one in the
  // head acts as the select-all box — selectAll / deselectAll, plus the
  // indeterminate ("some but not all") state. Only reach for toggleSelectAll()
  // when something OTHER than the select-all checkbox drives it (a menu item, a
  // keyboard shortcut).

  // auto-bind on the toolbar makes it follow this event into selection mode;
  // without it, read event.detail.values yourself.
  table.addEventListener('mdSelectionChange', (e) => {
    console.log('selected rows:', e.detail.values);
  });
</script>

Copy

import { useRef, useState } from 'react';
import {
MdCheckbox, MdIconButton, MdTable, MdTableBody, MdTableCell, MdTableContainer,
MdTableHead, MdTableRow, MdTableToolbar,
} from '@awc-ui/react';

const INVOICES = [
{ id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

export function SelectableInvoices() {
const tableRef = useRef(null);
const [selected, setSelected] = useState([]);

return (
  <MdTableContainer variant="outlined">
    {/* autoBind makes the toolbar switch to selection mode on its own. */}
    <MdTableToolbar slot="top" headline="Invoices" supportingText="Select rows to act on them" autoBind>
      <MdIconButton slot="actions" icon="filter_list" aria-label="Filter" />
      <MdIconButton slot="selection-actions" icon="delete" aria-label="Delete" />
      <MdIconButton slot="selection-actions" icon="archive" aria-label="Archive" />
    </MdTableToolbar>

    <MdTable
      ref={tableRef}
      columnTemplate="auto 2fr 1fr 1fr"
      label="Selectable invoices"
      selection="multiple"
      onMdSelectionChange={(e) => setSelected(e.detail.values)}
    >
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head padding="checkbox">
            {/* OPTIONAL: the table already handles a slotted head checkbox
                as the select-all box. This explicit handler is kept only to show
                the imperative route; the handling is declarative, so the two
                converge instead of cancelling. Delete it and select-all still
                works. */}
            <MdCheckbox aria-label="Select all rows" onMdChange={() => tableRef.current?.toggleSelectAll()} />
          </MdTableCell>
          <MdTableCell head scope="col">Client</MdTableCell>
          <MdTableCell head scope="col" numeric>Amount</MdTableCell>
          <MdTableCell head scope="col">Status</MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {INVOICES.map((row) => (
          <MdTableRow key={row.id} value={row.id}>
            <MdTableCell padding="checkbox"><MdCheckbox aria-label={`Select ${row.client}`} /></MdTableCell>
            <MdTableCell head scope="row">{row.client}</MdTableCell>
            <MdTableCell numeric>{money(row.amount)}</MdTableCell>
            <MdTableCell>{row.status}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
    </MdTable>
  </MdTableContainer>
);
}

Copy

// selectable-invoices.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA, ElementRef, ViewChild } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Invoice { id: string; client: string; amount: number; status: string; }

@Component({
selector: 'app-selectable-invoices',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined">
    <md-table-toolbar slot="top" headline="Invoices" supporting-text="Select rows to act on them" auto-bind>
      <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
      <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
      <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive"></md-icon-button>
    </md-table-toolbar>

    <md-table
      #table
      column-template="auto 2fr 1fr 1fr"
      label="Selectable invoices"
      selection="multiple"
      (mdSelectionChange)="selected = $any($event).detail.values"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox">
            <md-checkbox aria-label="Select all rows" (mdChange)="selectAll()"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of invoices; trackBy: trackById" [attr.value]="row.id">
          <md-table-cell padding="checkbox">
            <md-checkbox [attr.aria-label]="'Select ' + row.client"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
          <md-table-cell numeric>{{ row.amount | currency }}</md-table-cell>
          <md-table-cell>{{ row.status }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
`,
})
export class SelectableInvoicesComponent {
@ViewChild('table') tableRef!: ElementRef<HTMLElement & { toggleSelectAll(): Promise<void> }>;

invoices: Invoice[] = [
  { id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
];
selected: string[] = [];

selectAll() {
  void this.tableRef.nativeElement.toggleSelectAll();
}

trackById = (_: number, row: Invoice) => row.id;
}

Copy

<script setup>
import { ref } from 'vue';
import '@awc-ui/core/define';

const INVOICES = [
{ id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

const table = ref(null);
const selected = ref([]);
</script>

<template>
<md-table-container variant="outlined">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Select rows to act on them" auto-bind>
    <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive"></md-icon-button>
  </md-table-toolbar>

  <md-table
    ref="table"
    column-template="auto 2fr 1fr 1fr"
    label="Selectable invoices"
    selection="multiple"
    @mdSelectionChange="selected = $event.detail.values"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox">
          <md-checkbox aria-label="Select all rows" @mdChange="table.toggleSelectAll()"></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in INVOICES" :key="row.id" :value="row.id">
        <md-table-cell padding="checkbox">
          <md-checkbox :aria-label="'Select ' + row.client"></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.amount) }}</md-table-cell>
        <md-table-cell>{{ row.status }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
</template>

Copy

<script>
import '@awc-ui/core/define';

const INVOICES = [
  { id: 'r1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'r2', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'r3', client: 'Initech', amount: 860, status: 'Paid' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

let table;
let selected = [];
</script>

<md-table-container variant="outlined">
<md-table-toolbar slot="top" headline="Invoices" supporting-text="Select rows to act on them" auto-bind>
  <md-icon-button slot="actions" icon="filter_list" aria-label="Filter"></md-icon-button>
  <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete"></md-icon-button>
  <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive"></md-icon-button>
</md-table-toolbar>

<md-table
  bind:this={table}
  column-template="auto 2fr 1fr 1fr"
  label="Selectable invoices"
  selection="multiple"
  on:mdSelectionChange={(e) => (selected = e.detail.values)}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head padding="checkbox">
        <md-checkbox aria-label="Select all rows" on:mdChange={() => table.toggleSelectAll()}></md-checkbox>
      </md-table-cell>
      <md-table-cell head scope="col">Client</md-table-cell>
      <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      <md-table-cell head scope="col">Status</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each INVOICES as row (row.id)}
      <md-table-row value={row.id}>
        <md-table-cell padding="checkbox">
          <md-checkbox aria-label={'Select ' + row.client}></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="row">{row.client}</md-table-cell>
        <md-table-cell numeric>{money(row.amount)}</md-table-cell>
        <md-table-cell>{row.status}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>
</md-table-container>

Expandable rows — click a caret to reveal the row's expanded slot Open in Storybook

Client Amount Status Acme Corp $1,200.00 Paid

Three line items · paid by card ending 4242 on 4 May.

Globex $3,120.00 Pending

Awaiting PO approval — chased 2 days ago.

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="auto 2fr 1fr 1fr" label="Expandable invoices" keep-height="false">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="e1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="e2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableExpandToggle, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="auto 2fr 1fr 1fr" label="Expandable invoices" keepHeight="false">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head padding="checkbox"></MdTableCell>
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="e1" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Acme Corp"></MdTableExpandToggle></MdTableCell>
              <MdTableCell head scope="row">Acme Corp</MdTableCell>
              <MdTableCell numeric>$1,200.00</MdTableCell>
              <MdTableCell>Paid</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Three line items · paid by card ending 4242 on 4 May.</div>
            </MdTableRow>
            <MdTableRow value="e2" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Globex"></MdTableExpandToggle></MdTableCell>
              <MdTableCell head scope="row">Globex</MdTableCell>
              <MdTableCell numeric>$3,120.00</MdTableCell>
              <MdTableCell>Pending</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Awaiting PO approval — chased 2 days ago.</div>
            </MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="auto 2fr 1fr 1fr" label="Expandable invoices" keep-height="false">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="e1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="e2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="auto 2fr 1fr 1fr" label="Expandable invoices" keep-height="false">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox"></md-table-cell>
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="e1" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
          <md-table-cell head scope="row">Acme Corp</md-table-cell>
          <md-table-cell numeric>$1,200.00</md-table-cell>
          <md-table-cell>Paid</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
        </md-table-row>
        <md-table-row value="e2" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
          <md-table-cell head scope="row">Globex</md-table-cell>
          <md-table-cell numeric>$3,120.00</md-table-cell>
          <md-table-cell>Pending</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="auto 2fr 1fr 1fr" label="Expandable invoices" keep-height="false">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="e1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="e2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Clickable rows — the whole row is one activation target Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Initech$860.00Paid

Click a row (or focus one and press Enter).

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Clickable invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="Acme Corp" clickable><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="Globex" clickable><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="Initech" clickable><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
<p id="click-out" role="status">Click a row (or focus one and press Enter).</p>

<script type="module">
  import '@awc-ui/core/define';

  // `clickable` gives the row role="button", a pointer cursor, a ripple and
  // Enter/Space activation — so one listener covers mouse and keyboard.
  // mdRowClick bubbles, so listening on the table catches every row.
  const out = document.getElementById('click-out');
  document.querySelector('md-table').addEventListener('mdRowClick', (e) => {
    out.textContent = `Opened invoice for ${e.detail.value}.`;
  });
</script>

Copy

import { useState } from 'react';
import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

const INVOICES = [
{ id: 'Acme Corp', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'Globex', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'Initech', client: 'Initech', amount: 860, status: 'Paid' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

export function ClickableInvoices() {
const [message, setMessage] = useState('Click a row (or focus one and press Enter).');

return (
  <>
    <MdTableContainer variant="outlined">
      <MdTable columnTemplate="2fr 1fr 1fr" label="Clickable invoices">
        <MdTableHead>
          <MdTableRow rowgroup="head">
            <MdTableCell head scope="col">Client</MdTableCell>
            <MdTableCell head scope="col" numeric>Amount</MdTableCell>
            <MdTableCell head scope="col">Status</MdTableCell>
          </MdTableRow>
        </MdTableHead>
        <MdTableBody>
          {INVOICES.map((row) => (
            // `clickable` adds role="button", the pointer cursor, a ripple and
            // Enter/Space activation — one handler serves mouse and keyboard.
            <MdTableRow
              key={row.id}
              value={row.id}
              clickable
              onMdRowClick={(e) => setMessage(`Opened invoice for ${e.detail.value}.`)}
            >
              <MdTableCell head scope="row">{row.client}</MdTableCell>
              <MdTableCell numeric>{money(row.amount)}</MdTableCell>
              <MdTableCell>{row.status}</MdTableCell>
            </MdTableRow>
          ))}
        </MdTableBody>
      </MdTable>
    </MdTableContainer>
    <p role="status">{message}</p>
  </>
);
}

Copy

// clickable-invoices.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Invoice { id: string; client: string; amount: number; status: string; }

@Component({
selector: 'app-clickable-invoices',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined">
    <!-- mdRowClick bubbles, so one listener on the table covers every row. -->
    <md-table column-template="2fr 1fr 1fr" label="Clickable invoices" (mdRowClick)="onRowClick($event)">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of invoices; trackBy: trackById" [attr.value]="row.id" clickable>
          <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
          <md-table-cell numeric>{{ row.amount | currency }}</md-table-cell>
          <md-table-cell>{{ row.status }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <p role="status">{{ message }}</p>
`,
})
export class ClickableInvoicesComponent {
invoices: Invoice[] = [
  { id: 'Acme Corp', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'Globex', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'Initech', client: 'Initech', amount: 860, status: 'Paid' },
];
message = 'Click a row (or focus one and press Enter).';

onRowClick(event: Event) {
  const { value } = (event as CustomEvent<{ value: string }>).detail;
  this.message = `Opened invoice for ${value}.`;
}

trackById = (_: number, row: Invoice) => row.id;
}

Copy

<script setup>
import { ref } from 'vue';
import '@awc-ui/core/define';

const INVOICES = [
{ id: 'Acme Corp', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'Globex', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'Initech', client: 'Initech', amount: 860, status: 'Paid' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

const message = ref('Click a row (or focus one and press Enter).');
const onRowClick = (e) => { message.value = `Opened invoice for ${e.detail.value}.`; };
</script>

<template>
<md-table-container variant="outlined">
  <!-- mdRowClick bubbles: one listener on the table serves every row. -->
  <md-table column-template="2fr 1fr 1fr" label="Clickable invoices" @mdRowClick="onRowClick">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in INVOICES" :key="row.id" :value="row.id" clickable>
        <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.amount) }}</md-table-cell>
        <md-table-cell>{{ row.status }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
<p role="status">{{ message }}</p>
</template>

Copy

<script>
import '@awc-ui/core/define';

const INVOICES = [
  { id: 'Acme Corp', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'Globex', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'Initech', client: 'Initech', amount: 860, status: 'Paid' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

let message = 'Click a row (or focus one and press Enter).';
</script>

<md-table-container variant="outlined">
<!-- mdRowClick bubbles: one listener on the table serves every row. -->
<md-table
  column-template="2fr 1fr 1fr"
  label="Clickable invoices"
  on:mdRowClick={(e) => (message = `Opened invoice for ${e.detail.value}.`)}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Client</md-table-cell>
      <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      <md-table-cell head scope="col">Status</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each INVOICES as row (row.id)}
      <md-table-row value={row.id} clickable>
        <md-table-cell head scope="row">{row.client}</md-table-cell>
        <md-table-cell numeric>{money(row.amount)}</md-table-cell>
        <md-table-cell>{row.status}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>
</md-table-container>
<p role="status">{message}</p>

Controls inside cells — edit in place Open in Storybook

Client Amount Status Acme Corp PaidPending Globex PaidPending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Editable cells">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="e1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="1200.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
        <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="paid" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
      </md-table-row>
      <md-table-row value="e2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="3120.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
        <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="pending" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdSelect, MdSelectOption, MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow, MdTextField } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="2fr 1fr 1fr" label="Editable cells">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="e1">
              <MdTableCell head scope="row">Acme Corp</MdTableCell>
              <MdTableCell numeric><MdTextField label="Amount" variant="outlined" value="1200.00" density="-2" style={{ inlineSize: '130px' }}></MdTextField></MdTableCell>
              <MdTableCell><MdSelect label="Status" variant="outlined" density="-2" value="paid" style={{ inlineSize: '130px' }}><MdSelectOption value="paid">Paid</MdSelectOption><MdSelectOption value="pending">Pending</MdSelectOption></MdSelect></MdTableCell>
            </MdTableRow>
            <MdTableRow value="e2">
              <MdTableCell head scope="row">Globex</MdTableCell>
              <MdTableCell numeric><MdTextField label="Amount" variant="outlined" value="3120.00" density="-2" style={{ inlineSize: '130px' }}></MdTextField></MdTableCell>
              <MdTableCell><MdSelect label="Status" variant="outlined" density="-2" value="pending" style={{ inlineSize: '130px' }}><MdSelectOption value="paid">Paid</MdSelectOption><MdSelectOption value="pending">Pending</MdSelectOption></MdSelect></MdTableCell>
            </MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Editable cells">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="e1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="1200.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
        <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="paid" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
      </md-table-row>
      <md-table-row value="e2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="3120.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
        <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="pending" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Editable cells">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="e1">
          <md-table-cell head scope="row">Acme Corp</md-table-cell>
          <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="1200.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
          <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="paid" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
        </md-table-row>
        <md-table-row value="e2">
          <md-table-cell head scope="row">Globex</md-table-cell>
          <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="3120.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
          <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="pending" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Editable cells">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="e1">
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="1200.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
        <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="paid" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
      </md-table-row>
      <md-table-row value="e2">
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric><md-text-field label="Amount" variant="outlined" value="3120.00" density="-2" style="inline-size: 130px;"></md-text-field></md-table-cell>
        <md-table-cell><md-select label="Status" variant="outlined" density="-2" value="pending" style="inline-size: 130px;"><md-select-option value="paid">Paid</md-select-option><md-select-option value="pending">Pending</md-select-option></md-select></md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

In Storybook: row selection, clickable rows, editable cells.

Loading & empty states

Prop	Effect
loading + loading-mode="overlay" (default)	Indeterminate progress line under the header plus a scrim that dims and disables the body; header and footer stay put
loading + loading-mode="skeleton"	The body is replaced by loading-rows shimmering skeleton rows (default 4); header and footer untouched
empty	Renders the empty slot instead of rows

<md-table loading loading-mode="skeleton" loading-rows="6"></md-table>

<md-table empty>
  <div slot="empty">No invoices yet.</div>
</md-table>

keep-height (default on) is a height ratchet: once rendered, the table never shrinks below that initial height, so paging, filtering to zero rows or an async refetch can’t make the page jump or flash a scrollbar. Set keep-height="false" for tables that are meant to resize — a density-toggle demo, for instance.

Skeleton loading, and a custom empty state Open in Storybook

Client Amount Status Client Amount Status

No invoices match this filter.

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, skeleton mode" loading loading-mode="skeleton" loading-rows="3">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="No results" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="padding: 24px; text-align: center; color: var(--md-sys-color-on-surface-variant);">No invoices match this filter.</div>
    </md-table>
  </md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gap: '20px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Loading, skeleton mode" loading loadingMode="skeleton" loadingRows="3">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody></MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="No results" empty>
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody></MdTableBody>
            <div slot="empty" style={{ padding: '24px', textAlign: 'center', color: 'var(--md-sys-color-on-surface-variant)' }}>No invoices match this filter.</div>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, skeleton mode" loading loading-mode="skeleton" loading-rows="3">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="No results" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="padding: 24px; text-align: center; color: var(--md-sys-color-on-surface-variant);">No invoices match this filter.</div>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: grid; gap: 20px;">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Loading, skeleton mode" loading loading-mode="skeleton" loading-rows="3">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body></md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="No results" empty>
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body></md-table-body>
        <div slot="empty" style="padding: 24px; text-align: center; color: var(--md-sys-color-on-surface-variant);">No invoices match this filter.</div>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, skeleton mode" loading loading-mode="skeleton" loading-rows="3">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="No results" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="padding: 24px; text-align: center; color: var(--md-sys-color-on-surface-variant);">No invoices match this filter.</div>
    </md-table>
  </md-table-container>
</div>

loading-mode="overlay" is the other half of the pair. Use it once rows are on screen — the existing data stays readable under an indeterminate line instead of being replaced by a skeleton, so a refresh or a page change doesn’t blank the table:

Overlay loading — rows stay visible underneath

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode" loading loading-mode="overlay">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode over striped rows" loading loading-mode="overlay" striped>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gap: '20px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Loading, overlay mode" loading loadingMode="overlay">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Loading, overlay mode over striped rows" loading loadingMode="overlay" striped>
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode" loading loading-mode="overlay">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode over striped rows" loading loading-mode="overlay" striped>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: grid; gap: 20px;">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode" loading loading-mode="overlay">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode over striped rows" loading loading-mode="overlay" striped>
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode" loading loading-mode="overlay">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Loading, overlay mode over striped rows" loading loading-mode="overlay" striped>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

With no empty slot the table falls back to its own “No data” message. Slot your own when you can say something more useful — why it is empty, and what to do next:

Empty states — the built-in message, a no-results state, and a first-run state Open in Storybook

Name Role Salary Name Role Salary

search_off

No employees match your filters

Adjust your filters, or reset them.

Reset filters

Name Role Salary

group_add

No employees yet

Add your first team member to get started.

Add employee

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html <head> — the icon font the components draw from -->
<link rel="stylesheet"
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap">

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="Default empty message" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="No results for the filter" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
        <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">search_off</span>
        <div style="display: grid; gap: 4px;">
          <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees match your filters</div>
          <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Adjust your filters, or reset them.</div>
        </div>
        <md-button variant="filled">Reset filters</md-button>
      </div>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="First-run empty" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
        <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">group_add</span>
        <div style="display: grid; gap: 4px;">
          <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees yet</div>
          <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Add your first team member to get started.</div>
        </div>
        <md-button variant="filled">Add employee</md-button>
      </div>
    </md-table>
  </md-table-container>
</div>

Copy

// Icons need the Material Symbols stylesheet in index.html — see Installation.
import { MdButton, MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gap: '20px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="1.5fr 1fr 1fr" label="Default empty message" empty>
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Name</MdTableCell>
                <MdTableCell head scope="col">Role</MdTableCell>
                <MdTableCell head scope="col" numeric>Salary</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody></MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="1.5fr 1fr 1fr" label="No results for the filter" empty>
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Name</MdTableCell>
                <MdTableCell head scope="col">Role</MdTableCell>
                <MdTableCell head scope="col" numeric>Salary</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody></MdTableBody>
            <div slot="empty" style={{ display: 'grid', justifyItems: 'center', gap: '12px', padding: '40px 24px', textAlign: 'center' }}>
              <span className="material-symbols-outlined" style={{ fontSize: '40px', color: 'var(--md-sys-color-on-surface-variant)' }}>search_off</span>
              <div style={{ display: 'grid', gap: '4px' }}>
                <div style={{ font: 'var(--md-sys-typescale-title-medium)', color: 'var(--md-sys-color-on-surface)' }}>No employees match your filters</div>
                <div style={{ font: 'var(--md-sys-typescale-body-medium)', color: 'var(--md-sys-color-on-surface-variant)' }}>Adjust your filters, or reset them.</div>
              </div>
              <MdButton variant="filled">Reset filters</MdButton>
            </div>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="1.5fr 1fr 1fr" label="First-run empty" empty>
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Name</MdTableCell>
                <MdTableCell head scope="col">Role</MdTableCell>
                <MdTableCell head scope="col" numeric>Salary</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody></MdTableBody>
            <div slot="empty" style={{ display: 'grid', justifyItems: 'center', gap: '12px', padding: '40px 24px', textAlign: 'center' }}>
              <span className="material-symbols-outlined" style={{ fontSize: '40px', color: 'var(--md-sys-color-on-surface-variant)' }}>group_add</span>
              <div style={{ display: 'grid', gap: '4px' }}>
                <div style={{ font: 'var(--md-sys-typescale-title-medium)', color: 'var(--md-sys-color-on-surface)' }}>No employees yet</div>
                <div style={{ font: 'var(--md-sys-typescale-body-medium)', color: 'var(--md-sys-color-on-surface-variant)' }}>Add your first team member to get started.</div>
              </div>
              <MdButton variant="filled">Add employee</MdButton>
            </div>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// Icons need the Material Symbols stylesheet in index.html — see Installation.
// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="Default empty message" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="No results for the filter" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
        <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">search_off</span>
        <div style="display: grid; gap: 4px;">
          <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees match your filters</div>
          <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Adjust your filters, or reset them.</div>
        </div>
        <md-button variant="filled">Reset filters</md-button>
      </div>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="First-run empty" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
        <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">group_add</span>
        <div style="display: grid; gap: 4px;">
          <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees yet</div>
          <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Add your first team member to get started.</div>
        </div>
        <md-button variant="filled">Add employee</md-button>
      </div>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
// Icons need the Material Symbols stylesheet in index.html — see Installation.
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: grid; gap: 20px;">
    <md-table-container variant="outlined">
      <md-table column-template="1.5fr 1fr 1fr" label="Default empty message" empty>
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col">Role</md-table-cell>
            <md-table-cell head scope="col" numeric>Salary</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body></md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="1.5fr 1fr 1fr" label="No results for the filter" empty>
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col">Role</md-table-cell>
            <md-table-cell head scope="col" numeric>Salary</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body></md-table-body>
        <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
          <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">search_off</span>
          <div style="display: grid; gap: 4px;">
            <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees match your filters</div>
            <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Adjust your filters, or reset them.</div>
          </div>
          <md-button variant="filled">Reset filters</md-button>
        </div>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="1.5fr 1fr 1fr" label="First-run empty" empty>
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Name</md-table-cell>
            <md-table-cell head scope="col">Role</md-table-cell>
            <md-table-cell head scope="col" numeric>Salary</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body></md-table-body>
        <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
          <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">group_add</span>
          <div style="display: grid; gap: 4px;">
            <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees yet</div>
            <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Add your first team member to get started.</div>
          </div>
          <md-button variant="filled">Add employee</md-button>
        </div>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  // Icons need the Material Symbols stylesheet in index.html — see Installation.

  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="Default empty message" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="No results for the filter" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
        <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">search_off</span>
        <div style="display: grid; gap: 4px;">
          <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees match your filters</div>
          <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Adjust your filters, or reset them.</div>
        </div>
        <md-button variant="filled">Reset filters</md-button>
      </div>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="1.5fr 1fr 1fr" label="First-run empty" empty>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Name</md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric>Salary</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body></md-table-body>
      <div slot="empty" style="display: grid; justify-items: center; gap: 12px; padding: 40px 24px; text-align: center;">
        <span class="material-symbols-outlined" style="font-size: 40px; color: var(--md-sys-color-on-surface-variant);">group_add</span>
        <div style="display: grid; gap: 4px;">
          <div style="font: var(--md-sys-typescale-title-medium); color: var(--md-sys-color-on-surface);">No employees yet</div>
          <div style="font: var(--md-sys-typescale-body-medium); color: var(--md-sys-color-on-surface-variant);">Add your first team member to get started.</div>
        </div>
        <md-button variant="filled">Add employee</md-button>
      </div>
    </md-table>
  </md-table-container>
</div>

The empty state is its own flag — empty swaps the body for the empty slot without touching the header, so column widths stay put while a filter is cleared:

Each state has its own story: loading and empty.

Slot your own into loader when the default linear bar isn’t the right affordance — a circular md-progress-indicator, a branded mark, a skeleton.

The loader slot replaces the scrim too

In overlay mode the slot’s fallback content is both the linear progress bar and the scrim that dims the body and swallows pointer events. Slotting your own loader replaces the whole fallback, so the dimming and the interaction block go with it — the body underneath stays fully lit and clickable. If you need that back, put it in your slotted content: an element that covers the body (position: absolute; inset: 0; background: color-mix(in srgb, var(--md-sys-color-surface) 55%, transparent); pointer-events: auto;) alongside your indicator. The demo below deliberately shows the un-scrimmed result.

A circular indicator replacing the default linear bar — and, with it, the scrim

Client Amount Acme 1,200

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr" label="Slotted loader" loading loading-mode="overlay">
    <md-progress-indicator slot="loader" variant="circular" indeterminate size="32" label="Loading invoices"></md-progress-indicator>
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row>
        <md-table-cell>Acme</md-table-cell>
        <md-table-cell numeric>1,200</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdProgressIndicator, MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="2fr 1fr" label="Slotted loader" loading loadingMode="overlay">
          <MdProgressIndicator slot="loader" variant="circular" indeterminate size="32" label="Loading invoices"></MdProgressIndicator>
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow>
              <MdTableCell>Acme</MdTableCell>
              <MdTableCell numeric>1,200</MdTableCell>
            </MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr" label="Slotted loader" loading loading-mode="overlay">
    <md-progress-indicator slot="loader" variant="circular" indeterminate size="32" label="Loading invoices"></md-progress-indicator>
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row>
        <md-table-cell>Acme</md-table-cell>
        <md-table-cell numeric>1,200</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr" label="Slotted loader" loading loading-mode="overlay">
      <md-progress-indicator slot="loader" variant="circular" indeterminate size="32" label="Loading invoices"></md-progress-indicator>
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row>
          <md-table-cell>Acme</md-table-cell>
          <md-table-cell numeric>1,200</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr" label="Slotted loader" loading loading-mode="overlay">
    <md-progress-indicator slot="loader" variant="circular" indeterminate size="32" label="Loading invoices"></md-progress-indicator>
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row>
        <md-table-cell>Acme</md-table-cell>
        <md-table-cell numeric>1,200</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Density

density here is dual-typed

This component accepts both vocabularies: the semantic words compact / standard (default) / comfortable — row heights 36 / 52 / 60px — or a numeric rung 0 | -1 | -2 | -3 | -4, the scale every other component in the library uses. Elsewhere in the library, only the numbers are valid.

The two are not exclusive: the semantic sizes are themselves scale-aware, so density="compact" inside a data-density="-2" region condenses further. A numeric value drives --md-sys-density-scale on the host exactly as a global data-density ancestor would, and takes the standard row-height base.

The three semantic sizes — comfortable, standard, compact Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Comfortable" density="comfortable">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Standard" density="standard">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Compact" density="compact">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gap: '20px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Comfortable" density="comfortable">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Standard" density="standard">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Compact" density="compact">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Comfortable" density="comfortable">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Standard" density="standard">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Compact" density="compact">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: grid; gap: 20px;">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Comfortable" density="comfortable">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Standard" density="standard">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Compact" density="compact">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Comfortable" density="comfortable">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Standard" density="standard">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Compact" density="compact">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

The numeric rungs are the other vocabulary — the same -4 … 0 scale every other component takes, and the same signal a global data-density ancestor sets. Row height, cell padding and type all step down together:

All five numeric rungs — 0 down to -4

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung 0" density="0">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -1" density="-1">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -2" density="-2">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -3" density="-3">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -4" density="-4">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gap: '20px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Rung 0" density="0">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Rung -1" density="-1">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Rung -2" density="-2">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Rung -3" density="-3">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" label="Rung -4" density="-4">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
                <MdTableCell head scope="col">Status</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
              <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung 0" density="0">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -1" density="-1">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -2" density="-2">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -3" density="-3">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -4" density="-4">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display: grid; gap: 20px;">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Rung 0" density="0">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Rung -1" density="-1">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Rung -2" density="-2">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Rung -3" density="-3">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="Rung -4" density="-4">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
            <md-table-cell head scope="col">Status</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
          <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display: grid; gap: 20px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung 0" density="0">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -1" density="-1">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -2" density="-2">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -3" density="-3">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Rung -4" density="-4">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

The named presets are compact and comfortable; expressive motion shows the change animating.

Totals, spans and grouped columns

md-table-foot holds aggregate rows, a cell can span tracks with colspan, and a two-tier header groups columns above their leaves.

A totals row in md-table-foot Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Total $4,320.00

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Invoices with totals">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="inv-2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$4,320.00</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableFoot, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="2fr 1fr 1fr" label="Invoices with totals">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="inv-1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
            <MdTableRow value="inv-2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
          </MdTableBody>
          <MdTableFoot>
            <MdTableRow rowgroup="foot" selectable="false">
              <MdTableCell head scope="row">Total</MdTableCell>
              <MdTableCell numeric>$4,320.00</MdTableCell>
              <MdTableCell></MdTableCell>
            </MdTableRow>
          </MdTableFoot>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Invoices with totals">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="inv-2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$4,320.00</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Invoices with totals">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="inv-1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="inv-2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
      <md-table-foot>
        <md-table-row rowgroup="foot" selectable="false">
          <md-table-cell head scope="row">Total</md-table-cell>
          <md-table-cell numeric>$4,320.00</md-table-cell>
          <md-table-cell></md-table-cell>
        </md-table-row>
      </md-table-foot>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Invoices with totals">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="inv-2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$4,320.00</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>
</md-table-container>

A spanning header cell grouping two columns Open in Storybook

2025 Change Region H1 H2 % EMEA412498+21% AMER388402+4%

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr 1fr" label="Grouped columns">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"></md-table-cell>
        <md-table-cell head scope="col" colspan="2" style="text-align: center;">2025</md-table-cell>
        <md-table-cell head scope="col">Change</md-table-cell>
      </md-table-row>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Region</md-table-cell>
        <md-table-cell head scope="col" numeric>H1</md-table-cell>
        <md-table-cell head scope="col" numeric>H2</md-table-cell>
        <md-table-cell head scope="col" numeric>%</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="emea"><md-table-cell head scope="row">EMEA</md-table-cell><md-table-cell numeric>412</md-table-cell><md-table-cell numeric>498</md-table-cell><md-table-cell numeric>+21%</md-table-cell></md-table-row>
      <md-table-row value="amer"><md-table-cell head scope="row">AMER</md-table-cell><md-table-cell numeric>388</md-table-cell><md-table-cell numeric>402</md-table-cell><md-table-cell numeric>+4%</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="2fr 1fr 1fr 1fr" label="Grouped columns">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col"></MdTableCell>
              <MdTableCell head scope="col" colSpan="2" style={{ textAlign: 'center' }}>2025</MdTableCell>
              <MdTableCell head scope="col">Change</MdTableCell>
            </MdTableRow>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Region</MdTableCell>
              <MdTableCell head scope="col" numeric>H1</MdTableCell>
              <MdTableCell head scope="col" numeric>H2</MdTableCell>
              <MdTableCell head scope="col" numeric>%</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="emea"><MdTableCell head scope="row">EMEA</MdTableCell><MdTableCell numeric>412</MdTableCell><MdTableCell numeric>498</MdTableCell><MdTableCell numeric>+21%</MdTableCell></MdTableRow>
            <MdTableRow value="amer"><MdTableCell head scope="row">AMER</MdTableCell><MdTableCell numeric>388</MdTableCell><MdTableCell numeric>402</MdTableCell><MdTableCell numeric>+4%</MdTableCell></MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr 1fr" label="Grouped columns">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"></md-table-cell>
        <md-table-cell head scope="col" colspan="2" style="text-align: center;">2025</md-table-cell>
        <md-table-cell head scope="col">Change</md-table-cell>
      </md-table-row>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Region</md-table-cell>
        <md-table-cell head scope="col" numeric>H1</md-table-cell>
        <md-table-cell head scope="col" numeric>H2</md-table-cell>
        <md-table-cell head scope="col" numeric>%</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="emea"><md-table-cell head scope="row">EMEA</md-table-cell><md-table-cell numeric>412</md-table-cell><md-table-cell numeric>498</md-table-cell><md-table-cell numeric>+21%</md-table-cell></md-table-row>
      <md-table-row value="amer"><md-table-cell head scope="row">AMER</md-table-cell><md-table-cell numeric>388</md-table-cell><md-table-cell numeric>402</md-table-cell><md-table-cell numeric>+4%</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr 1fr" label="Grouped columns">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col"></md-table-cell>
          <md-table-cell head scope="col" colspan="2" style="text-align: center;">2025</md-table-cell>
          <md-table-cell head scope="col">Change</md-table-cell>
        </md-table-row>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Region</md-table-cell>
          <md-table-cell head scope="col" numeric>H1</md-table-cell>
          <md-table-cell head scope="col" numeric>H2</md-table-cell>
          <md-table-cell head scope="col" numeric>%</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="emea"><md-table-cell head scope="row">EMEA</md-table-cell><md-table-cell numeric>412</md-table-cell><md-table-cell numeric>498</md-table-cell><md-table-cell numeric>+21%</md-table-cell></md-table-row>
        <md-table-row value="amer"><md-table-cell head scope="row">AMER</md-table-cell><md-table-cell numeric>388</md-table-cell><md-table-cell numeric>402</md-table-cell><md-table-cell numeric>+4%</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr 1fr" label="Grouped columns">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"></md-table-cell>
        <md-table-cell head scope="col" colspan="2" style="text-align: center;">2025</md-table-cell>
        <md-table-cell head scope="col">Change</md-table-cell>
      </md-table-row>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Region</md-table-cell>
        <md-table-cell head scope="col" numeric>H1</md-table-cell>
        <md-table-cell head scope="col" numeric>H2</md-table-cell>
        <md-table-cell head scope="col" numeric>%</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="emea"><md-table-cell head scope="row">EMEA</md-table-cell><md-table-cell numeric>412</md-table-cell><md-table-cell numeric>498</md-table-cell><md-table-cell numeric>+21%</md-table-cell></md-table-row>
      <md-table-row value="amer"><md-table-cell head scope="row">AMER</md-table-cell><md-table-cell numeric>388</md-table-cell><md-table-cell numeric>402</md-table-cell><md-table-cell numeric>+4%</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

A body cell spanning all three columns Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Remaining 39 invoices are archived.

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Spanning body cells">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="note" selectable="false">
        <md-table-cell colspan="3" style="color: var(--md-sys-color-on-surface-variant); font-style: italic;">Remaining 39 invoices are archived.</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable columnTemplate="2fr 1fr 1fr" label="Spanning body cells">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
            <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            <MdTableRow value="note" selectable="false">
              <MdTableCell colSpan="3" style={{ color: 'var(--md-sys-color-on-surface-variant)', fontStyle: 'italic' }}>Remaining 39 invoices are archived.</MdTableCell>
            </MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Spanning body cells">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="note" selectable="false">
        <md-table-cell colspan="3" style="color: var(--md-sys-color-on-surface-variant); font-style: italic;">Remaining 39 invoices are archived.</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" label="Spanning body cells">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        <md-table-row value="note" selectable="false">
          <md-table-cell colspan="3" style="color: var(--md-sys-color-on-surface-variant); font-style: italic;">Remaining 39 invoices are archived.</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Spanning body cells">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="note" selectable="false">
        <md-table-cell colspan="3" style="color: var(--md-sys-color-on-surface-variant); font-style: italic;">Remaining 39 invoices are archived.</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

The spanning story covers colspan in body cells, and expandable rows puts detail content in a row’s expanded slot.

Pagination

md-table-pagination is a controlled bar: it reports intent through mdPageChange / mdRowsPerPageChange and never slices your data. Feed it count, page and rows-per-page and do the paging yourself — which is what makes server-side pagination the same wiring as the client-side story.

Client pagination — page through the rows, or change the page size Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Initech$860.00Paid Umbrella$2,450.00Draft Soylent$1,975.00Paid Hooli$4,300.00Pending Stark Industries$8,120.00Paid Wayne Enterprises$6,640.00Draft Cyberdyne$2,010.00Paid Tyrell Corp$3,780.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="318px">
  <md-table id="pag-table" frozen-header row-count="10" column-template="2fr 1fr 1fr" label="Paged invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body id="pag-body">
      <md-table-row value="p1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="p2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="p3"><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="p4"><md-table-cell head scope="row">Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
      <md-table-row value="p5"><md-table-cell head scope="row">Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="p6"><md-table-cell head scope="row">Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="p7"><md-table-cell head scope="row">Stark Industries</md-table-cell><md-table-cell numeric>$8,120.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="p8"><md-table-cell head scope="row">Wayne Enterprises</md-table-cell><md-table-cell numeric>$6,640.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
      <md-table-row value="p9"><md-table-cell head scope="row">Cyberdyne</md-table-cell><md-table-cell numeric>$2,010.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="p10"><md-table-cell head scope="row">Tyrell Corp</md-table-cell><md-table-cell numeric>$3,780.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
  <md-table-pagination id="pag" slot="bottom" count="10" page="0" rows-per-page="5"></md-table-pagination>
</md-table-container>

<script type="module">
  var table = document.getElementById('pag-table');
  var pag = document.getElementById('pag');
  var page = 0;
  var perPage = 5;
  // Page by toggling row visibility rather than rebuilding rows — selection and
  // expanded state then survive a page change for free.
  var renderPage = function () {
    var rows = Array.prototype.slice.call(document.querySelectorAll('#pag-body md-table-row'));
    var start = page * perPage;
    rows.forEach(function (r, i) { r.style.display = i >= start && i < start + perPage ? '' : 'none'; });
    // NOTE: no row-offset here. It offsets aria-rowindex for rows that are NOT
    // in the DOM; this demo keeps all ten rows in the DOM and only hides them,
    // so the table already counts them and stamps the true absolute index.
    // Adding row-offset would double-count (page 2 would announce rows 12-16
    // against an aria-rowcount of 11). Use row-offset only when you render just
    // the current page — see the server-pagination example below.
  };
  pag.addEventListener('mdPageChange', function (e) { page = e.detail.page; renderPage(); });
  pag.addEventListener('mdRowsPerPageChange', function (e) { perPage = e.detail.rowsPerPage; page = 0; renderPage(); });
  renderPage();
</script>

Copy

import { useMemo, useState } from 'react';
import {
MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead,
MdTablePagination, MdTableRow,
} from '@awc-ui/react';

const INVOICES = [
{ id: 'p1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'p2', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'p3', client: 'Initech', amount: 860, status: 'Paid' },
{ id: 'p4', client: 'Umbrella', amount: 2450, status: 'Draft' },
{ id: 'p5', client: 'Soylent', amount: 1975, status: 'Paid' },
{ id: 'p6', client: 'Hooli', amount: 4300, status: 'Pending' },
{ id: 'p7', client: 'Stark Industries', amount: 8120, status: 'Paid' },
{ id: 'p8', client: 'Wayne Enterprises', amount: 6640, status: 'Draft' },
{ id: 'p9', client: 'Cyberdyne', amount: 2010, status: 'Paid' },
{ id: 'p10', client: 'Tyrell Corp', amount: 3780, status: 'Pending' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

export function PagedInvoices() {
const [page, setPage] = useState(0);
const [perPage, setPerPage] = useState(5);

const pageRows = useMemo(
  () => INVOICES.slice(page * perPage, page * perPage + perPage),
  [page, perPage],
);

return (
  <MdTableContainer variant="outlined" maxHeight="318px">
    {/* rowCount + rowOffset let the table stamp aria-rowindex against the
        full set, so AT announces "row 7 of 10" rather than "row 2 of 5". */}
    <MdTable
      frozenHeader
      rowCount={INVOICES.length}
      rowOffset={page * perPage}
      columnTemplate="2fr 1fr 1fr"
      label="Paged invoices"
    >
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head scope="col">Client</MdTableCell>
          <MdTableCell head scope="col" numeric>Amount</MdTableCell>
          <MdTableCell head scope="col">Status</MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {pageRows.map((row) => (
          <MdTableRow key={row.id} value={row.id}>
            <MdTableCell head scope="row">{row.client}</MdTableCell>
            <MdTableCell numeric>{money(row.amount)}</MdTableCell>
            <MdTableCell>{row.status}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
    </MdTable>

    <MdTablePagination
      slot="bottom"
      count={INVOICES.length}
      page={page}
      rowsPerPage={perPage}
      onMdPageChange={(e) => setPage(e.detail.page)}
      onMdRowsPerPageChange={(e) => { setPerPage(e.detail.rowsPerPage); setPage(0); }}
    />
  </MdTableContainer>
);
}

Copy

// paged-invoices.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Invoice { id: string; client: string; amount: number; status: string; }

@Component({
selector: 'app-paged-invoices',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined" max-height="318px">
    <md-table
      frozen-header
      [attr.row-count]="invoices.length"
      [attr.row-offset]="page * perPage"
      column-template="2fr 1fr 1fr"
      label="Paged invoices"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of pageRows; trackBy: trackById" [attr.value]="row.id">
          <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
          <md-table-cell numeric>{{ row.amount | currency }}</md-table-cell>
          <md-table-cell>{{ row.status }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>

    <md-table-pagination
      slot="bottom"
      [attr.count]="invoices.length"
      [attr.page]="page"
      [attr.rows-per-page]="perPage"
      (mdPageChange)="page = $any($event).detail.page"
      (mdRowsPerPageChange)="onRowsPerPage($event)"
    ></md-table-pagination>
  </md-table-container>
`,
})
export class PagedInvoicesComponent {
invoices: Invoice[] = [
  { id: 'p1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'p2', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'p3', client: 'Initech', amount: 860, status: 'Paid' },
  { id: 'p4', client: 'Umbrella', amount: 2450, status: 'Draft' },
  { id: 'p5', client: 'Soylent', amount: 1975, status: 'Paid' },
  { id: 'p6', client: 'Hooli', amount: 4300, status: 'Pending' },
  { id: 'p7', client: 'Stark Industries', amount: 8120, status: 'Paid' },
  { id: 'p8', client: 'Wayne Enterprises', amount: 6640, status: 'Draft' },
  { id: 'p9', client: 'Cyberdyne', amount: 2010, status: 'Paid' },
  { id: 'p10', client: 'Tyrell Corp', amount: 3780, status: 'Pending' },
];
page = 0;
perPage = 5;

get pageRows(): Invoice[] {
  return this.invoices.slice(this.page * this.perPage, (this.page + 1) * this.perPage);
}

onRowsPerPage(event: Event) {
  this.perPage = (event as CustomEvent<{ rowsPerPage: number }>).detail.rowsPerPage;
  this.page = 0;
}

trackById = (_: number, row: Invoice) => row.id;
}

Copy

<script setup>
import { computed, ref } from 'vue';
import '@awc-ui/core/define';

const INVOICES = [
{ id: 'p1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
{ id: 'p2', client: 'Globex', amount: 3120, status: 'Pending' },
{ id: 'p3', client: 'Initech', amount: 860, status: 'Paid' },
{ id: 'p4', client: 'Umbrella', amount: 2450, status: 'Draft' },
{ id: 'p5', client: 'Soylent', amount: 1975, status: 'Paid' },
{ id: 'p6', client: 'Hooli', amount: 4300, status: 'Pending' },
{ id: 'p7', client: 'Stark Industries', amount: 8120, status: 'Paid' },
{ id: 'p8', client: 'Wayne Enterprises', amount: 6640, status: 'Draft' },
{ id: 'p9', client: 'Cyberdyne', amount: 2010, status: 'Paid' },
{ id: 'p10', client: 'Tyrell Corp', amount: 3780, status: 'Pending' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

const page = ref(0);
const perPage = ref(5);
const pageRows = computed(() =>
INVOICES.slice(page.value * perPage.value, (page.value + 1) * perPage.value),
);
</script>

<template>
<md-table-container variant="outlined" max-height="318px">
  <md-table
    frozen-header
    :row-count="INVOICES.length"
    :row-offset="page * perPage"
    column-template="2fr 1fr 1fr"
    label="Paged invoices"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in pageRows" :key="row.id" :value="row.id">
        <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.amount) }}</md-table-cell>
        <md-table-cell>{{ row.status }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>

  <md-table-pagination
    slot="bottom"
    :count="INVOICES.length"
    :page="page"
    :rows-per-page="perPage"
    @mdPageChange="page = $event.detail.page"
    @mdRowsPerPageChange="perPage = $event.detail.rowsPerPage; page = 0"
  ></md-table-pagination>
</md-table-container>
</template>

Copy

<script>
import '@awc-ui/core/define';

const INVOICES = [
  { id: 'p1', client: 'Acme Corp', amount: 1200, status: 'Paid' },
  { id: 'p2', client: 'Globex', amount: 3120, status: 'Pending' },
  { id: 'p3', client: 'Initech', amount: 860, status: 'Paid' },
  { id: 'p4', client: 'Umbrella', amount: 2450, status: 'Draft' },
  { id: 'p5', client: 'Soylent', amount: 1975, status: 'Paid' },
  { id: 'p6', client: 'Hooli', amount: 4300, status: 'Pending' },
  { id: 'p7', client: 'Stark Industries', amount: 8120, status: 'Paid' },
  { id: 'p8', client: 'Wayne Enterprises', amount: 6640, status: 'Draft' },
  { id: 'p9', client: 'Cyberdyne', amount: 2010, status: 'Paid' },
  { id: 'p10', client: 'Tyrell Corp', amount: 3780, status: 'Pending' },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

let page = 0;
let perPage = 5;
$: pageRows = INVOICES.slice(page * perPage, (page + 1) * perPage);
</script>

<md-table-container variant="outlined" max-height="318px">
<md-table
  frozen-header
  row-count={INVOICES.length}
  row-offset={page * perPage}
  column-template="2fr 1fr 1fr"
  label="Paged invoices"
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">Client</md-table-cell>
      <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      <md-table-cell head scope="col">Status</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each pageRows as row (row.id)}
      <md-table-row value={row.id}>
        <md-table-cell head scope="row">{row.client}</md-table-cell>
        <md-table-cell numeric>{money(row.amount)}</md-table-cell>
        <md-table-cell>{row.status}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>

<md-table-pagination
  slot="bottom"
  count={INVOICES.length}
  {page}
  rows-per-page={perPage}
  on:mdPageChange={(e) => (page = e.detail.page)}
  on:mdRowsPerPageChange={(e) => { perPage = e.detail.rowsPerPage; page = 0; }}
></md-table-pagination>
</md-table-container>

Server-side paging is the same wiring with the data fetch in the middle. The first load has nothing to keep on screen, so it shows the skeleton; every page change after that keeps the current rows up under the overlay line while the next page is fetched:

Server-side pagination and sorting — skeleton first, overlay after Open in Storybook

Name Role Salary

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="318px">
  <md-table id="srv-table" frozen-header row-count="47" column-template="2fr 1fr 1fr" label="Server-paged employees" loading loading-mode="skeleton" loading-rows="5">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col">Role</md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body id="srv-body"></md-table-body>
  </md-table>
  <md-table-pagination id="srv-pag" slot="bottom" count="47" page="0" rows-per-page="5"></md-table-pagination>
</md-table-container>

<script type="module">
  var table = document.getElementById('srv-table');
  var body = document.getElementById('srv-body');
  var pag = document.getElementById('srv-pag');
  // The whole dataset "lives on the server" — the client only ever holds a page.
  var DATA = [];
  for (var i = 0; i < 47; i++) {
    DATA.push({
      name: 'Employee ' + String(i + 1).padStart(2, '0'),
      role: ['Engineer', 'Designer', 'Product Manager', 'Analyst'][i % 4],
      salary: 90000 + ((i * 37) % 40) * 2500,
    });
  }
  var page = 0, perPage = 5, sortBy = '', sortOrder = 'none', timer = 0;
  var money = function (n) { return '$' + n.toLocaleString('en-US'); };

  var fetchPage = function () {
    // Nothing on screen yet -> skeleton. Rows already up -> overlay, so a page
    // change never blanks the table.
    table.loadingMode = body.querySelector('md-table-row') ? 'overlay' : 'skeleton';
    table.loading = true;
    clearTimeout(timer);
    timer = setTimeout(function () {
      var rows = DATA.slice();
      if (sortBy && sortOrder !== 'none') {
        var dir = sortOrder === 'desc' ? -1 : 1;
        rows.sort(function (a, b) {
          var av = a[sortBy], bv = b[sortBy];
          return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
        });
      }
      var start = page * perPage;
      body.innerHTML = rows.slice(start, start + perPage).map(function (r) {
        return '<md-table-row><md-table-cell head scope="row">' + r.name +
          '</md-table-cell><md-table-cell>' + r.role +
          '</md-table-cell><md-table-cell numeric>' + money(r.salary) + '</md-table-cell></md-table-row>';
      }).join('');
      table.setAttribute('row-offset', String(start));
      table.loading = false;
    }, 700);
  };

  pag.addEventListener('mdPageChange', function (e) { page = e.detail.page; fetchPage(); });
  pag.addEventListener('mdRowsPerPageChange', function (e) { perPage = e.detail.rowsPerPage; page = 0; pag.page = 0; fetchPage(); });
  // Sorting is server-side too, so it re-sorts the whole set and returns to page 1.
  table.addEventListener('mdSortChange', function (e) {
    sortBy = e.detail.column; sortOrder = e.detail.order;
    page = 0; pag.page = 0; fetchPage();
  });
  fetchPage();
</script>

Copy

import { useCallback, useEffect, useRef, useState } from 'react';
import {
MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead,
MdTablePagination, MdTableRow, MdTableSortLabel,
} from '@awc-ui/react';

const DATA = Array.from({ length: 47 }, (_, i) => ({
name: `Employee ${String(i + 1).padStart(2, '0')}`,
role: ['Engineer', 'Designer', 'Product Manager', 'Analyst'][i % 4],
salary: 90000 + ((i * 37) % 40) * 2500,
}));

// Stand-in for your API. Sorting and slicing happen "on the server".
const fetchPage = async ({ page, perPage, sortBy, sortOrder }) => {
const rows = [...DATA];
if (sortBy && sortOrder !== 'none') {
  const dir = sortOrder === 'desc' ? -1 : 1;
  rows.sort((a, b) => {
    const av = a[sortBy];
    const bv = b[sortBy];
    return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
  });
}
await new Promise((r) => setTimeout(r, 700)); // latency
return { rows: rows.slice(page * perPage, (page + 1) * perPage), total: DATA.length };
};

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

export function ServerPagedEmployees() {
const [rows, setRows] = useState([]);
const [total, setTotal] = useState(0);
const [page, setPage] = useState(0);
const [perPage, setPerPage] = useState(5);
const [sort, setSort] = useState({ column: '', order: 'none' });
const [loading, setLoading] = useState(true);
const hasRows = useRef(false);

const load = useCallback(async () => {
  setLoading(true);
  const res = await fetchPage({ page, perPage, sortBy: sort.column, sortOrder: sort.order });
  setRows(res.rows);
  setTotal(res.total);
  hasRows.current = true;
  setLoading(false);
}, [page, perPage, sort]);

useEffect(() => { load(); }, [load]);

return (
  <MdTableContainer variant="outlined" maxHeight="318px">
    <MdTable
      frozenHeader
      rowCount={total}
      rowOffset={page * perPage}
      columnTemplate="2fr 1fr 1fr"
      label="Server-paged employees"
      loading={loading}
      // First load has nothing to keep on screen -> skeleton. Afterwards the
      // overlay keeps the current page readable while the next one loads.
      loadingMode={hasRows.current ? 'overlay' : 'skeleton'}
      loadingRows={perPage}
      onMdSortChange={(e) => { setSort(e.detail); setPage(0); }}
    >
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head scope="col"><MdTableSortLabel column="name">Name</MdTableSortLabel></MdTableCell>
          <MdTableCell head scope="col">Role</MdTableCell>
          <MdTableCell head scope="col" numeric><MdTableSortLabel column="salary">Salary</MdTableSortLabel></MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {rows.map((row) => (
          <MdTableRow key={row.name}>
            <MdTableCell head scope="row">{row.name}</MdTableCell>
            <MdTableCell>{row.role}</MdTableCell>
            <MdTableCell numeric>{money(row.salary)}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
    </MdTable>

    <MdTablePagination
      slot="bottom"
      count={total}
      page={page}
      rowsPerPage={perPage}
      onMdPageChange={(e) => setPage(e.detail.page)}
      onMdRowsPerPageChange={(e) => { setPerPage(e.detail.rowsPerPage); setPage(0); }}
    />
  </MdTableContainer>
);
}

Copy

// server-paged-employees.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA, OnInit } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Employee { name: string; role: string; salary: number; }

@Component({
selector: 'app-server-paged-employees',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined" max-height="318px">
    <md-table
      frozen-header
      [attr.row-count]="total"
      [attr.row-offset]="page * perPage"
      column-template="2fr 1fr 1fr"
      label="Server-paged employees"
      [attr.loading]="loading ? '' : null"
      [attr.loading-mode]="hasRows ? 'overlay' : 'skeleton'"
      [attr.loading-rows]="perPage"
      (mdSortChange)="onSort($event)"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col">Role</md-table-cell>
          <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of rows; trackBy: trackByName">
          <md-table-cell head scope="row">{{ row.name }}</md-table-cell>
          <md-table-cell>{{ row.role }}</md-table-cell>
          <md-table-cell numeric>{{ row.salary | currency }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>

    <md-table-pagination
      slot="bottom"
      [attr.count]="total"
      [attr.page]="page"
      [attr.rows-per-page]="perPage"
      (mdPageChange)="page = $any($event).detail.page; load()"
      (mdRowsPerPageChange)="perPage = $any($event).detail.rowsPerPage; page = 0; load()"
    ></md-table-pagination>
  </md-table-container>
`,
})
export class ServerPagedEmployeesComponent implements OnInit {
rows: Employee[] = [];
total = 0;
page = 0;
perPage = 5;
sortBy = '';
sortOrder = 'none';
loading = true;
hasRows = false;

ngOnInit() { this.load(); }

async load() {
  this.loading = true;
  // Replace with your HTTP call — the table only cares about loading + rows.
  const { rows, total } = await fetchPage({
    page: this.page, perPage: this.perPage, sortBy: this.sortBy, sortOrder: this.sortOrder,
  });
  this.rows = rows;
  this.total = total;
  this.hasRows = true;
  this.loading = false;
}

onSort(event: Event) {
  const { column, order } = (event as CustomEvent<{ column: string; order: string }>).detail;
  this.sortBy = column;
  this.sortOrder = order;
  this.page = 0;
  this.load();
}

trackByName = (_: number, row: Employee) => row.name;
}

Copy

<script setup>
import { onMounted, ref, watch } from 'vue';
import '@awc-ui/core/define';

const DATA = Array.from({ length: 47 }, (_, i) => ({
name: `Employee ${String(i + 1).padStart(2, '0')}`,
role: ['Engineer', 'Designer', 'Product Manager', 'Analyst'][i % 4],
salary: 90000 + ((i * 37) % 40) * 2500,
}));

// Stand-in for your API. Sorting and slicing happen "on the server".
const fetchPage = async ({ page, perPage, sortBy, sortOrder }) => {
const rows = [...DATA];
if (sortBy && sortOrder !== 'none') {
  const dir = sortOrder === 'desc' ? -1 : 1;
  rows.sort((a, b) => {
    const av = a[sortBy];
    const bv = b[sortBy];
    return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
  });
}
await new Promise((r) => setTimeout(r, 700)); // latency
return { rows: rows.slice(page * perPage, (page + 1) * perPage), total: DATA.length };
};

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

const rows = ref([]);
const total = ref(0);
const page = ref(0);
const perPage = ref(5);
const sort = ref({ column: '', order: 'none' });
const loading = ref(true);
const hasRows = ref(false);

const load = async () => {
loading.value = true;
const res = await fetchPage({
  page: page.value, perPage: perPage.value, sortBy: sort.value.column, sortOrder: sort.value.order,
});
rows.value = res.rows;
total.value = res.total;
hasRows.value = true;
loading.value = false;
};

onMounted(load);
watch([page, perPage, sort], load);
</script>

<template>
<md-table-container variant="outlined" max-height="318px">
  <md-table
    frozen-header
    :row-count="total"
    :row-offset="page * perPage"
    column-template="2fr 1fr 1fr"
    label="Server-paged employees"
    :loading="loading"
    :loading-mode="hasRows ? 'overlay' : 'skeleton'"
    :loading-rows="perPage"
    @mdSortChange="sort = $event.detail; page = 0"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col">Role</md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in rows" :key="row.name">
        <md-table-cell head scope="row">{{ row.name }}</md-table-cell>
        <md-table-cell>{{ row.role }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.salary) }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>

  <md-table-pagination
    slot="bottom"
    :count="total"
    :page="page"
    :rows-per-page="perPage"
    @mdPageChange="page = $event.detail.page"
    @mdRowsPerPageChange="perPage = $event.detail.rowsPerPage; page = 0"
  ></md-table-pagination>
</md-table-container>
</template>

Copy

<script>
import { onMount } from 'svelte';
import '@awc-ui/core/define';

const DATA = Array.from({ length: 47 }, (_, i) => ({
  name: `Employee ${String(i + 1).padStart(2, '0')}`,
  role: ['Engineer', 'Designer', 'Product Manager', 'Analyst'][i % 4],
  salary: 90000 + ((i * 37) % 40) * 2500,
}));

// Stand-in for your API. Sorting and slicing happen "on the server".
const fetchPage = async ({ page, perPage, sortBy, sortOrder }) => {
  const rows = [...DATA];
  if (sortBy && sortOrder !== 'none') {
    const dir = sortOrder === 'desc' ? -1 : 1;
    rows.sort((a, b) => {
      const av = a[sortBy];
      const bv = b[sortBy];
      return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
    });
  }
  await new Promise((r) => setTimeout(r, 700)); // latency
  return { rows: rows.slice(page * perPage, (page + 1) * perPage), total: DATA.length };
};

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

let rows = [];
let total = 0;
let page = 0;
let perPage = 5;
let sort = { column: '', order: 'none' };
let loading = true;
let hasRows = false;

const load = async () => {
  loading = true;
  const res = await fetchPage({ page, perPage, sortBy: sort.column, sortOrder: sort.order });
  rows = res.rows;
  total = res.total;
  hasRows = true;
  loading = false;
};

onMount(load);
</script>

<md-table-container variant="outlined" max-height="318px">
<md-table
  frozen-header
  row-count={total}
  row-offset={page * perPage}
  column-template="2fr 1fr 1fr"
  label="Server-paged employees"
  {loading}
  loading-mode={hasRows ? 'overlay' : 'skeleton'}
  loading-rows={perPage}
  on:mdSortChange={(e) => { sort = e.detail; page = 0; load(); }}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col">Role</md-table-cell>
      <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each rows as row (row.name)}
      <md-table-row>
        <md-table-cell head scope="row">{row.name}</md-table-cell>
        <md-table-cell>{row.role}</md-table-cell>
        <md-table-cell numeric>{money(row.salary)}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>

<md-table-pagination
  slot="bottom"
  count={total}
  {page}
  rows-per-page={perPage}
  on:mdPageChange={(e) => { page = e.detail.page; load(); }}
  on:mdRowsPerPageChange={(e) => { perPage = e.detail.rowsPerPage; page = 0; load(); }}
></md-table-pagination>
</md-table-container>

rows-per-page must be one of rows-per-page-options (default 5,10,25,50) — set it to a value outside that list and the selector renders blank, because no option matches. Change the list rather than the value if you need a different page size.

A complete data grid

Every piece above, in one table: a toolbar that switches to selection mode, a quick filter, sortable columns, multiple selection with a select-all, a frozen header, a pinned first column and pagination — all of it driven by the same events documented in each section.

A complete data grid — filter, sort, select, page Open in Storybook

Name Role Team Salary Ada LovelaceMathematicianEngineering$120,000 Alan TuringCryptanalystSecurity$145,000 Grace HopperCompiler EngineerPlatform$132,000 Linus TorvaldsKernel EngineerInfrastructure$168,000 Margaret HamiltonSoftware LeadAvionics$175,000 Donald KnuthAuthor / ResearcherResearch$195,000 Barbara LiskovProgramming Language DesignerResearch$188,000 Katherine JohnsonOrbital AnalystAvionics$140,000 Tim Berners-LeeWeb ArchitectPlatform$210,000 Radia PerlmanNetwork EngineerInfrastructure$158,000 Anita BorgSystems ResearcherResearch$150,000 Guido van RossumLanguage DesignerPlatform$205,000

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html <head> — the icon font the components draw from -->
<link rel="stylesheet"
  href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap">

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="420px">
  <md-table-toolbar id="fdg-toolbar" slot="top" headline="Employees" supporting-text="12 people" auto-bind>
    <md-icon-button slot="actions" id="fdg-filter-btn" icon="filter_list" aria-label="Filter employees"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete selected"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive selected"></md-icon-button>
  </md-table-toolbar>
  <div id="fdg-filter" hidden style="padding: 8px 16px 12px;">
    <md-text-field id="fdg-query" variant="outlined" label="Filter" density="-2" style="inline-size: 260px;"><span slot="leading-icon" class="material-symbols-outlined">search</span></md-text-field>
  </div>
  <md-table id="fdg-table" frozen-header selection="multiple" row-count="12" column-template="auto 1.6fr 1.4fr 1fr 1fr" label="Employees">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"><md-checkbox id="fdg-all" aria-label="Select all rows"></md-checkbox></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="role">Role</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="team">Team</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body id="fdg-body">
      <md-table-row value="g1"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Ada Lovelace"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Ada Lovelace</md-table-cell><md-table-cell data-col="role">Mathematician</md-table-cell><md-table-cell data-col="team">Engineering</md-table-cell><md-table-cell numeric data-col="salary">$120,000</md-table-cell></md-table-row>
      <md-table-row value="g2"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Alan Turing"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Alan Turing</md-table-cell><md-table-cell data-col="role">Cryptanalyst</md-table-cell><md-table-cell data-col="team">Security</md-table-cell><md-table-cell numeric data-col="salary">$145,000</md-table-cell></md-table-row>
      <md-table-row value="g3"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Grace Hopper"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Grace Hopper</md-table-cell><md-table-cell data-col="role">Compiler Engineer</md-table-cell><md-table-cell data-col="team">Platform</md-table-cell><md-table-cell numeric data-col="salary">$132,000</md-table-cell></md-table-row>
      <md-table-row value="g4"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Linus Torvalds"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Linus Torvalds</md-table-cell><md-table-cell data-col="role">Kernel Engineer</md-table-cell><md-table-cell data-col="team">Infrastructure</md-table-cell><md-table-cell numeric data-col="salary">$168,000</md-table-cell></md-table-row>
      <md-table-row value="g5"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Margaret Hamilton"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Margaret Hamilton</md-table-cell><md-table-cell data-col="role">Software Lead</md-table-cell><md-table-cell data-col="team">Avionics</md-table-cell><md-table-cell numeric data-col="salary">$175,000</md-table-cell></md-table-row>
      <md-table-row value="g6"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Donald Knuth"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Donald Knuth</md-table-cell><md-table-cell data-col="role">Author / Researcher</md-table-cell><md-table-cell data-col="team">Research</md-table-cell><md-table-cell numeric data-col="salary">$195,000</md-table-cell></md-table-row>
      <md-table-row value="g7"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Barbara Liskov"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Barbara Liskov</md-table-cell><md-table-cell data-col="role">Programming Language Designer</md-table-cell><md-table-cell data-col="team">Research</md-table-cell><md-table-cell numeric data-col="salary">$188,000</md-table-cell></md-table-row>
      <md-table-row value="g8"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Katherine Johnson"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Katherine Johnson</md-table-cell><md-table-cell data-col="role">Orbital Analyst</md-table-cell><md-table-cell data-col="team">Avionics</md-table-cell><md-table-cell numeric data-col="salary">$140,000</md-table-cell></md-table-row>
      <md-table-row value="g9"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Tim Berners-Lee"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Tim Berners-Lee</md-table-cell><md-table-cell data-col="role">Web Architect</md-table-cell><md-table-cell data-col="team">Platform</md-table-cell><md-table-cell numeric data-col="salary">$210,000</md-table-cell></md-table-row>
      <md-table-row value="g10"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Radia Perlman"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Radia Perlman</md-table-cell><md-table-cell data-col="role">Network Engineer</md-table-cell><md-table-cell data-col="team">Infrastructure</md-table-cell><md-table-cell numeric data-col="salary">$158,000</md-table-cell></md-table-row>
      <md-table-row value="g11"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Anita Borg"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Anita Borg</md-table-cell><md-table-cell data-col="role">Systems Researcher</md-table-cell><md-table-cell data-col="team">Research</md-table-cell><md-table-cell numeric data-col="salary">$150,000</md-table-cell></md-table-row>
      <md-table-row value="g12"><md-table-cell padding="checkbox"><md-checkbox aria-label="Select Guido van Rossum"></md-checkbox></md-table-cell><md-table-cell head scope="row" data-col="name">Guido van Rossum</md-table-cell><md-table-cell data-col="role">Language Designer</md-table-cell><md-table-cell data-col="team">Platform</md-table-cell><md-table-cell numeric data-col="salary">$205,000</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
  <md-table-pagination id="fdg-pag" slot="bottom" count="12" page="0" rows-per-page="5"></md-table-pagination>
</md-table-container>

<script type="module">
  var table = document.getElementById('fdg-table');
  var body = document.getElementById('fdg-body');
  var pag = document.getElementById('fdg-pag');
  var query = '', page = 0, perPage = 5, sortBy = '', sortOrder = 'none';

  var cell = function (row, col) { return (row.querySelector('[data-col="' + col + '"]').textContent || '').trim(); };
  var num = function (v) { return parseFloat(v.replace(/[^0-9.-]/g, '')); };

  // One render pass owns filter + sort + page. Rows are reordered and hidden,
  // never rebuilt, so selection survives every one of those changes.
  var render = function () {
    var rows = Array.prototype.slice.call(body.querySelectorAll('md-table-row'));
    if (sortBy && sortOrder !== 'none') {
      var dir = sortOrder === 'desc' ? -1 : 1;
      rows.sort(function (a, b) {
        var av = cell(a, sortBy), bv = cell(b, sortBy);
        return (sortBy === 'salary' ? num(av) - num(bv) : av.localeCompare(bv)) * dir;
      });
      rows.forEach(function (r) { body.appendChild(r); });
    }
    var q = query.trim().toLowerCase();
    var matches = rows.filter(function (r) { return !q || r.textContent.toLowerCase().indexOf(q) > -1; });
    pag.count = matches.length;
    if (page * perPage >= matches.length) { page = 0; pag.page = 0; }
    rows.forEach(function (r) { r.style.display = 'none'; });
    matches.slice(page * perPage, page * perPage + perPage).forEach(function (r) { r.style.display = ''; });
    table.empty = matches.length === 0;
    // No row-offset: every row stays in the DOM (hidden, not removed), so the
    // table's own body index is already the absolute one. row-offset is for the
    // case where only the current page exists in the DOM.
  };

  // The select-all checkbox needs no listener — selection="multiple" makes the
  // table handle slotted checkboxes, head box included.
  table.addEventListener('mdSortChange', function (e) { sortBy = e.detail.column; sortOrder = e.detail.order; render(); });
  pag.addEventListener('mdPageChange', function (e) { page = e.detail.page; render(); });
  pag.addEventListener('mdRowsPerPageChange', function (e) { perPage = e.detail.rowsPerPage; page = 0; render(); });

  var panel = document.getElementById('fdg-filter');
  var field = document.getElementById('fdg-query');
  document.getElementById('fdg-filter-btn').addEventListener('click', function () {
    panel.hidden = !panel.hidden;
    if (!panel.hidden) field.setFocus();
  });
  // md-text-field emits mdInput with the value AS the detail (a string) — not
  // wrapped in an object.
  field.addEventListener('mdInput', function (e) { query = e.detail; page = 0; pag.page = 0; render(); });
  render();
</script>

Copy

import { useMemo, useRef, useState } from 'react';
import {
MdCheckbox, MdIconButton, MdTable, MdTableBody, MdTableCell, MdTableContainer,
MdTableHead, MdTablePagination, MdTableRow, MdTableSortLabel, MdTableToolbar, MdTextField,
} from '@awc-ui/react';

const PEOPLE = [
{ id: 'g1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
{ id: 'g2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
{ id: 'g3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
{ id: 'g4', name: 'Linus Torvalds', role: 'Kernel Engineer', team: 'Infrastructure', salary: 168000 },
{ id: 'g5', name: 'Margaret Hamilton', role: 'Software Lead', team: 'Avionics', salary: 175000 },
{ id: 'g6', name: 'Donald Knuth', role: 'Author / Researcher', team: 'Research', salary: 195000 },
// … six more …
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

export function EmployeeGrid() {
const tableRef = useRef(null);
const [query, setQuery] = useState('');
const [showFilter, setShowFilter] = useState(false);
const [sort, setSort] = useState({ column: '', order: 'none' });
const [page, setPage] = useState(0);
const [perPage, setPerPage] = useState(5);

// Filter -> sort -> page, derived in that order from one source of truth.
const filtered = useMemo(() => {
  const q = query.trim().toLowerCase();
  if (!q) return PEOPLE;
  return PEOPLE.filter((p) =>
    [p.name, p.role, p.team].some((v) => v.toLowerCase().includes(q)),
  );
}, [query]);

const sorted = useMemo(() => {
  if (!sort.column || sort.order === 'none') return filtered;
  const dir = sort.order === 'desc' ? -1 : 1;
  return [...filtered].sort((a, b) => {
    const av = a[sort.column], bv = b[sort.column];
    return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
  });
}, [filtered, sort]);

const pageRows = sorted.slice(page * perPage, (page + 1) * perPage);

return (
  <MdTableContainer variant="outlined" maxHeight="420px">
    <MdTableToolbar slot="top" headline="Employees" supportingText={`${PEOPLE.length} people`} autoBind>
      <MdIconButton
        slot="actions"
        icon="filter_list"
        aria-label="Filter employees"
        onClick={() => setShowFilter((v) => !v)}
      />
      <MdIconButton slot="selection-actions" icon="delete" aria-label="Delete selected" />
      <MdIconButton slot="selection-actions" icon="archive" aria-label="Archive selected" />
    </MdTableToolbar>

    {showFilter && (
      <div style={{ padding: '8px 16px 12px' }}>
        <MdTextField
          variant="outlined"
          label="Filter"
          density={-2}
          value={query}
          // mdInput's detail IS the value (a string), not { value }.
          onMdInput={(e) => { setQuery(e.detail); setPage(0); }}
        >
          <span slot="leading-icon" className="material-symbols-outlined">search</span>
        </MdTextField>
      </div>
    )}

    <MdTable
      ref={tableRef}
      frozenHeader
      selection="multiple"
      rowCount={sorted.length}
      rowOffset={page * perPage}
      columnTemplate="auto 1.6fr 1.4fr 1fr 1fr"
      label="Employees"
      empty={sorted.length === 0}
      onMdSortChange={(e) => { setSort(e.detail); setPage(0); }}
    >
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head padding="checkbox">
            <MdCheckbox aria-label="Select all rows" onMdChange={() => tableRef.current?.toggleSelectAll()} />
          </MdTableCell>
          <MdTableCell head scope="col"><MdTableSortLabel column="name">Name</MdTableSortLabel></MdTableCell>
          <MdTableCell head scope="col"><MdTableSortLabel column="role">Role</MdTableSortLabel></MdTableCell>
          <MdTableCell head scope="col"><MdTableSortLabel column="team">Team</MdTableSortLabel></MdTableCell>
          <MdTableCell head scope="col" numeric><MdTableSortLabel column="salary">Salary</MdTableSortLabel></MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {pageRows.map((p) => (
          <MdTableRow key={p.id} value={p.id}>
            <MdTableCell padding="checkbox"><MdCheckbox aria-label={`Select ${p.name}`} /></MdTableCell>
            <MdTableCell head scope="row">{p.name}</MdTableCell>
            <MdTableCell>{p.role}</MdTableCell>
            <MdTableCell>{p.team}</MdTableCell>
            <MdTableCell numeric>{money(p.salary)}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
      <div slot="empty" style={{ padding: 32, textAlign: 'center' }}>No employees match that filter.</div>
    </MdTable>

    <MdTablePagination
      slot="bottom"
      count={sorted.length}
      page={page}
      rowsPerPage={perPage}
      onMdPageChange={(e) => setPage(e.detail.page)}
      onMdRowsPerPageChange={(e) => { setPerPage(e.detail.rowsPerPage); setPage(0); }}
    />
  </MdTableContainer>
);
}

Copy

// employee-grid.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA, ElementRef, ViewChild } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Person { id: string; name: string; role: string; team: string; salary: number; }

@Component({
selector: 'app-employee-grid',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined" max-height="420px">
    <md-table-toolbar slot="top" headline="Employees" [attr.supporting-text]="people.length + ' people'" auto-bind>
      <md-icon-button slot="actions" icon="filter_list" aria-label="Filter employees"
                      (click)="showFilter = !showFilter"></md-icon-button>
      <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete selected"></md-icon-button>
      <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive selected"></md-icon-button>
    </md-table-toolbar>

    <div *ngIf="showFilter" style="padding: 8px 16px 12px;">
      <md-text-field variant="outlined" label="Filter" density="-2" (mdInput)="onQuery($event)">
        <span slot="leading-icon" class="material-symbols-outlined">search</span>
      </md-text-field>
    </div>

    <md-table
      #table
      frozen-header
      selection="multiple"
      [attr.row-count]="sorted.length"
      [attr.row-offset]="page * perPage"
      column-template="auto 1.6fr 1.4fr 1fr 1fr"
      label="Employees"
      [attr.empty]="sorted.length === 0 ? '' : null"
      (mdSortChange)="onSort($event)"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox">
            <md-checkbox aria-label="Select all rows" (mdChange)="selectAll()"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col"><md-table-sort-label column="role">Role</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col"><md-table-sort-label column="team">Team</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let p of pageRows; trackBy: trackById" [attr.value]="p.id">
          <md-table-cell padding="checkbox">
            <md-checkbox [attr.aria-label]="'Select ' + p.name"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="row">{{ p.name }}</md-table-cell>
          <md-table-cell>{{ p.role }}</md-table-cell>
          <md-table-cell>{{ p.team }}</md-table-cell>
          <md-table-cell numeric>{{ p.salary | currency:'USD':'symbol':'1.0-0' }}</md-table-cell>
        </md-table-row>
      </md-table-body>
      <div slot="empty" style="padding: 32px; text-align: center;">No employees match that filter.</div>
    </md-table>

    <md-table-pagination
      slot="bottom"
      [attr.count]="sorted.length"
      [attr.page]="page"
      [attr.rows-per-page]="perPage"
      (mdPageChange)="page = $any($event).detail.page"
      (mdRowsPerPageChange)="perPage = $any($event).detail.rowsPerPage; page = 0"
    ></md-table-pagination>
  </md-table-container>
`,
})
export class EmployeeGridComponent {
@ViewChild('table') tableRef!: ElementRef<HTMLElement & { toggleSelectAll(): Promise<void> }>;

people: Person[] = [
  { id: 'g1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
  { id: 'g2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
  { id: 'g3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
  { id: 'g4', name: 'Linus Torvalds', role: 'Kernel Engineer', team: 'Infrastructure', salary: 168000 },
  { id: 'g5', name: 'Margaret Hamilton', role: 'Software Lead', team: 'Avionics', salary: 175000 },
  { id: 'g6', name: 'Donald Knuth', role: 'Author / Researcher', team: 'Research', salary: 195000 },
];

query = '';
showFilter = false;
sortBy = '';
sortOrder = 'none';
page = 0;
perPage = 5;

get filtered(): Person[] {
  const q = this.query.trim().toLowerCase();
  if (!q) return this.people;
  return this.people.filter((p) =>
    [p.name, p.role, p.team].some((v) => v.toLowerCase().includes(q)));
}

get sorted(): Person[] {
  if (!this.sortBy || this.sortOrder === 'none') return this.filtered;
  const dir = this.sortOrder === 'desc' ? -1 : 1;
  return [...this.filtered].sort((a, b) => {
    const av = a[this.sortBy as keyof Person];
    const bv = b[this.sortBy as keyof Person];
    return (typeof av === 'number' && typeof bv === 'number'
      ? av - bv : String(av).localeCompare(String(bv))) * dir;
  });
}

get pageRows(): Person[] {
  return this.sorted.slice(this.page * this.perPage, (this.page + 1) * this.perPage);
}

onQuery(event: Event) {
  // mdInput's detail IS the value (a string), not { value }.
  this.query = (event as CustomEvent<string>).detail;
  this.page = 0;
}

onSort(event: Event) {
  const { column, order } = (event as CustomEvent<{ column: string; order: string }>).detail;
  this.sortBy = column;
  this.sortOrder = order;
  this.page = 0;
}

selectAll() { void this.tableRef.nativeElement.toggleSelectAll(); }

trackById = (_: number, p: Person) => p.id;
}

Copy

<script setup>
import { computed, ref } from 'vue';
import '@awc-ui/core/define';

const PEOPLE = [
{ id: 'g1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
{ id: 'g2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
{ id: 'g3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
{ id: 'g4', name: 'Linus Torvalds', role: 'Kernel Engineer', team: 'Infrastructure', salary: 168000 },
{ id: 'g5', name: 'Margaret Hamilton', role: 'Software Lead', team: 'Avionics', salary: 175000 },
{ id: 'g6', name: 'Donald Knuth', role: 'Author / Researcher', team: 'Research', salary: 195000 },
// … six more …
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

const table = ref(null);
const query = ref('');
const showFilter = ref(false);
const sort = ref({ column: '', order: 'none' });
const page = ref(0);
const perPage = ref(5);

// Filter -> sort -> page, all derived from one source of truth.
const filtered = computed(() => {
const q = query.value.trim().toLowerCase();
if (!q) return PEOPLE;
return PEOPLE.filter((p) => [p.name, p.role, p.team].some((v) => v.toLowerCase().includes(q)));
});

const sorted = computed(() => {
if (!sort.value.column || sort.value.order === 'none') return filtered.value;
const dir = sort.value.order === 'desc' ? -1 : 1;
return [...filtered.value].sort((a, b) => {
  const av = a[sort.value.column], bv = b[sort.value.column];
  return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
});
});

const pageRows = computed(() =>
sorted.value.slice(page.value * perPage.value, (page.value + 1) * perPage.value));
</script>

<template>
<md-table-container variant="outlined" max-height="420px">
  <md-table-toolbar slot="top" headline="Employees" :supporting-text="PEOPLE.length + ' people'" auto-bind>
    <md-icon-button slot="actions" icon="filter_list" aria-label="Filter employees"
                    @click="showFilter = !showFilter"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete selected"></md-icon-button>
    <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive selected"></md-icon-button>
  </md-table-toolbar>

  <div v-if="showFilter" style="padding: 8px 16px 12px;">
    <md-text-field variant="outlined" label="Filter" density="-2"
                   @mdInput="query = $event.detail; page = 0">
      <span slot="leading-icon" class="material-symbols-outlined">search</span>
    </md-text-field>
  </div>

  <md-table
    ref="table"
    frozen-header
    selection="multiple"
    :row-count="sorted.length"
    :row-offset="page * perPage"
    column-template="auto 1.6fr 1.4fr 1fr 1fr"
    label="Employees"
    :empty="sorted.length === 0"
    @mdSortChange="sort = $event.detail; page = 0"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox">
          <md-checkbox aria-label="Select all rows" @mdChange="table.toggleSelectAll()"></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="role">Role</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="team">Team</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="p in pageRows" :key="p.id" :value="p.id">
        <md-table-cell padding="checkbox"><md-checkbox :aria-label="'Select ' + p.name"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">{{ p.name }}</md-table-cell>
        <md-table-cell>{{ p.role }}</md-table-cell>
        <md-table-cell>{{ p.team }}</md-table-cell>
        <md-table-cell numeric>{{ money(p.salary) }}</md-table-cell>
      </md-table-row>
    </md-table-body>
    <div slot="empty" style="padding: 32px; text-align: center;">No employees match that filter.</div>
  </md-table>

  <md-table-pagination
    slot="bottom"
    :count="sorted.length"
    :page="page"
    :rows-per-page="perPage"
    @mdPageChange="page = $event.detail.page"
    @mdRowsPerPageChange="perPage = $event.detail.rowsPerPage; page = 0"
  ></md-table-pagination>
</md-table-container>
</template>

Copy

<script>
import '@awc-ui/core/define';

const PEOPLE = [
  { id: 'g1', name: 'Ada Lovelace', role: 'Mathematician', team: 'Engineering', salary: 120000 },
  { id: 'g2', name: 'Alan Turing', role: 'Cryptanalyst', team: 'Security', salary: 145000 },
  { id: 'g3', name: 'Grace Hopper', role: 'Compiler Engineer', team: 'Platform', salary: 132000 },
  { id: 'g4', name: 'Linus Torvalds', role: 'Kernel Engineer', team: 'Infrastructure', salary: 168000 },
  { id: 'g5', name: 'Margaret Hamilton', role: 'Software Lead', team: 'Avionics', salary: 175000 },
  { id: 'g6', name: 'Donald Knuth', role: 'Author / Researcher', team: 'Research', salary: 195000 },
  // … six more …
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 });

let table;
let query = '';
let showFilter = false;
let sort = { column: '', order: 'none' };
let page = 0;
let perPage = 5;

// Filter -> sort -> page, all reactive from one source of truth.
$: filtered = query.trim()
  ? PEOPLE.filter((p) => [p.name, p.role, p.team]
      .some((v) => v.toLowerCase().includes(query.trim().toLowerCase())))
  : PEOPLE;

$: sorted = !sort.column || sort.order === 'none'
  ? filtered
  : [...filtered].sort((a, b) => {
      const dir = sort.order === 'desc' ? -1 : 1;
      const av = a[sort.column], bv = b[sort.column];
      return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
    });

$: pageRows = sorted.slice(page * perPage, (page + 1) * perPage);
</script>

<md-table-container variant="outlined" max-height="420px">
<md-table-toolbar slot="top" headline="Employees" supporting-text={PEOPLE.length + ' people'} auto-bind>
  <md-icon-button slot="actions" icon="filter_list" aria-label="Filter employees"
                  on:click={() => (showFilter = !showFilter)}></md-icon-button>
  <md-icon-button slot="selection-actions" icon="delete" aria-label="Delete selected"></md-icon-button>
  <md-icon-button slot="selection-actions" icon="archive" aria-label="Archive selected"></md-icon-button>
</md-table-toolbar>

{#if showFilter}
  <div style="padding: 8px 16px 12px;">
    <md-text-field variant="outlined" label="Filter" density="-2"
                   on:mdInput={(e) => { query = e.detail; page = 0; }}>
      <span slot="leading-icon" class="material-symbols-outlined">search</span>
    </md-text-field>
  </div>
{/if}

<md-table
  bind:this={table}
  frozen-header
  selection="multiple"
  row-count={sorted.length}
  row-offset={page * perPage}
  column-template="auto 1.6fr 1.4fr 1fr 1fr"
  label="Employees"
  empty={sorted.length === 0}
  on:mdSortChange={(e) => { sort = e.detail; page = 0; }}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head padding="checkbox">
        <md-checkbox aria-label="Select all rows" on:mdChange={() => table.toggleSelectAll()}></md-checkbox>
      </md-table-cell>
      <md-table-cell head scope="col"><md-table-sort-label column="name">Name</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col"><md-table-sort-label column="role">Role</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col"><md-table-sort-label column="team">Team</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col" numeric><md-table-sort-label column="salary">Salary</md-table-sort-label></md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each pageRows as p (p.id)}
      <md-table-row value={p.id}>
        <md-table-cell padding="checkbox"><md-checkbox aria-label={'Select ' + p.name}></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">{p.name}</md-table-cell>
        <md-table-cell>{p.role}</md-table-cell>
        <md-table-cell>{p.team}</md-table-cell>
        <md-table-cell numeric>{money(p.salary)}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
  <div slot="empty" style="padding: 32px; text-align: center;">No employees match that filter.</div>
</md-table>

<md-table-pagination
  slot="bottom"
  count={sorted.length}
  {page}
  rows-per-page={perPage}
  on:mdPageChange={(e) => (page = e.detail.page)}
  on:mdRowsPerPageChange={(e) => { perPage = e.detail.rowsPerPage; page = 0; }}
></md-table-pagination>
</md-table-container>

Events

Event	Cancelable	Detail	Fires
mdSortChange	no	MdTableSortState	After a md-table-sort-label is clicked, or setSort() runs
mdSelectionChange	no	MdTableSelectionState	Whenever the row selection changes
mdPinChange	no	{ column, side } — side is 'start' | 'end' | null	A column is pinned / unpinned via pinColumn()
mdColumnVisibilityChange	no	{ column, visible, hidden }	setColumnVisibility() runs
mdScroll	no	{ scrollLeft, scrollTop }	rAF-throttled scroll of the frozen body scroller

interface MdTableSortState {
  column: string;                      // '' when there is no sort
  order: 'asc' | 'desc' | 'none';
}

interface MdTableSelectionState {
  count: number;                       // selected rows
  total: number;                       // selectable rendered rows
  values: string[];                    // each selected row's value / id
  all: boolean;
  indeterminate: boolean;
}

All five events bubble and are composed, so one delegated listener on an ancestor catches them. Sort a column or tick a row below and watch the two you will actually wire — mdSortChange and mdSelectionChange — arrive:

Both events, live — sort a column or tick a row and read the log

Client Amount Acme Corp$1,200.00 Globex$3,120.00 Initech$860.00

Sort a column, or tick a row — the events land here.

Show code for each technology

HTML React Angular Vue Svelte

Copy

<md-table-container variant="outlined">
<md-table id="t" column-template="auto 2fr 1fr" selection="multiple" label="Invoices">
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head padding="checkbox"><md-checkbox id="all" aria-label="Select all rows"></md-checkbox></md-table-cell>
      <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body id="rows"></md-table-body>
</md-table>
</md-table-container>

<script type="module">
import '@awc-ui/core/define';

const table = document.getElementById('t');

// No checkbox listener needed: selection="multiple" makes the table handle
// the slotted boxes, select-all box included.

table.addEventListener('mdSortChange', (e) => {
  const { column, order } = e.detail;   // MdTableSortState
  table.animateNextChange();            // before the DOM mutation
  render(sortRows(data, column, order));// YOU sort
});

table.addEventListener('mdSelectionChange', (e) => {
  // MdTableSelectionState: count, total, values, all, indeterminate
  console.log(e.detail.count, e.detail.values);
});
</script>

Copy

import { useMemo, useRef, useState } from 'react';
import {
MdCheckbox, MdTable, MdTableBody, MdTableCell, MdTableContainer,
MdTableHead, MdTableRow, MdTableSortLabel,
} from '@awc-ui/react';

const INVOICES = [
{ id: 'inv-1', client: 'Acme Corp', amount: 1200 },
{ id: 'inv-2', client: 'Globex', amount: 3120 },
{ id: 'inv-3', client: 'Initech', amount: 860 },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

export function InvoiceEvents() {
const tableRef = useRef(null);
const [sort, setSort] = useState({ column: '', order: 'none' });
const [log, setLog] = useState([]);

const push = (line) => setLog((l) => [line, ...l].slice(0, 6));

// The table reports sort state; the rows are yours to order.
const rows = useMemo(() => {
  if (!sort.column || sort.order === 'none') return INVOICES;
  const dir = sort.order === 'desc' ? -1 : 1;
  return [...INVOICES].sort((a, b) => {
    const av = a[sort.column];
    const bv = b[sort.column];
    return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
  });
}, [sort]);

return (
  <>
    <MdTableContainer variant="outlined">
      <MdTable
        ref={tableRef}
        columnTemplate="auto 2fr 1fr"
        selection="multiple"
        label="Invoices"
        onMdSortChange={(e) => {
          tableRef.current?.animateNextChange();
          setSort(e.detail);
          push(`mdSortChange   column=${e.detail.column || '(none)'}   order=${e.detail.order}`);
        }}
        onMdSelectionChange={(e) =>
          push(`mdSelectionChange   count=${e.detail.count}/${e.detail.total}   values=[${e.detail.values.join(', ')}]`)
        }
      >
        <MdTableHead>
          <MdTableRow rowgroup="head">
            <MdTableCell head padding="checkbox">
              <MdCheckbox aria-label="Select all rows" onMdChange={() => tableRef.current?.toggleSelectAll()} />
            </MdTableCell>
            <MdTableCell head scope="col"><MdTableSortLabel column="client">Client</MdTableSortLabel></MdTableCell>
            <MdTableCell head scope="col" numeric><MdTableSortLabel column="amount">Amount</MdTableSortLabel></MdTableCell>
          </MdTableRow>
        </MdTableHead>
        <MdTableBody>
          {rows.map((row) => (
            <MdTableRow key={row.id} value={row.id}>
              <MdTableCell padding="checkbox"><MdCheckbox aria-label={`Select ${row.client}`} /></MdTableCell>
              <MdTableCell head scope="row">{row.client}</MdTableCell>
              <MdTableCell numeric>{money(row.amount)}</MdTableCell>
            </MdTableRow>
          ))}
        </MdTableBody>
      </MdTable>
    </MdTableContainer>
    <pre role="status">{log.join('\n')}</pre>
  </>
);
}

Copy

// invoice-events.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA, ElementRef, ViewChild } from '@angular/core';
import { CommonModule } from '@angular/common';
import { defineCustomElements } from '@awc-ui/core/loader';

defineCustomElements(window);

interface Invoice { id: string; client: string; amount: number; }

@Component({
selector: 'app-invoice-events',
standalone: true,
imports: [CommonModule],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined">
    <md-table
      #table
      column-template="auto 2fr 1fr"
      selection="multiple"
      label="Invoices"
      (mdSortChange)="onSort($event)"
      (mdSelectionChange)="onSelection($event)"
    >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox">
            <md-checkbox aria-label="Select all rows" (mdChange)="selectAll()"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
          <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of rows; trackBy: trackById" [attr.value]="row.id">
          <md-table-cell padding="checkbox">
            <md-checkbox [attr.aria-label]="'Select ' + row.client"></md-checkbox>
          </md-table-cell>
          <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
          <md-table-cell numeric>{{ row.amount | currency }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <pre role="status">{{ log.join('&#10;') }}</pre>
`,
})
export class InvoiceEventsComponent {
@ViewChild('table') tableRef!: ElementRef<HTMLElement & {
  toggleSelectAll(): Promise<void>;
  animateNextChange(): Promise<void>;
}>;

private readonly invoices: Invoice[] = [
  { id: 'inv-1', client: 'Acme Corp', amount: 1200 },
  { id: 'inv-2', client: 'Globex', amount: 3120 },
  { id: 'inv-3', client: 'Initech', amount: 860 },
];

rows = this.invoices;
log: string[] = [];

selectAll() { void this.tableRef.nativeElement.toggleSelectAll(); }

onSort(event: Event) {
  const { column, order } = (event as CustomEvent<{ column: string; order: string }>).detail;
  this.push(`mdSortChange   column=${column || '(none)'}   order=${order}`);
  void this.tableRef.nativeElement.animateNextChange();
  if (!column || order === 'none') { this.rows = this.invoices; return; }
  const dir = order === 'desc' ? -1 : 1;
  this.rows = [...this.invoices].sort((a, b) => {
    const av = a[column as keyof Invoice];
    const bv = b[column as keyof Invoice];
    return (typeof av === 'number' && typeof bv === 'number'
      ? av - bv
      : String(av).localeCompare(String(bv))) * dir;
  });
}

onSelection(event: Event) {
  const { count, total, values } = (event as CustomEvent<{ count: number; total: number; values: string[] }>).detail;
  this.push(`mdSelectionChange   count=${count}/${total}   values=[${values.join(', ')}]`);
}

private push(line: string) { this.log = [line, ...this.log].slice(0, 6); }

trackById = (_: number, row: Invoice) => row.id;
}

Copy

<script setup lang="ts">
import { computed, ref } from 'vue';
import '@awc-ui/core/define';

const INVOICES = [
{ id: 'inv-1', client: 'Acme Corp', amount: 1200 },
{ id: 'inv-2', client: 'Globex', amount: 3120 },
{ id: 'inv-3', client: 'Initech', amount: 860 },
];

const money = (n: number) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

const table = ref<any>(null);
const sort = ref({ column: '', order: 'none' });
const log = ref<string[]>([]);
const push = (line: string) => { log.value = [line, ...log.value].slice(0, 6); };

const rows = computed(() => {
if (!sort.value.column || sort.value.order === 'none') return INVOICES;
const dir = sort.value.order === 'desc' ? -1 : 1;
return [...INVOICES].sort((a, b) => {
  const av = a[sort.value.column];
  const bv = b[sort.value.column];
  return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
});
});

function onSort(e: CustomEvent) {
push(`mdSortChange   column=${e.detail.column || '(none)'}   order=${e.detail.order}`);
table.value?.animateNextChange();
sort.value = e.detail;
}

function onSelection(e: CustomEvent) {
push(`mdSelectionChange   count=${e.detail.count}/${e.detail.total}   values=[${e.detail.values.join(', ')}]`);
}
</script>

<template>
<md-table-container variant="outlined">
  <md-table
    ref="table"
    column-template="auto 2fr 1fr"
    selection="multiple"
    label="Invoices"
    @mdSortChange="onSort"
    @mdSelectionChange="onSelection"
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox">
          <md-checkbox aria-label="Select all rows" @mdChange="table.toggleSelectAll()"></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
        <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in rows" :key="row.id" :value="row.id">
        <md-table-cell padding="checkbox">
          <md-checkbox :aria-label="'Select ' + row.client"></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.amount) }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
<pre role="status">{{ log.join('\n') }}</pre>
</template>

Copy

<script lang="ts">
import '@awc-ui/core/define';

const INVOICES = [
  { id: 'inv-1', client: 'Acme Corp', amount: 1200 },
  { id: 'inv-2', client: 'Globex', amount: 3120 },
  { id: 'inv-3', client: 'Initech', amount: 860 },
];

const money = (n) => n.toLocaleString('en-US', { style: 'currency', currency: 'USD' });

let table;
let sort = { column: '', order: 'none' };
let log = [];

const push = (line) => (log = [line, ...log].slice(0, 6));

$: rows = !sort.column || sort.order === 'none'
  ? INVOICES
  : [...INVOICES].sort((a, b) => {
      const dir = sort.order === 'desc' ? -1 : 1;
      const av = a[sort.column];
      const bv = b[sort.column];
      return (typeof av === 'number' ? av - bv : String(av).localeCompare(String(bv))) * dir;
    });

function onSort(e) {
  push(`mdSortChange   column=${e.detail.column || '(none)'}   order=${e.detail.order}`);
  table.animateNextChange();
  sort = e.detail;
}

function onSelection(e) {
  push(`mdSelectionChange   count=${e.detail.count}/${e.detail.total}   values=[${e.detail.values.join(', ')}]`);
}
</script>

<md-table-container variant="outlined">
<md-table
  bind:this={table}
  column-template="auto 2fr 1fr"
  selection="multiple"
  label="Invoices"
  on:mdSortChange={onSort}
  on:mdSelectionChange={onSelection}
>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head padding="checkbox">
        <md-checkbox aria-label="Select all rows" on:mdChange={() => table.toggleSelectAll()}></md-checkbox>
      </md-table-cell>
      <md-table-cell head scope="col"><md-table-sort-label column="client">Client</md-table-sort-label></md-table-cell>
      <md-table-cell head scope="col" numeric><md-table-sort-label column="amount">Amount</md-table-sort-label></md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each rows as row (row.id)}
      <md-table-row value={row.id}>
        <md-table-cell padding="checkbox">
          <md-checkbox aria-label={'Select ' + row.client}></md-checkbox>
        </md-table-cell>
        <md-table-cell head scope="row">{row.client}</md-table-cell>
        <md-table-cell numeric>{money(row.amount)}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>
</md-table-container>
<pre role="status">{log.join('\n')}</pre>

API Reference

tune

Properties

Property	Attribute	Type	Default	Reflects
density	density	| 'compact' | 'standard' | 'comfortable' | 0 | -1 | -2 | -3 | -4	'standard'	Yes
columnTemplate	column-template	string	''	—
columns	columns	number	0	—
minWidth	min-width	string	''	—
stickyHeader	sticky-header	boolean	false	Yes
frozenHeader	frozen-header	boolean	false	Yes
keepHeight	keep-height	boolean	true	Yes
scrollbar	scrollbar	'overlay' | 'gutter'	'overlay'	Yes
pinMode	pin-mode	'stack' | 'static'	'stack'	Yes
pinIcon	pin-icon	string	''	—
stickyFooter	sticky-footer	boolean	false	Yes
striped	striped	boolean	false	Yes
noDividers	no-dividers	boolean	false	Yes
hoverable	hoverable	boolean	true	Yes
motion	motion	'expressive' | 'none'	'expressive'	Yes
selection	selection	'none' | 'single' | 'multiple'	'none'	Yes
sortBy	sort-by	string	''	Yes
sortOrder	sort-order	MdTableSortOrder	'asc'	Yes
loading	loading	boolean	false	Yes
loadingMode	loading-mode	'overlay' | 'skeleton'	'overlay'	Yes
loadingRows	loading-rows	number	4	—
empty	empty	boolean	false	Yes
label	label	string	''	—
caption	caption	string	''	—
summary	summary	string	''	—
rowOffset	row-offset	number	0	—
rowCount	row-count	number	0	—

function

Methods

Method	Parameters
getSelection()	none
selectAll()	none
deselectAll()	none
toggleSelectAll()	none
setSort()	column: string, order: MdTableSortOrder
pinColumn()	column: number, side: 'start' | 'end' | 'none'
setColumnVisibility()	column: number, visible: boolean
animateNextChange()	none

view_in_ar

Slots

Slot	Description
(default)	—
empty	—
head	—
loader	—
loading	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-row-height-compact	36px (dense)
--md-table-row-height-standard	52px
--md-table-row-height-comfortable	60px
--md-table-header-height	56px
--md-table-cell-padding-inline	per-density default
--md-table-divider-color	between rows
--md-table-stripe-color	every-other-row overlay color
--md-table-head-bg	background for thead rows
--md-table-head-color	text color for thead
--md-table-foot-bg	background for tfoot rows
--md-table-row-hover-color	row hover state-layer color
--md-table-row-selected-bg	selected row background
--md-table-row-selected-color	selected row text
--md-table-columns-template	grid-template-columns override
--md-table-cell-padding-block	—
--md-table-min-width	—
--md-table-body-max-h	—
--md-table-empty-min-height	—

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
skeleton-row	—
empty	The empty-state region (when `empty`)
caption	The optional caption above the head
header-grid	—
grid	The grid container holding all rows
hscrollbar	—
hscrollbar-thumb	—
vscrollbar	—
vscrollbar-thumb	—
loading	The loading overlay (when `loading`)
progress	—

Accessibility

• Because the layout is CSS Grid rather than a native <table>, the ARIA structure carries the semantics: the rowgroups are rowgroups, md-table-row is a row, and md-table-cell is a cell — or a column / row header via head + scope.
• Get scope right. head alone styles a cell like a header; scope="col" / scope="row" / scope="colgroup" is what makes data cells announce with their column or row. The trio — rowgroup on the row, head and scope on the cell — works together.
• label names the role="table". When it’s omitted the caption text names the table instead (IDREFs can’t cross the shadow boundary, so the caption text is mirrored into aria-label rather than referenced); the generic “Data table” is the last resort. Never ship an unnamed data grid.
• summary describes a complex table’s structure (“Columns are grouped under Profile and Employment”) and is exposed as aria-description.
• For a paginated table set row-offset (0-based index of the first rendered row) and row-count (the full dataset size), so each row gets an aria-rowindex and AT announces “row 42 of 5000” instead of a position within the current page. Update row-offset on every page change. row-offset only applies when the DOM holds just the current page — the table counts every md-table-row present, visible or not, so if you page by hiding rows rather than removing them the indices are already absolute and row-offset would double-count them. (Setting row-offset alone doesn’t re-stamp anything either: change it together with the rows.)
• Sticky and frozen headers must not cover the focused row — check keyboard scrolling after changing heights.
• motion="none" for reduced-motion users; prefers-reduced-motion is honoured automatically.

Everything focusable in a table is something you slotted into a cell, so the tab order is the order you authored. Tab through this one: each row’s expand toggle and checkbox is a stop, and the rows announce their position in the whole dataset because row-offset and row-count are set:

Named, described and positioned — try tabbing through it

Client Amount Acme Corp $1,200.00

Three line items · paid by card ending 4242 on 4 May.

Globex $3,120.00

Awaiting PO approval — chased 2 days ago.

Initech $860.00

Partially credited against invoice 41.

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table
    column-template="auto auto 2fr 1fr"
    selection="multiple"
    label="Invoices"
    caption="Invoices — rows 21 to 23 of 120"
    summary="Four columns: an expand toggle, a selection checkbox, the client name and the amount in US dollars."
    row-offset="20"
    row-count="120"
    keep-height="false"
    >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="a1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Acme Corp"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="a2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Globex"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
      <md-table-row value="a3" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Initech"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Initech"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$860.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Partially credited against invoice 41.</div>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdCheckbox, MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableExpandToggle, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined">
        <MdTable
          columnTemplate="auto auto 2fr 1fr"
          selection="multiple"
          label="Invoices"
          caption="Invoices — rows 21 to 23 of 120"
          summary="Four columns: an expand toggle, a selection checkbox, the client name and the amount in US dollars."
          rowOffset="20"
          rowCount="120"
          keepHeight="false"
          >
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head padding="checkbox"></MdTableCell>
              <MdTableCell head padding="checkbox"></MdTableCell>
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="a1" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Acme Corp"></MdTableExpandToggle></MdTableCell>
              <MdTableCell padding="checkbox"><MdCheckbox aria-label="Select Acme Corp"></MdCheckbox></MdTableCell>
              <MdTableCell head scope="row">Acme Corp</MdTableCell>
              <MdTableCell numeric>$1,200.00</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Three line items · paid by card ending 4242 on 4 May.</div>
            </MdTableRow>
            <MdTableRow value="a2" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Globex"></MdTableExpandToggle></MdTableCell>
              <MdTableCell padding="checkbox"><MdCheckbox aria-label="Select Globex"></MdCheckbox></MdTableCell>
              <MdTableCell head scope="row">Globex</MdTableCell>
              <MdTableCell numeric>$3,120.00</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Awaiting PO approval — chased 2 days ago.</div>
            </MdTableRow>
            <MdTableRow value="a3" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Initech"></MdTableExpandToggle></MdTableCell>
              <MdTableCell padding="checkbox"><MdCheckbox aria-label="Select Initech"></MdCheckbox></MdTableCell>
              <MdTableCell head scope="row">Initech</MdTableCell>
              <MdTableCell numeric>$860.00</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Partially credited against invoice 41.</div>
            </MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined">
  <md-table
    column-template="auto auto 2fr 1fr"
    selection="multiple"
    label="Invoices"
    caption="Invoices — rows 21 to 23 of 120"
    summary="Four columns: an expand toggle, a selection checkbox, the client name and the amount in US dollars."
    row-offset="20"
    row-count="120"
    keep-height="false"
    >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="a1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Acme Corp"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="a2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Globex"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
      <md-table-row value="a3" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Initech"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Initech"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$860.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Partially credited against invoice 41.</div>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined">
    <md-table
      column-template="auto auto 2fr 1fr"
      selection="multiple"
      label="Invoices"
      caption="Invoices — rows 21 to 23 of 120"
      summary="Four columns: an expand toggle, a selection checkbox, the client name and the amount in US dollars."
      row-offset="20"
      row-count="120"
      keep-height="false"
      >
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox"></md-table-cell>
          <md-table-cell head padding="checkbox"></md-table-cell>
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="a1" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
          <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Acme Corp"></md-checkbox></md-table-cell>
          <md-table-cell head scope="row">Acme Corp</md-table-cell>
          <md-table-cell numeric>$1,200.00</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
        </md-table-row>
        <md-table-row value="a2" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
          <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Globex"></md-checkbox></md-table-cell>
          <md-table-cell head scope="row">Globex</md-table-cell>
          <md-table-cell numeric>$3,120.00</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
        </md-table-row>
        <md-table-row value="a3" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Initech"></md-table-expand-toggle></md-table-cell>
          <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Initech"></md-checkbox></md-table-cell>
          <md-table-cell head scope="row">Initech</md-table-cell>
          <md-table-cell numeric>$860.00</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Partially credited against invoice 41.</div>
        </md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table
    column-template="auto auto 2fr 1fr"
    selection="multiple"
    label="Invoices"
    caption="Invoices — rows 21 to 23 of 120"
    summary="Four columns: an expand toggle, a selection checkbox, the client name and the amount in US dollars."
    row-offset="20"
    row-count="120"
    keep-height="false"
    >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="a1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Acme Corp"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="a2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Globex"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
      <md-table-row value="a3" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Initech"></md-table-expand-toggle></md-table-cell>
        <md-table-cell padding="checkbox"><md-checkbox aria-label="Select Initech"></md-checkbox></md-table-cell>
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$860.00</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Partially credited against invoice 41.</div>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

RTL, density & i18n

RTL — column order, pinning sides and the scrollbars mirror under dir="rtl". column-template is a raw grid value though, so track sizes follow the columns rather than adapting to them: a width hand-tuned for one language needs re-checking in the next. See the RTL story and RTL.

The same table in both directions. Nothing is re-authored between them — only dir changes. The tracks are laid out in the inline direction, so the first column moves to the right-hand edge and the horizontal scrollbar starts from the other end:

Same markup, dir=ltr vs dir=rtl Open in Storybook

ltr

العميل المبلغ الحالة أكمي١٢٠٠٫٠٠مدفوع غلوبكس٣١٢٠٫٠٠معلق

rtl

العميل المبلغ الحالة أكمي١٢٠٠٫٠٠مدفوع غلوبكس٣١٢٠٫٠٠معلق

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">ltr</span>
  <div dir="ltr">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">rtl</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gridTemplateColumns: 'auto 1fr', gap: '14px 16px', alignItems: 'center' }}>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>ltr</span>
        <div dir="ltr">
          <MdTableContainer variant="outlined">
            <MdTable columnTemplate="2fr 1fr 1fr" label="الفواتير">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">العميل</MdTableCell>
                  <MdTableCell head scope="col" numeric>المبلغ</MdTableCell>
                  <MdTableCell head scope="col">الحالة</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow value="1"><MdTableCell head scope="row">أكمي</MdTableCell><MdTableCell numeric>١٢٠٠٫٠٠</MdTableCell><MdTableCell>مدفوع</MdTableCell></MdTableRow>
                <MdTableRow value="2"><MdTableCell head scope="row">غلوبكس</MdTableCell><MdTableCell numeric>٣١٢٠٫٠٠</MdTableCell><MdTableCell>معلق</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>rtl</span>
        <div dir="rtl">
          <MdTableContainer variant="outlined">
            <MdTable columnTemplate="2fr 1fr 1fr" label="الفواتير">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">العميل</MdTableCell>
                  <MdTableCell head scope="col" numeric>المبلغ</MdTableCell>
                  <MdTableCell head scope="col">الحالة</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow value="1"><MdTableCell head scope="row">أكمي</MdTableCell><MdTableCell numeric>١٢٠٠٫٠٠</MdTableCell><MdTableCell>مدفوع</MdTableCell></MdTableRow>
                <MdTableRow value="2"><MdTableCell head scope="row">غلوبكس</MdTableCell><MdTableCell numeric>٣١٢٠٫٠٠</MdTableCell><MdTableCell>معلق</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">ltr</span>
  <div dir="ltr">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">rtl</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">ltr</span>
    <div dir="ltr">
      <md-table-container variant="outlined">
        <md-table column-template="2fr 1fr 1fr" label="الفواتير">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">العميل</md-table-cell>
              <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
              <md-table-cell head scope="col">الحالة</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
            <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">rtl</span>
    <div dir="rtl">
      <md-table-container variant="outlined">
        <md-table column-template="2fr 1fr 1fr" label="الفواتير">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">العميل</md-table-cell>
              <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
              <md-table-cell head scope="col">الحالة</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
            <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">ltr</span>
  <div dir="ltr">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">rtl</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

column-template is a raw grid value, so size it in fr

The direction mirrors for free; the track sizes do not adapt. A width hand-tuned for one language’s headers is still that width after translation, and a px track that fitted “Client” will crowd or truncate the same column in Arabic or German. Size the text columns in fr / minmax() and keep px for genuinely fixed content — a checkbox, an icon column:

A px-sized text column against an fr-sized one, same translated content

correct

المنطقة الجغرافية المبلغ الحالة الشرق الأوسط١٢٠٠٫٠٠مدفوع

wrong

المنطقة الجغرافية المبلغ الحالة الشرق الأوسط١٢٠٠٫٠٠مدفوع

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">correct</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="minmax(120px, 2fr) 1fr 1fr" label="أرقام المبيعات">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="c1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">wrong</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="72px 1fr 1fr" label="أرقام المبيعات">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="w1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gridTemplateColumns: 'auto 1fr', gap: '14px 16px', alignItems: 'center' }}>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>correct</span>
        <div dir="rtl">
          <MdTableContainer variant="outlined">
            <MdTable columnTemplate="minmax(120px, 2fr) 1fr 1fr" label="أرقام المبيعات">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">المنطقة الجغرافية</MdTableCell>
                  <MdTableCell head scope="col" numeric>المبلغ</MdTableCell>
                  <MdTableCell head scope="col">الحالة</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow value="c1"><MdTableCell head scope="row">الشرق الأوسط</MdTableCell><MdTableCell numeric>١٢٠٠٫٠٠</MdTableCell><MdTableCell>مدفوع</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>wrong</span>
        <div dir="rtl">
          <MdTableContainer variant="outlined">
            <MdTable columnTemplate="72px 1fr 1fr" label="أرقام المبيعات">
              <MdTableHead>
                <MdTableRow rowgroup="head">
                  <MdTableCell head scope="col">المنطقة الجغرافية</MdTableCell>
                  <MdTableCell head scope="col" numeric>المبلغ</MdTableCell>
                  <MdTableCell head scope="col">الحالة</MdTableCell>
                </MdTableRow>
              </MdTableHead>
              <MdTableBody>
                <MdTableRow value="w1"><MdTableCell head scope="row">الشرق الأوسط</MdTableCell><MdTableCell numeric>١٢٠٠٫٠٠</MdTableCell><MdTableCell>مدفوع</MdTableCell></MdTableRow>
              </MdTableBody>
            </MdTable>
          </MdTableContainer>
        </div>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">correct</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="minmax(120px, 2fr) 1fr 1fr" label="أرقام المبيعات">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="c1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">wrong</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="72px 1fr 1fr" label="أرقام المبيعات">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="w1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">correct</span>
    <div dir="rtl">
      <md-table-container variant="outlined">
        <md-table column-template="minmax(120px, 2fr) 1fr 1fr" label="أرقام المبيعات">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
              <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
              <md-table-cell head scope="col">الحالة</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row value="c1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">wrong</span>
    <div dir="rtl">
      <md-table-container variant="outlined">
        <md-table column-template="72px 1fr 1fr" label="أرقام المبيعات">
          <md-table-head>
            <md-table-row rowgroup="head">
              <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
              <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
              <md-table-cell head scope="col">الحالة</md-table-cell>
            </md-table-row>
          </md-table-head>
          <md-table-body>
            <md-table-row value="w1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          </md-table-body>
        </md-table>
      </md-table-container>
    </div>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">correct</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="minmax(120px, 2fr) 1fr 1fr" label="أرقام المبيعات">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="c1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">wrong</span>
  <div dir="rtl">
    <md-table-container variant="outlined">
      <md-table column-template="72px 1fr 1fr" label="أرقام المبيعات">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">المنطقة الجغرافية</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="w1"><md-table-cell head scope="row">الشرق الأوسط</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</div>

Every density rung

density takes the numeric rungs as well as the semantic words, and a numeric value locally overrides the inherited data-density. All five rungs, the same two rows, so the taper is visible in one place:

Density 0 through -4 — row height, cell padding and type taper together

0 ClientAmountAcme Corp$1,200.00Globex$3,120.00 -1 ClientAmountAcme Corp$1,200.00Globex$3,120.00 -2 ClientAmountAcme Corp$1,200.00Globex$3,120.00 -3 ClientAmountAcme Corp$1,200.00Globex$3,120.00 -4 ClientAmountAcme Corp$1,200.00Globex$3,120.00

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">0</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="0" label="Rung 0"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-1</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-1" label="Rung -1"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-2</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-2" label="Rung -2"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-3</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-3" label="Rung -3"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-4</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-4" label="Rung -4"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ display: 'grid', gridTemplateColumns: 'auto 1fr', gap: '14px 16px', alignItems: 'center' }}>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>0</span>
        <MdTableContainer variant="outlined"><MdTable columnTemplate="2fr 1fr" density="0" label="Rung 0"><MdTableHead><MdTableRow rowgroup="head"><MdTableCell head scope="col">Client</MdTableCell><MdTableCell head scope="col" numeric>Amount</MdTableCell></MdTableRow></MdTableHead><MdTableBody><MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow><MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow></MdTableBody></MdTable></MdTableContainer>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>-1</span>
        <MdTableContainer variant="outlined"><MdTable columnTemplate="2fr 1fr" density="-1" label="Rung -1"><MdTableHead><MdTableRow rowgroup="head"><MdTableCell head scope="col">Client</MdTableCell><MdTableCell head scope="col" numeric>Amount</MdTableCell></MdTableRow></MdTableHead><MdTableBody><MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow><MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow></MdTableBody></MdTable></MdTableContainer>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>-2</span>
        <MdTableContainer variant="outlined"><MdTable columnTemplate="2fr 1fr" density="-2" label="Rung -2"><MdTableHead><MdTableRow rowgroup="head"><MdTableCell head scope="col">Client</MdTableCell><MdTableCell head scope="col" numeric>Amount</MdTableCell></MdTableRow></MdTableHead><MdTableBody><MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow><MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow></MdTableBody></MdTable></MdTableContainer>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>-3</span>
        <MdTableContainer variant="outlined"><MdTable columnTemplate="2fr 1fr" density="-3" label="Rung -3"><MdTableHead><MdTableRow rowgroup="head"><MdTableCell head scope="col">Client</MdTableCell><MdTableCell head scope="col" numeric>Amount</MdTableCell></MdTableRow></MdTableHead><MdTableBody><MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow><MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow></MdTableBody></MdTable></MdTableContainer>
        <span style={{ inlineSize: '3.5rem', opacity: '.65', fontSize: '.75rem', fontFamily: 'ui-monospace,monospace' }}>-4</span>
        <MdTableContainer variant="outlined"><MdTable columnTemplate="2fr 1fr" density="-4" label="Rung -4"><MdTableHead><MdTableRow rowgroup="head"><MdTableCell head scope="col">Client</MdTableCell><MdTableCell head scope="col" numeric>Amount</MdTableCell></MdTableRow></MdTableHead><MdTableBody><MdTableRow><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow><MdTableRow><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow></MdTableBody></MdTable></MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">0</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="0" label="Rung 0"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-1</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-1" label="Rung -1"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-2</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-2" label="Rung -2"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-3</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-3" label="Rung -3"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-4</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-4" label="Rung -4"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">0</span>
    <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="0" label="Rung 0"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-1</span>
    <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-1" label="Rung -1"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-2</span>
    <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-2" label="Rung -2"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-3</span>
    <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-3" label="Rung -3"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
    <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-4</span>
    <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-4" label="Rung -4"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="display:grid;grid-template-columns:auto 1fr;gap:14px 16px;align-items:center;">
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">0</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="0" label="Rung 0"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-1</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-1" label="Rung -1"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-2</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-2" label="Rung -2"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-3</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-3" label="Rung -3"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
  <span style="inline-size:3.5rem;opacity:.65;font-size:.75rem;font-family:ui-monospace,monospace;">-4</span>
  <md-table-container variant="outlined"><md-table column-template="2fr 1fr" density="-4" label="Rung -4"><md-table-head><md-table-row rowgroup="head"><md-table-cell head scope="col">Client</md-table-cell><md-table-cell head scope="col" numeric>Amount</md-table-cell></md-table-row></md-table-head><md-table-body><md-table-row><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row><md-table-row><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row></md-table-body></md-table></md-table-container>
</div>

Below -2, check the controls inside your cells

The rungs shrink the row, and anything living in a cell — a checkbox, an expand toggle, an icon button — shrinks its hit area with it. See Density for the media query that raises the target back on touch.

Density and direction together

The two are independent signals, so they compose without any extra wiring: dir="rtl" and data-density="-2" on the same ancestor. The second table asks for comfortable rows inside that region — and because the semantic sizes are themselves scale-aware, it relaxes relative to the rung rather than escaping it:

dir=rtl inside data-density=-2, and one table asking for comfortable rows

العميل المبلغ الحالة أكمي١٢٠٠٫٠٠مدفوع غلوبكس٣١٢٠٫٠٠معلق العميل المبلغ الحالة أكمي١٢٠٠٫٠٠مدفوع غلوبكس٣١٢٠٫٠٠معلق

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div dir="rtl" data-density="-2" style="display:grid;gap:16px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" striped label="الفواتير">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">العميل</md-table-cell>
          <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
          <md-table-cell head scope="col">الحالة</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="d1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        <md-table-row value="d2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" striped density="comfortable" label="الفواتير — مريح">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">العميل</md-table-cell>
          <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
          <md-table-cell head scope="col">الحالة</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="d3"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        <md-table-row value="d4"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div dir="rtl" data-density="-2" style={{ display: 'grid', gap: '16px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" striped label="الفواتير">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">العميل</MdTableCell>
                <MdTableCell head scope="col" numeric>المبلغ</MdTableCell>
                <MdTableCell head scope="col">الحالة</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="d1"><MdTableCell head scope="row">أكمي</MdTableCell><MdTableCell numeric>١٢٠٠٫٠٠</MdTableCell><MdTableCell>مدفوع</MdTableCell></MdTableRow>
              <MdTableRow value="d2"><MdTableCell head scope="row">غلوبكس</MdTableCell><MdTableCell numeric>٣١٢٠٫٠٠</MdTableCell><MdTableCell>معلق</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="2fr 1fr 1fr" striped density="comfortable" label="الفواتير — مريح">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">العميل</MdTableCell>
                <MdTableCell head scope="col" numeric>المبلغ</MdTableCell>
                <MdTableCell head scope="col">الحالة</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="d3"><MdTableCell head scope="row">أكمي</MdTableCell><MdTableCell numeric>١٢٠٠٫٠٠</MdTableCell><MdTableCell>مدفوع</MdTableCell></MdTableRow>
              <MdTableRow value="d4"><MdTableCell head scope="row">غلوبكس</MdTableCell><MdTableCell numeric>٣١٢٠٫٠٠</MdTableCell><MdTableCell>معلق</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div dir="rtl" data-density="-2" style="display:grid;gap:16px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" striped label="الفواتير">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">العميل</md-table-cell>
          <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
          <md-table-cell head scope="col">الحالة</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="d1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        <md-table-row value="d2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" striped density="comfortable" label="الفواتير — مريح">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">العميل</md-table-cell>
          <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
          <md-table-cell head scope="col">الحالة</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="d3"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        <md-table-row value="d4"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div dir="rtl" data-density="-2" style="display:grid;gap:16px;">
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" striped label="الفواتير">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="d1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="d2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
    <md-table-container variant="outlined">
      <md-table column-template="2fr 1fr 1fr" striped density="comfortable" label="الفواتير — مريح">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">العميل</md-table-cell>
            <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
            <md-table-cell head scope="col">الحالة</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="d3"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
          <md-table-row value="d4"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div dir="rtl" data-density="-2" style="display:grid;gap:16px;">
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" striped label="الفواتير">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">العميل</md-table-cell>
          <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
          <md-table-cell head scope="col">الحالة</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="d1"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        <md-table-row value="d2"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" striped density="comfortable" label="الفواتير — مريح">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">العميل</md-table-cell>
          <md-table-cell head scope="col" numeric>المبلغ</md-table-cell>
          <md-table-cell head scope="col">الحالة</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="d3"><md-table-cell head scope="row">أكمي</md-table-cell><md-table-cell numeric>١٢٠٠٫٠٠</md-table-cell><md-table-cell>مدفوع</md-table-cell></md-table-row>
        <md-table-row value="d4"><md-table-cell head scope="row">غلوبكس</md-table-cell><md-table-cell numeric>٣١٢٠٫٠٠</md-table-cell><md-table-cell>معلق</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Localized chrome

Headers, cells and the empty state are all your content, so they come straight from your i18n layer. Only the pagination and expand-toggle chrome has label props of its own — and md-table-pagination’s use percent tokens (%from%, %to%, %count%), not the braces used elsewhere in the library. The localization story switches the lot.

Translated content and translated pagination chrome Open in Storybook

Kunde Betrag Status Acme GmbH1.200,00 €Bezahlt Globex AG3.120,00 €Offen Initech KG860,00 €Bezahlt Umbrella SE2.450,00 €Entwurf Soylent GmbH1.975,00 €Bezahlt Hooli AG4.300,00 €Offen Stark Industries8.120,00 €Bezahlt Wayne Enterprises6.640,00 €Entwurf Cyberdyne GmbH2.010,00 €Bezahlt Tyrell Corp3.780,00 €Offen

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" label="Rechnungen">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Kunde</md-table-cell>
        <md-table-cell head scope="col" numeric>Betrag</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body id="loc-body">
      <md-table-row value="l1"><md-table-cell head scope="row">Acme GmbH</md-table-cell><md-table-cell numeric>1.200,00 €</md-table-cell><md-table-cell>Bezahlt</md-table-cell></md-table-row>
      <md-table-row value="l2"><md-table-cell head scope="row">Globex AG</md-table-cell><md-table-cell numeric>3.120,00 €</md-table-cell><md-table-cell>Offen</md-table-cell></md-table-row>
      <md-table-row value="l3"><md-table-cell head scope="row">Initech KG</md-table-cell><md-table-cell numeric>860,00 €</md-table-cell><md-table-cell>Bezahlt</md-table-cell></md-table-row>
      <md-table-row value="l4"><md-table-cell head scope="row">Umbrella SE</md-table-cell><md-table-cell numeric>2.450,00 €</md-table-cell><md-table-cell>Entwurf</md-table-cell></md-table-row>
      <md-table-row value="l5"><md-table-cell head scope="row">Soylent GmbH</md-table-cell><md-table-cell numeric>1.975,00 €</md-table-cell><md-table-cell>Bezahlt</md-table-cell></md-table-row>
      <md-table-row value="l6"><md-table-cell head scope="row">Hooli AG</md-table-cell><md-table-cell numeric>4.300,00 €</md-table-cell><md-table-cell>Offen</md-table-cell></md-table-row>
      <md-table-row value="l7"><md-table-cell head scope="row">Stark Industries</md-table-cell><md-table-cell numeric>8.120,00 €</md-table-cell><md-table-cell>Bezahlt</md-table-cell></md-table-row>
      <md-table-row value="l8"><md-table-cell head scope="row">Wayne Enterprises</md-table-cell><md-table-cell numeric>6.640,00 €</md-table-cell><md-table-cell>Entwurf</md-table-cell></md-table-row>
      <md-table-row value="l9"><md-table-cell head scope="row">Cyberdyne GmbH</md-table-cell><md-table-cell numeric>2.010,00 €</md-table-cell><md-table-cell>Bezahlt</md-table-cell></md-table-row>
      <md-table-row value="l10"><md-table-cell head scope="row">Tyrell Corp</md-table-cell><md-table-cell numeric>3.780,00 €</md-table-cell><md-table-cell>Offen</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
  <md-table-pagination id="loc-pag" slot="bottom" count="10" page="0" rows-per-page="5" label-rows-per-page="Zeilen pro Seite:" label-displayed-rows="%from%–%to% von %count%"></md-table-pagination>
</md-table-container>

<script type="module">
  var pag = document.getElementById('loc-pag');
  var body = document.getElementById('loc-body');
  var page = 0, perPage = 5;
  var renderPage = function () {
    var rows = Array.prototype.slice.call(body.querySelectorAll('md-table-row'));
    rows.forEach(function (r, i) { r.style.display = i >= page * perPage && i < (page + 1) * perPage ? '' : 'none'; });
  };
  pag.addEventListener('mdPageChange', function (e) { page = e.detail.page; renderPage(); });
  pag.addEventListener('mdRowsPerPageChange', function (e) { perPage = e.detail.rowsPerPage; page = 0; renderPage(); });
  renderPage();
</script>

Copy

import { useState } from 'react';
import {
MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTablePagination, MdTableRow,
} from '@awc-ui/react';

const LOCALE = 'de-DE';
const money = (n) => n.toLocaleString(LOCALE, { style: 'currency', currency: 'EUR' });

// Content is yours to translate; the pagination chrome takes label props.
const T = {
headline: 'Rechnungen',
client: 'Kunde', amount: 'Betrag', status: 'Status',
rowsPerPage: 'Zeilen pro Seite:',
displayedRows: '%from%–%to% von %count%',
};

const INVOICES = [
{ id: 'l1', client: 'Acme GmbH', amount: 1200, status: 'Bezahlt' },
{ id: 'l2', client: 'Globex AG', amount: 3120, status: 'Offen' },
{ id: 'l3', client: 'Initech KG', amount: 860, status: 'Bezahlt' },
// … seven more …
];

export function LocalizedInvoices() {
const [page, setPage] = useState(0);
const [perPage, setPerPage] = useState(5);
const pageRows = INVOICES.slice(page * perPage, (page + 1) * perPage);

return (
  <MdTableContainer variant="outlined">
    <MdTable columnTemplate="2fr 1fr 1fr" label={T.headline} rowCount={INVOICES.length} rowOffset={page * perPage}>
      <MdTableHead>
        <MdTableRow rowgroup="head">
          <MdTableCell head scope="col">{T.client}</MdTableCell>
          <MdTableCell head scope="col" numeric>{T.amount}</MdTableCell>
          <MdTableCell head scope="col">{T.status}</MdTableCell>
        </MdTableRow>
      </MdTableHead>
      <MdTableBody>
        {pageRows.map((row) => (
          <MdTableRow key={row.id} value={row.id}>
            <MdTableCell head scope="row">{row.client}</MdTableCell>
            {/* Intl formats the number; the component never assumes a locale. */}
            <MdTableCell numeric>{money(row.amount)}</MdTableCell>
            <MdTableCell>{row.status}</MdTableCell>
          </MdTableRow>
        ))}
      </MdTableBody>
    </MdTable>

    <MdTablePagination
      slot="bottom"
      count={INVOICES.length}
      page={page}
      rowsPerPage={perPage}
      labelRowsPerPage={T.rowsPerPage}
      labelDisplayedRows={T.displayedRows}
      onMdPageChange={(e) => setPage(e.detail.page)}
      onMdRowsPerPageChange={(e) => { setPerPage(e.detail.rowsPerPage); setPage(0); }}
    />
  </MdTableContainer>
);
}

Copy

// localized-invoices.component.ts
import { Component, CUSTOM_ELEMENTS_SCHEMA, LOCALE_ID } from '@angular/core';
import { CommonModule, registerLocaleData } from '@angular/common';
import localeDe from '@angular/common/locales/de';
import { defineCustomElements } from '@awc-ui/core/loader';

registerLocaleData(localeDe);
defineCustomElements(window);

interface Invoice { id: string; client: string; amount: number; status: string; }

@Component({
selector: 'app-localized-invoices',
standalone: true,
imports: [CommonModule],
providers: [{ provide: LOCALE_ID, useValue: 'de-DE' }],
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
  <md-table-container variant="outlined">
    <md-table column-template="2fr 1fr 1fr" [attr.label]="t.headline"
              [attr.row-count]="invoices.length" [attr.row-offset]="page * perPage">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">{{ t.client }}</md-table-cell>
          <md-table-cell head scope="col" numeric>{{ t.amount }}</md-table-cell>
          <md-table-cell head scope="col">{{ t.status }}</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row *ngFor="let row of pageRows; trackBy: trackById" [attr.value]="row.id">
          <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
          <md-table-cell numeric>{{ row.amount | currency:'EUR' }}</md-table-cell>
          <md-table-cell>{{ row.status }}</md-table-cell>
        </md-table-row>
      </md-table-body>
    </md-table>

    <!-- %from%/%to%/%count% are substituted, so number order can differ per language. -->
    <md-table-pagination
      slot="bottom"
      [attr.count]="invoices.length"
      [attr.page]="page"
      [attr.rows-per-page]="perPage"
      [attr.label-rows-per-page]="t.rowsPerPage"
      [attr.label-displayed-rows]="t.displayedRows"
      (mdPageChange)="page = $any($event).detail.page"
      (mdRowsPerPageChange)="perPage = $any($event).detail.rowsPerPage; page = 0"
    ></md-table-pagination>
  </md-table-container>
`,
})
export class LocalizedInvoicesComponent {
t = {
  headline: 'Rechnungen', client: 'Kunde', amount: 'Betrag', status: 'Status',
  rowsPerPage: 'Zeilen pro Seite:', displayedRows: '%from%–%to% von %count%',
};

invoices: Invoice[] = [
  { id: 'l1', client: 'Acme GmbH', amount: 1200, status: 'Bezahlt' },
  { id: 'l2', client: 'Globex AG', amount: 3120, status: 'Offen' },
  { id: 'l3', client: 'Initech KG', amount: 860, status: 'Bezahlt' },
];
page = 0;
perPage = 5;

get pageRows(): Invoice[] {
  return this.invoices.slice(this.page * this.perPage, (this.page + 1) * this.perPage);
}

trackById = (_: number, row: Invoice) => row.id;
}

Copy

<script setup>
import { computed, ref } from 'vue';
import '@awc-ui/core/define';

const LOCALE = 'de-DE';
const money = (n) => n.toLocaleString(LOCALE, { style: 'currency', currency: 'EUR' });

// Content is yours to translate; the pagination chrome takes label props.
const T = {
headline: 'Rechnungen',
client: 'Kunde', amount: 'Betrag', status: 'Status',
rowsPerPage: 'Zeilen pro Seite:',
displayedRows: '%from%–%to% von %count%',
};

const INVOICES = [
{ id: 'l1', client: 'Acme GmbH', amount: 1200, status: 'Bezahlt' },
{ id: 'l2', client: 'Globex AG', amount: 3120, status: 'Offen' },
{ id: 'l3', client: 'Initech KG', amount: 860, status: 'Bezahlt' },
// … seven more …
];

const page = ref(0);
const perPage = ref(5);
const pageRows = computed(() =>
INVOICES.slice(page.value * perPage.value, (page.value + 1) * perPage.value));
</script>

<template>
<md-table-container variant="outlined">
  <md-table column-template="2fr 1fr 1fr" :label="T.headline"
            :row-count="INVOICES.length" :row-offset="page * perPage">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">{{ T.client }}</md-table-cell>
        <md-table-cell head scope="col" numeric>{{ T.amount }}</md-table-cell>
        <md-table-cell head scope="col">{{ T.status }}</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row v-for="row in pageRows" :key="row.id" :value="row.id">
        <md-table-cell head scope="row">{{ row.client }}</md-table-cell>
        <md-table-cell numeric>{{ money(row.amount) }}</md-table-cell>
        <md-table-cell>{{ row.status }}</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>

  <md-table-pagination
    slot="bottom"
    :count="INVOICES.length"
    :page="page"
    :rows-per-page="perPage"
    :label-rows-per-page="T.rowsPerPage"
    :label-displayed-rows="T.displayedRows"
    @mdPageChange="page = $event.detail.page"
    @mdRowsPerPageChange="perPage = $event.detail.rowsPerPage; page = 0"
  ></md-table-pagination>
</md-table-container>
</template>

Copy

<script>
import '@awc-ui/core/define';

const LOCALE = 'de-DE';
const money = (n) => n.toLocaleString(LOCALE, { style: 'currency', currency: 'EUR' });

// Content is yours to translate; the pagination chrome takes label props.
const T = {
  headline: 'Rechnungen',
  client: 'Kunde', amount: 'Betrag', status: 'Status',
  rowsPerPage: 'Zeilen pro Seite:',
  displayedRows: '%from%–%to% von %count%',
};

const INVOICES = [
  { id: 'l1', client: 'Acme GmbH', amount: 1200, status: 'Bezahlt' },
  { id: 'l2', client: 'Globex AG', amount: 3120, status: 'Offen' },
  { id: 'l3', client: 'Initech KG', amount: 860, status: 'Bezahlt' },
  // … seven more …
];

let page = 0;
let perPage = 5;
$: pageRows = INVOICES.slice(page * perPage, (page + 1) * perPage);
</script>

<md-table-container variant="outlined">
<md-table column-template="2fr 1fr 1fr" label={T.headline}
          row-count={INVOICES.length} row-offset={page * perPage}>
  <md-table-head>
    <md-table-row rowgroup="head">
      <md-table-cell head scope="col">{T.client}</md-table-cell>
      <md-table-cell head scope="col" numeric>{T.amount}</md-table-cell>
      <md-table-cell head scope="col">{T.status}</md-table-cell>
    </md-table-row>
  </md-table-head>
  <md-table-body>
    {#each pageRows as row (row.id)}
      <md-table-row value={row.id}>
        <md-table-cell head scope="row">{row.client}</md-table-cell>
        <md-table-cell numeric>{money(row.amount)}</md-table-cell>
        <md-table-cell>{row.status}</md-table-cell>
      </md-table-row>
    {/each}
  </md-table-body>
</md-table>

<md-table-pagination
  slot="bottom"
  count={INVOICES.length}
  {page}
  rows-per-page={perPage}
  label-rows-per-page={T.rowsPerPage}
  label-displayed-rows={T.displayedRows}
  on:mdPageChange={(e) => (page = e.detail.page)}
  on:mdRowsPerPageChange={(e) => { perPage = e.detail.rowsPerPage; page = 0; }}
></md-table-pagination>
</md-table-container>

Density — dual-typed here: compact / standard / comfortable or the numeric rungs -1…-4, which locally override the inherited data-density (0 is the uncompacted default, not a rung — it inherits). Row heights are also settable directly via --md-table-row-height-*. See Density and the Density section above.

i18n — headers, cells and the empty state are your slotted content, so they come from your i18n layer; lang and dir are inherited from any ancestor. Localize every aria-label on the row checkboxes and expand toggles too, and prefer fr units over fixed px in column-template so longer translations still fit.

Theming

Custom property	Purpose	Default
--md-table-row-height-compact / -standard / -comfortable	Row heights per semantic density	36px / 52px / 60px, each shifted by the density rung (compact floors at 28px, comfortable at 40px)
--md-table-header-height	Header row height	56px, density-shifted, floored at 40px
--md-table-cell-padding-inline / -padding-block	Cell padding	16px / 8px at standard (12px / 4px compact, 20px / 8px comfortable)
--md-table-divider-color	Row rules (also toggled by no-dividers)	outline-variant
--md-table-stripe-color	Alternate rows when striped	on-surface at half the hover state-layer opacity
--md-table-head-bg / --md-table-head-color	Header band	surface-container / on-surface-variant
--md-table-foot-bg	Footer band	surface-container-low
--md-table-row-hover-color	Row hover state-layer colour, mixed at the M3 hover opacity (hoverable, on by default)	on-surface
--md-table-row-selected-bg / -selected-color	Selected rows	secondary-container / on-secondary-container
--md-table-min-width	Same floor as the min-width prop	max-content
--md-table-columns-template	Track template, as a custom property	derived from the column-template prop
--md-table-body-max-h	Body cap in frozen mode	none
--md-table-empty-min-height	Height reserved for the empty state	160px

Custom properties — header, hover and divider colours Open in Storybook

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" style="--md-table-head-bg: var(--md-sys-color-primary-container); --md-table-head-color: var(--md-sys-color-on-primary-container); --md-table-row-hover-color: var(--md-sys-color-primary); --md-table-stripe-color: var(--md-sys-color-surface-container-high); --md-table-divider-color: var(--md-sys-color-primary);">
  <md-table column-template="2fr 1fr 1fr" label="Custom properties">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined" style={{ '--md-table-head-bg': 'var(--md-sys-color-primary-container)', '--md-table-head-color': 'var(--md-sys-color-on-primary-container)', '--md-table-row-hover-color': 'var(--md-sys-color-primary)', '--md-table-stripe-color': 'var(--md-sys-color-surface-container-high)', '--md-table-divider-color': 'var(--md-sys-color-primary)' }}>
        <MdTable columnTemplate="2fr 1fr 1fr" label="Custom properties">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="r1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
            <MdTableRow value="r2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined" style="--md-table-head-bg: var(--md-sys-color-primary-container); --md-table-head-color: var(--md-sys-color-on-primary-container); --md-table-row-hover-color: var(--md-sys-color-primary); --md-table-stripe-color: var(--md-sys-color-surface-container-high); --md-table-divider-color: var(--md-sys-color-primary);">
  <md-table column-template="2fr 1fr 1fr" label="Custom properties">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined" style="--md-table-head-bg: var(--md-sys-color-primary-container); --md-table-head-color: var(--md-sys-color-on-primary-container); --md-table-row-hover-color: var(--md-sys-color-primary); --md-table-stripe-color: var(--md-sys-color-surface-container-high); --md-table-divider-color: var(--md-sys-color-primary);">
    <md-table column-template="2fr 1fr 1fr" label="Custom properties">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" style="--md-table-head-bg: var(--md-sys-color-primary-container); --md-table-head-color: var(--md-sys-color-on-primary-container); --md-table-row-hover-color: var(--md-sys-color-primary); --md-table-stripe-color: var(--md-sys-color-surface-container-high); --md-table-divider-color: var(--md-sys-color-primary);">
  <md-table column-template="2fr 1fr 1fr" label="Custom properties">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="r1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="r2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

A narrow column — fr units and ellipsis cells Open in Storybook

Client Amount A client with a very long name$1,200.00 Globex International Holdings$3,120.00

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<div style="inline-size: 100%; max-inline-size: 320px;">
  <md-table-container variant="outlined">
    <md-table column-template="1fr auto" label="In a narrow column">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="n1"><md-table-cell head scope="row" ellipsis>A client with a very long name</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
        <md-table-row value="n2"><md-table-cell head scope="row" ellipsis>Globex International Holdings</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <div style={{ inlineSize: '100%', maxInlineSize: '320px' }}>
        <MdTableContainer variant="outlined">
          <MdTable columnTemplate="1fr auto" label="In a narrow column">
            <MdTableHead>
              <MdTableRow rowgroup="head">
                <MdTableCell head scope="col">Client</MdTableCell>
                <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              </MdTableRow>
            </MdTableHead>
            <MdTableBody>
              <MdTableRow value="n1"><MdTableCell head scope="row" ellipsis>A client with a very long name</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell></MdTableRow>
              <MdTableRow value="n2"><MdTableCell head scope="row" ellipsis>Globex International Holdings</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell></MdTableRow>
            </MdTableBody>
          </MdTable>
        </MdTableContainer>
      </div>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<div style="inline-size: 100%; max-inline-size: 320px;">
  <md-table-container variant="outlined">
    <md-table column-template="1fr auto" label="In a narrow column">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="n1"><md-table-cell head scope="row" ellipsis>A client with a very long name</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
        <md-table-row value="n2"><md-table-cell head scope="row" ellipsis>Globex International Holdings</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <div style="inline-size: 100%; max-inline-size: 320px;">
    <md-table-container variant="outlined">
      <md-table column-template="1fr auto" label="In a narrow column">
        <md-table-head>
          <md-table-row rowgroup="head">
            <md-table-cell head scope="col">Client</md-table-cell>
            <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          </md-table-row>
        </md-table-head>
        <md-table-body>
          <md-table-row value="n1"><md-table-cell head scope="row" ellipsis>A client with a very long name</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
          <md-table-row value="n2"><md-table-cell head scope="row" ellipsis>Globex International Holdings</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
        </md-table-body>
      </md-table>
    </md-table-container>
  </div>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<div style="inline-size: 100%; max-inline-size: 320px;">
  <md-table-container variant="outlined">
    <md-table column-template="1fr auto" label="In a narrow column">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="n1"><md-table-cell head scope="row" ellipsis>A client with a very long name</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell></md-table-row>
        <md-table-row value="n2"><md-table-cell head scope="row" ellipsis>Globex International Holdings</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</div>

Two more theme treatments in Storybook: vibrant and dark theme. The responsive story steps a table through the breakpoints, and custom CSS collects the property overrides in one place.

CSS parts reach inside the shadow root for what custom properties don’t cover — grid, header-grid, caption, empty, skeleton-row, loading, progress, hscrollbar, hscrollbar-thumb, vscrollbar, vscrollbar-thumb. header-grid and the two scrollbar pairs exist only in frozen-header mode (that’s the layout that splits the header off and draws its own scrollbars), and caption only renders when caption is set:

CSS parts — a styled caption, a header-grid rule and a tinted scroll thumb

Client Amount Status Acme Corp$1,200.00Paid Globex$3,120.00Pending Initech$860.00Paid Umbrella$2,450.00Draft Soylent$1,975.00Paid Hooli$4,300.00Pending

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<style>
  .parted::part(caption) {
  color: var(--md-sys-color-primary);
  font-weight: 600;
  letter-spacing: .06em;
  text-transform: uppercase;
  }
  .parted::part(header-grid) { box-shadow: 0 2px 0 var(--md-sys-color-primary); }
  .parted::part(grid) { background: var(--md-sys-color-surface-container-lowest); }
  .parted::part(vscrollbar-thumb) { background: var(--md-sys-color-primary); }
</style>
<md-table-container variant="outlined" max-height="240px">
  <md-table class="parted" frozen-header caption="Q3 invoices" column-template="2fr 1fr 1fr" label="Themed with CSS parts">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="c1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="c3"><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c4"><md-table-cell head scope="row">Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
      <md-table-row value="c5"><md-table-cell head scope="row">Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c6"><md-table-cell head scope="row">Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableHead, MdTableRow } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <style>
        .parted::part(caption) {
        color: var(--md-sys-color-primary);
        font-weight: 600;
        letter-spacing: .06em;
        text-transform: uppercase;
        }
        .parted::part(header-grid) { box-shadow: 0 2px 0 var(--md-sys-color-primary); }
        .parted::part(grid) { background: var(--md-sys-color-surface-container-lowest); }
        .parted::part(vscrollbar-thumb) { background: var(--md-sys-color-primary); }
      </style>
      <MdTableContainer variant="outlined" maxHeight="240px">
        <MdTable className="parted" frozenHeader caption="Q3 invoices" columnTemplate="2fr 1fr 1fr" label="Themed with CSS parts">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="c1"><MdTableCell head scope="row">Acme Corp</MdTableCell><MdTableCell numeric>$1,200.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
            <MdTableRow value="c2"><MdTableCell head scope="row">Globex</MdTableCell><MdTableCell numeric>$3,120.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
            <MdTableRow value="c3"><MdTableCell head scope="row">Initech</MdTableCell><MdTableCell numeric>$860.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
            <MdTableRow value="c4"><MdTableCell head scope="row">Umbrella</MdTableCell><MdTableCell numeric>$2,450.00</MdTableCell><MdTableCell>Draft</MdTableCell></MdTableRow>
            <MdTableRow value="c5"><MdTableCell head scope="row">Soylent</MdTableCell><MdTableCell numeric>$1,975.00</MdTableCell><MdTableCell>Paid</MdTableCell></MdTableRow>
            <MdTableRow value="c6"><MdTableCell head scope="row">Hooli</MdTableCell><MdTableCell numeric>$4,300.00</MdTableCell><MdTableCell>Pending</MdTableCell></MdTableRow>
          </MdTableBody>
        </MdTable>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<style>
  .parted::part(caption) {
  color: var(--md-sys-color-primary);
  font-weight: 600;
  letter-spacing: .06em;
  text-transform: uppercase;
  }
  .parted::part(header-grid) { box-shadow: 0 2px 0 var(--md-sys-color-primary); }
  .parted::part(grid) { background: var(--md-sys-color-surface-container-lowest); }
  .parted::part(vscrollbar-thumb) { background: var(--md-sys-color-primary); }
</style>
<md-table-container variant="outlined" max-height="240px">
  <md-table class="parted" frozen-header caption="Q3 invoices" column-template="2fr 1fr 1fr" label="Themed with CSS parts">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="c1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="c3"><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c4"><md-table-cell head scope="row">Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
      <md-table-row value="c5"><md-table-cell head scope="row">Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c6"><md-table-cell head scope="row">Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <style>
    .parted::part(caption) {
    color: var(--md-sys-color-primary);
    font-weight: 600;
    letter-spacing: .06em;
    text-transform: uppercase;
    }
    .parted::part(header-grid) { box-shadow: 0 2px 0 var(--md-sys-color-primary); }
    .parted::part(grid) { background: var(--md-sys-color-surface-container-lowest); }
    .parted::part(vscrollbar-thumb) { background: var(--md-sys-color-primary); }
  </style>
  <md-table-container variant="outlined" max-height="240px">
    <md-table class="parted" frozen-header caption="Q3 invoices" column-template="2fr 1fr 1fr" label="Themed with CSS parts">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="c1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="c2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
        <md-table-row value="c3"><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="c4"><md-table-cell head scope="row">Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
        <md-table-row value="c5"><md-table-cell head scope="row">Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
        <md-table-row value="c6"><md-table-cell head scope="row">Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      </md-table-body>
    </md-table>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<style>
  .parted::part(caption) {
  color: var(--md-sys-color-primary);
  font-weight: 600;
  letter-spacing: .06em;
  text-transform: uppercase;
  }
  .parted::part(header-grid) { box-shadow: 0 2px 0 var(--md-sys-color-primary); }
  .parted::part(grid) { background: var(--md-sys-color-surface-container-lowest); }
  .parted::part(vscrollbar-thumb) { background: var(--md-sys-color-primary); }
</style>
<md-table-container variant="outlined" max-height="240px">
  <md-table class="parted" frozen-header caption="Q3 invoices" column-template="2fr 1fr 1fr" label="Themed with CSS parts">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="c1"><md-table-cell head scope="row">Acme Corp</md-table-cell><md-table-cell numeric>$1,200.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c2"><md-table-cell head scope="row">Globex</md-table-cell><md-table-cell numeric>$3,120.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
      <md-table-row value="c3"><md-table-cell head scope="row">Initech</md-table-cell><md-table-cell numeric>$860.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c4"><md-table-cell head scope="row">Umbrella</md-table-cell><md-table-cell numeric>$2,450.00</md-table-cell><md-table-cell>Draft</md-table-cell></md-table-row>
      <md-table-row value="c5"><md-table-cell head scope="row">Soylent</md-table-cell><md-table-cell numeric>$1,975.00</md-table-cell><md-table-cell>Paid</md-table-cell></md-table-row>
      <md-table-row value="c6"><md-table-cell head scope="row">Hooli</md-table-cell><md-table-cell numeric>$4,300.00</md-table-cell><md-table-cell>Pending</md-table-cell></md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

md-table::part(header-grid) {
  box-shadow: 0 1px 0 var(--md-sys-color-outline-variant);
}

The sub-components

A table is composed from ten elements. Each one is documented here rather than on its own page: none of them mean anything outside a table, and the parent writes several of their attributes for you.

Here they are together — the container’s top and bottom bands holding a toolbar and a pagination bar outside the scroll region, head / body / foot rowgroups, and a row’s expanded slot opening a detail panel underneath it:

The sub-components together — top/bottom bands, three rowgroups, and an expanded row

Client Amount Status Acme Corp $1,200.00 Paid

Three line items · paid by card ending 4242 on 4 May.

Globex $3,120.00 Pending

Awaiting PO approval — chased 2 days ago.

Initech $860.00 Paid Total $5,180.00

Show code for each technology

HTML React Angular Vue Svelte

Copy

<!-- index.html — register the AWC UI elements once -->
<script type="module">
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="300px">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Expand a row for its detail"></md-table-toolbar>
  <md-table column-template="auto 2fr 1fr 1fr" sticky-footer label="Sub-components together">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="s1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="s2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
      <md-table-row value="s3">
        <md-table-cell padding="checkbox"></md-table-cell>
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$860.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
    </md-table-body>
    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell padding="checkbox"></md-table-cell>
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$5,180.00</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>
  <md-table-pagination slot="bottom" count="3" page="0" rows-per-page="5"></md-table-pagination>
</md-table-container>

Copy

import { MdTable, MdTableBody, MdTableCell, MdTableContainer, MdTableExpandToggle, MdTableFoot, MdTableHead, MdTablePagination, MdTableRow, MdTableToolbar } from '@awc-ui/react';

export function Demo() {
  return (
    <>
      <MdTableContainer variant="outlined" maxHeight="300px">
        <MdTableToolbar slot="top" headline="Invoices" supportingText="Expand a row for its detail"></MdTableToolbar>
        <MdTable columnTemplate="auto 2fr 1fr 1fr" stickyFooter label="Sub-components together">
          <MdTableHead>
            <MdTableRow rowgroup="head">
              <MdTableCell head padding="checkbox"></MdTableCell>
              <MdTableCell head scope="col">Client</MdTableCell>
              <MdTableCell head scope="col" numeric>Amount</MdTableCell>
              <MdTableCell head scope="col">Status</MdTableCell>
            </MdTableRow>
          </MdTableHead>
          <MdTableBody>
            <MdTableRow value="s1" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Acme Corp"></MdTableExpandToggle></MdTableCell>
              <MdTableCell head scope="row">Acme Corp</MdTableCell>
              <MdTableCell numeric>$1,200.00</MdTableCell>
              <MdTableCell>Paid</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Three line items · paid by card ending 4242 on 4 May.</div>
            </MdTableRow>
            <MdTableRow value="s2" expandable>
              <MdTableCell padding="checkbox"><MdTableExpandToggle buttonLabel="Expand details for Globex"></MdTableExpandToggle></MdTableCell>
              <MdTableCell head scope="row">Globex</MdTableCell>
              <MdTableCell numeric>$3,120.00</MdTableCell>
              <MdTableCell>Pending</MdTableCell>
              <div slot="expanded" style={{ padding: '12px 16px', color: 'var(--md-sys-color-on-surface-variant)' }}>Awaiting PO approval — chased 2 days ago.</div>
            </MdTableRow>
            <MdTableRow value="s3">
              <MdTableCell padding="checkbox"></MdTableCell>
              <MdTableCell head scope="row">Initech</MdTableCell>
              <MdTableCell numeric>$860.00</MdTableCell>
              <MdTableCell>Paid</MdTableCell>
            </MdTableRow>
          </MdTableBody>
          <MdTableFoot>
            <MdTableRow rowgroup="foot" selectable="false">
              <MdTableCell padding="checkbox"></MdTableCell>
              <MdTableCell head scope="row">Total</MdTableCell>
              <MdTableCell numeric>$5,180.00</MdTableCell>
              <MdTableCell></MdTableCell>
            </MdTableRow>
          </MdTableFoot>
        </MdTable>
        <MdTablePagination slot="bottom" count="3" page="0" rowsPerPage="5"></MdTablePagination>
      </MdTableContainer>
    </>
  );
}

Copy

// app.module.ts — register the AWC UI elements once
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AwcUiModule } from '@awc-ui/angular';

@NgModule({
  imports: [AwcUiModule],
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class AppModule {}

<!-- app.component.html -->
<md-table-container variant="outlined" max-height="300px">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Expand a row for its detail"></md-table-toolbar>
  <md-table column-template="auto 2fr 1fr 1fr" sticky-footer label="Sub-components together">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="s1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="s2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
      <md-table-row value="s3">
        <md-table-cell padding="checkbox"></md-table-cell>
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$860.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
    </md-table-body>
    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell padding="checkbox"></md-table-cell>
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$5,180.00</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>
  <md-table-pagination slot="bottom" count="3" page="0" rows-per-page="5"></md-table-pagination>
</md-table-container>

Copy

<script setup>
import '@awc-ui/core/define';
</script>

<template>
  <md-table-container variant="outlined" max-height="300px">
    <md-table-toolbar slot="top" headline="Invoices" supporting-text="Expand a row for its detail"></md-table-toolbar>
    <md-table column-template="auto 2fr 1fr 1fr" sticky-footer label="Sub-components together">
      <md-table-head>
        <md-table-row rowgroup="head">
          <md-table-cell head padding="checkbox"></md-table-cell>
          <md-table-cell head scope="col">Client</md-table-cell>
          <md-table-cell head scope="col" numeric>Amount</md-table-cell>
          <md-table-cell head scope="col">Status</md-table-cell>
        </md-table-row>
      </md-table-head>
      <md-table-body>
        <md-table-row value="s1" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
          <md-table-cell head scope="row">Acme Corp</md-table-cell>
          <md-table-cell numeric>$1,200.00</md-table-cell>
          <md-table-cell>Paid</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
        </md-table-row>
        <md-table-row value="s2" expandable>
          <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
          <md-table-cell head scope="row">Globex</md-table-cell>
          <md-table-cell numeric>$3,120.00</md-table-cell>
          <md-table-cell>Pending</md-table-cell>
          <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
        </md-table-row>
        <md-table-row value="s3">
          <md-table-cell padding="checkbox"></md-table-cell>
          <md-table-cell head scope="row">Initech</md-table-cell>
          <md-table-cell numeric>$860.00</md-table-cell>
          <md-table-cell>Paid</md-table-cell>
        </md-table-row>
      </md-table-body>
      <md-table-foot>
        <md-table-row rowgroup="foot" selectable="false">
          <md-table-cell padding="checkbox"></md-table-cell>
          <md-table-cell head scope="row">Total</md-table-cell>
          <md-table-cell numeric>$5,180.00</md-table-cell>
          <md-table-cell></md-table-cell>
        </md-table-row>
      </md-table-foot>
    </md-table>
    <md-table-pagination slot="bottom" count="3" page="0" rows-per-page="5"></md-table-pagination>
  </md-table-container>
</template>

Copy

<script>
  import '@awc-ui/core/define';
</script>

<md-table-container variant="outlined" max-height="300px">
  <md-table-toolbar slot="top" headline="Invoices" supporting-text="Expand a row for its detail"></md-table-toolbar>
  <md-table column-template="auto 2fr 1fr 1fr" sticky-footer label="Sub-components together">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"></md-table-cell>
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="s1" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Acme Corp"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Three line items · paid by card ending 4242 on 4 May.</div>
      </md-table-row>
      <md-table-row value="s2" expandable>
        <md-table-cell padding="checkbox"><md-table-expand-toggle button-label="Expand details for Globex"></md-table-expand-toggle></md-table-cell>
        <md-table-cell head scope="row">Globex</md-table-cell>
        <md-table-cell numeric>$3,120.00</md-table-cell>
        <md-table-cell>Pending</md-table-cell>
        <div slot="expanded" style="padding: 12px 16px; color: var(--md-sys-color-on-surface-variant);">Awaiting PO approval — chased 2 days ago.</div>
      </md-table-row>
      <md-table-row value="s3">
        <md-table-cell padding="checkbox"></md-table-cell>
        <md-table-cell head scope="row">Initech</md-table-cell>
        <md-table-cell numeric>$860.00</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
    </md-table-body>
    <md-table-foot>
      <md-table-row rowgroup="foot" selectable="false">
        <md-table-cell padding="checkbox"></md-table-cell>
        <md-table-cell head scope="row">Total</md-table-cell>
        <md-table-cell numeric>$5,180.00</md-table-cell>
        <md-table-cell></md-table-cell>
      </md-table-row>
    </md-table-foot>
  </md-table>
  <md-table-pagination slot="bottom" count="3" page="0" rows-per-page="5"></md-table-pagination>
</md-table-container>

md-table-container

The surface around a md-table. It provides elevation, shape, the scroll region, and the top / bottom bands where the toolbar and pagination live.

• top and bottom sit OUTSIDE the scroll region. That is exactly why the toolbar and pagination belong there — they stay put while the rows scroll. Put them in the default slot and they scroll away with the table.
• max-height is what makes the scroll region finite, and therefore what makes sticky-header / frozen-header on md-table work at all. Without it the container grows and the page scrolls instead — nothing to stick within. min-height is the opposite lever: keep an empty state visible.
• No density prop. Density belongs on md-table — and there it is dual-typed (words or numbers).
• Sticky behaviour itself is never configured here: sticky-header, frozen-header and sticky-footer are all md-table props.
• variant defaults to elevated. elevation (0–5) overrides the shadow level implied by the variant — leave it unset unless you need a specific step.
• vibrant tints the whole table with primary / tertiary container tones and cascades into the contained md-table via custom properties.

tune

Properties

Property	Attribute	Type	Default	Reflects
variant	variant	'elevated' | 'outlined' | 'filled' | 'flat'	'elevated'	Yes
shape	shape	'extra-large' | 'large' | 'medium' | 'small' | 'none'	'large'	Yes
maxHeight	max-height	string	''	—
minHeight	min-height	string	''	—
vibrant	vibrant	boolean	false	Yes
elevation	elevation	0 | 1 | 2 | 3 | 4 | 5	—	Yes

view_in_ar

Slots

Slot	Description
(default)	—
top	—
bottom	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-container-color	Surface background
--md-table-container-shape	Border-radius
--md-table-container-elevation	Box-shadow
--md-table-container-outline-color	Outline color (variant=outlined)
--md-table-container-outline-width	Outline width (variant=outlined)

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
top	Wrapper around `slot[name="top"]` (toolbar etc.)
scroll	The scroll viewport that contains the table
bottom	Wrapper around `slot[name="bottom"]` (pagination etc.)

md-table-head

The column-header rowgroup — <thead> for md-table. Purely presentational: it marks the region, applies the head background, and lets its rows flow into the table’s grid.

• It renders with display: contents, so its rows land directly on the table’s grid tracks. It is not a box — you cannot pad it, border it, give it a height, or scroll it. Style the cells instead.
• You still set rowgroup="head" on each row, and head + scope="col" on each cell. The wrapper does not cascade anything to its descendants.
• Sticky behaviour comes from md-table, not from here: use its sticky-header (pinned inside the scroll region) or frozen-header (lifted out of it), paired with max-height on md-table-container. Never set position: sticky on this element.
• Internally it relays a slotchange as a bubbling event so md-table notices row reorders (slotchange isn’t composed). That’s plumbing — don’t listen to it.

view_in_ar

Slots

Slot	Description
(default)	—

md-table-body

The data rowgroup — <tbody> for md-table. Purely presentational; its rows flow into the table’s grid.

• It renders with display: contents, so rows land on the table’s tracks. It is not a box: don’t size it, pad it, border it or give it overflow: auto. Scrolling belongs to md-table-container via its max-height.
• Rows still carry their own rowgroup. rowgroup="body" is the default on md-table-row; the wrapper doesn’t stamp it, and it certainly doesn’t make cells into headers.
• Several md-table-body elements in one table are allowed — useful for visually grouped sections — but each is announced as a rowgroup unless you set presentational.
• presentational drops the rowgroup role. Use it only when the grouping is decorative; leave it off for the normal single-body case.
• Sticky headers and footers are md-table props (sticky-header, frozen-header, sticky-footer) — never something you configure here.

tune

Properties

Property	Attribute	Type	Default	Reflects
presentational	presentational	boolean	false	Yes

view_in_ar

Slots

Slot	Description
(default)	—

md-table-foot

The summary rowgroup — <tfoot> for md-table. Where totals and aggregate rows live. Purely presentational; its rows flow into the table’s grid.

• It renders with display: contents, so the rows land on the table’s tracks. It is not a box — no padding, borders, height or scrolling on this element. Style the cells.
• Set rowgroup="foot" on its rows. The wrapper doesn’t stamp it, and body rows in the foot get the wrong styling and the wrong semantics.
• Set selectable="false" on totals rows, so selectAll() on md-table doesn’t sweep the summary row up with the data.
• Sticky behaviour comes from md-table’s sticky-footer, not from here — paired with max-height on md-table-container. Never set position: sticky on this element.
• presentational drops the rowgroup role for a purely decorative grouping; leave it off for a real summary group.

tune

Properties

Property	Attribute	Type	Default	Reflects
presentational	presentational	boolean	false	Yes

view_in_ar

Slots

Slot	Description
(default)	—

md-table-row

One row of a md-table. A real grid box that spans the table’s tracks and lays out its md-table-cell children, with selection, click and expansion state.

• value is the row’s identity in the table’s selection state. A body row without a value cannot be tracked by md-table’s getSelection().
• selectable defaults to true, not false. Aggregate and totals rows must set selectable="false" or selectAll() picks them up as data.
• rowgroup must match the wrapping group — rowgroup="head" inside md-table-head, "foot" inside md-table-foot. The default is body, so a header row left untouched gets body styling and semantics.
• The row is a real grid box spanning the table’s tracks, unlike the rowgroups, which are display: contents. Only cells and the expanded slot belong in it — a wrapper <div> around the cells breaks the layout.
• clickable and selection are independent: a row can be clickable without being selectable, and vice versa. Set each explicitly.
• Detail content goes in the expanded slot, not in a second injected row.

tune

Properties

Property	Attribute	Type	Default	Reflects
rowgroup	rowgroup	'head' | 'body' | 'foot'	'body'	Yes
selected	selected	boolean	false	Yes
disabled	disabled	boolean	false	Yes
selectable	selectable	boolean	true	—
clickable	clickable	boolean	false	Yes
value	value	string	''	—
expandable	expandable	boolean	false	Yes
expanded	expanded	boolean	false	Yes
highlight	highlight	boolean	false	Yes

function

Methods

Method	Parameters
toggle()	none

view_in_ar

Slots

Slot	Description
(default)	—
expanded	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-row-hover-color	—

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
expanded	—

md-table-cell

One cell of a md-table. Renders as a data cell, a column header or a row header depending on head and scope, with alignment, spanning, sticky pinning and truncation options.

• head and scope together are what make a header. head alone only styles the cell; scope is what associates it with its column or row for assistive tech. Set both — scope="col" on column headers, scope="row" on the identifying first column.
• numeric is not just alignment — it applies tabular figures so digits line up across rows. Use it on every numeric column.
• A sticky cell needs an opaque background or the scrolling rows bleed through it. That’s --md-table-cell-sticky-bg. The table’s pin-mode and pinColumn() coordinate multi-column pinning.
• colspan / rowspan use the HTML attribute casing — colspan="2", not col-span="2" (the properties are colSpan / rowSpan).
• ellipsis truncates instead of wrapping, so the full text must be reachable another way — a md-tooltip or the row’s expanded slot. Truncation on its own loses information.
• padding="checkbox" is the tightened padding for a selection column; padding="none" is for edge-to-edge content like an image.
• variant="meta" is the built-in secondary/meta text style — don’t shrink text with custom CSS.

tune

Properties

Property	Attribute	Type	Default	Reflects
align	align	'start' | 'center' | 'end' | 'justify'	'start'	Yes
numeric	numeric	boolean	false	Yes
padding	padding	'default' | 'none' | 'checkbox'	'default'	Yes
head	head	boolean	false	Yes
scope	scope	'col' | 'row' | 'colgroup' | 'rowgroup' | ''	''	Yes
sticky	sticky	'start' | 'end' | ''	''	Yes
colSpan	colspan	number	1	—
rowSpan	rowspan	number	1	—
ellipsis	ellipsis	boolean	false	Yes
variant	variant	'body' | 'meta'	'body'	Yes
noPinIndicator	no-pin-indicator	boolean	false	Yes
pinIcon	pin-icon	string	''	—
density	density	0 | -1 | -2 | -3 | -4	0	Yes

view_in_ar

Slots

Slot	Description
(default)	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-cell-color	Foreground (text) color
--md-table-cell-background	Background color
--md-table-cell-padding-inline	Horizontal padding
--md-table-cell-min-height	Minimum cell height
--md-table-cell-sticky-bg	Opaque bg for sticky columns
--md-table-cell-padding-block	—
--md-table-cell-pin-display	—
--md-table-cell-pin-color	—
--md-table-cell-pin-size	—
--md-table-cell-sticky-transition	—

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
pin	—
content	—

md-table-toolbar

The band above a md-table. Title and supporting text in the resting state; a selection count and bulk actions when rows are selected.

• num-selected > 0 switches the toolbar into selection mode: the headline is replaced by the selection caption, and selection-actions replace actions. A stale count leaves it stuck in (or out of) selection mode.
• auto-bind makes the toolbar find the sibling table and track its selection itself — no listener needed. It only works when the toolbar and the table are inside the same md-table-container.
• label-selected uses the %count% token, not {count}. This is a different token style from the rest of the library — md-transfer-list and md-time-picker use braces. Keep %count% when translating.
• Bulk actions belong in selection-actions; putting them in actions shows them when nothing is selected.
• The toolbar is not the table’s accessible name. Set label or caption on md-table as well — the headline is visual only.
• compact is the built-in tighter band; don’t shrink it with custom CSS.

tune

Properties

Property	Attribute	Type	Default	Reflects
headline	headline	string	''	—
supportingText	supporting-text	string	''	—
numSelected	num-selected	number	0	Yes
autoBind	auto-bind	boolean	false	—
labelSelected	label-selected	string	'%count% selected'	—
compact	compact	boolean	false	Yes
density	density	0 | -1 | -2 | -3 | -4	0	Yes

view_in_ar

Slots

Slot	Description
leading	—
headline	—
supporting-text	—
title-area	—
selection-actions	—
actions	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-toolbar-color	Foreground color
--md-table-toolbar-bg	Background color (default mode)
--md-table-toolbar-selection-bg	Background color (selection mode)
--md-table-toolbar-selection-color	Foreground color (selection mode)
--md-table-toolbar-padding-block	Top/bottom padding
--md-table-toolbar-padding-inline	Left/right padding
--md-table-toolbar-min-height	Minimum height (default: 64px)

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
leading	Container for the `leading` slot
main	Container for headline / supporting text
selection-caption	"%count% selected" caption (selection mode)
headline	<h2> element
supporting-text	<p> element
actions	—

md-table-pagination

The page controls under a md-table. A rows-per-page selector, a “1–10 of 120” readout, and previous/next (optionally first/last) navigation.

• page is zero-based. “Page 1” in the readout is page="0". Treating it as one-based puts an off-by-one in every fetch.
• It does not slice your data. It reports intent through mdPageChange and mdRowsPerPageChange; you re-render the rows and update page, count and rows-per-page yourself.
• rows-per-page-options is a comma-separated string, not an array — rows-per-page-options="10,25,50", never el.rowsPerPageOptions = [10, 25, 50]. It is parsed with .split(','), so it is string-only in both the attribute and the property form — unlike md-color-picker’s presets, which is typed string | string[] and does accept an array via the property. "all" is a legal entry and maps to the full count.
• label-displayed-rows uses %from%, %to% and %count% — percent tokens, matching md-table-toolbar and unlike the {…} tokens used by md-transfer-list and md-time-picker. Keep all three when translating.
• Changing rows-per-page usually should reset page to 0 — that’s your call, not the component’s, or the user can land on page 12 of 3.
• Use disabled while a page is loading so users can’t queue conflicting page changes.

tune

Properties

Property	Attribute	Type	Default	Reflects
count	count	number	0	—
page	page	number	0	Yes
rowsPerPage	rows-per-page	number	10	Yes
rowsPerPageOptions	rows-per-page-options	string	'5,10,25,50'	—
showFirstLast	show-first-last	boolean	false	Yes
labelDisplayedRows	label-displayed-rows	string	'%from%–%to% of %count%'	—
labelRowsPerPage	label-rows-per-page	string	'Rows per page:'	—
labelFirstPage	label-first-page	string	'First page'	—
labelPreviousPage	label-previous-page	string	'Previous page'	—
labelNextPage	label-next-page	string	'Next page'	—
labelLastPage	label-last-page	string	'Last page'	—
labelAll	label-all	string	'All'	—
compact	compact	boolean	false	Yes
disabled	disabled	boolean	false	Yes
density	density	0 | -1 | -2 | -3 | -4	0	Yes

function

Methods

Method	Parameters
goToPage()	page: number
setRowsPerPage()	rpp: number

view_in_ar

Slots

Slot	Description
actions	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-pagination-color	Foreground color
--md-table-pagination-bg	Background color
--md-table-pagination-padding-block	Top/bottom padding
--md-table-pagination-padding-inline	Left/right padding
--md-table-pagination-select-width	Rows-per-page select width (default 72px)

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
display	The "from–to of count" label
rpp	Rows-per-page region
rpp-select	The md-select picker
nav	Navigation buttons region
first-button	—
prev-button	—
next-button	—
last-button	—

md-table-sort-label

The sortable-column affordance for md-table. It goes inside a header cell, shows the sort direction, and emits a request to sort — it does not sort anything itself.

• It requests, it doesn’t sort. mdSortRequest tells you which column was clicked and its defaultOrder; you decide the next order, re-sort your rows, and reflect the result.
• active and order are display state you own. Nothing updates them automatically — leave them stale and the arrow lies about the current sort.
• Exactly one label may be active at a time. Two active indicators make the sort state ambiguous.
• default-order is the direction used on the first click of this column; desc is usually right for dates and amounts.
• column is the key echoed back in the event — keep it matching your data field and untranslated. Never use the label text as the key.
• Call md-table’s animateNextChange() before re-rendering or you lose the reorder animation.
• disabled keeps the header readable while removing the affordance.

tune

Properties

Property	Attribute	Type	Default	Reflects
column	column	string	''	—
disabled	disabled	boolean	false	Yes
defaultOrder	default-order	'asc' | 'desc'	'asc'	—
iconPosition	icon-position	'start' | 'end'	'end'	Yes
icon	icon	string	''	—
inactiveIcon	inactive-icon	'always' | 'hover'	'always'	Yes
active	active	boolean	false	Yes
order	order	'asc' | 'desc' | 'none'	'none'	Yes
density	density	0 | -1 | -2 | -3 | -4	0	Yes

view_in_ar

Slots

Slot	Description
(default)	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-sort-label-color	Inactive color
--md-table-sort-label-active-color	Active color
--md-table-sort-label-icon-size	Icon size (default 18px)
--md-table-sort-label-gap	Gap between text and icon
--md-table-sort-label-rest-opacity	—

layers

CSS Shadow Parts

Style internal elements through shadow DOM with ::part():

Part	Description
icon	The arrow indicator
label	The text label

md-table-expand-toggle

The chevron that expands a md-table row. A tiny wrapper around md-icon-button that rotates with the row’s expanded state.

• It holds no state. The parent md-table-row’s expanded drives the rotation, and the row is what emits mdRowExpandedChange. Never try to read expanded state off the toggle.
• button-label defaults to the English "Expand row" and is the toggle’s only accessible name. In a table of twenty rows it is also ambiguous — make it row-specific (“Expand invoice for Acme”).
• The glyph rotates rather than swapping, so use a directional icon. The default is chevron_right; a symmetric glyph like add looks broken when rotated.
• It has no density prop — it follows the cell it sits in.
• Give its cell padding="checkbox" so a small control isn’t ringed by full cell padding.

tune

Properties

Property	Attribute	Type	Default	Reflects
buttonLabel	button-label	string	'Expand row'	—
icon	icon	string	'chevron_right'	—

palette

CSS Custom Properties

Override on the host element for per-instance theming:

Property	Description
--md-table-expand-toggle-rotation	Expanded rotation (default 90deg)

Related

md-table-container · md-table-head · md-table-body · md-table-foot · md-table-row · md-table-cell · md-table-toolbar · md-table-pagination · md-table-sort-label · md-table-expand-toggle · md-list

AI / LLM Context

For AI Agents — md-table

Two artefacts to give your AI agent so it generates correct UI with this component. The per-component spec answers "how do I use this exact tag?". The main-llm spec answers "which tag should I pick in the first place?".

Per-component

md-table spec card

Identity · when to use / when NOT · decision cues · behavioural contract · do/don't · anti-patterns · full API. Paste into your agent when you're implementing with this component.

Copy specExpand view

Main-LLM spec

AWC UI Operator's Manual

System-prompt preamble · decision matrix · token reference · page recipes · anti-patterns. Paste into the system prompt at the start of a piece of work.

Open specExpand view

md-table readme.md

Copy readme

# md-table

<!-- llm:meta
tag: md-table
category: data
status: custom
m3-guidelines: none — M3 has no data-table page
m3-derived-from: https://m3.material.io/components/lists/guidelines
form-associated: false
depends-on: md-progress-indicator
used-by: none
accepts-children: md-table-head, md-table-body, md-table-foot, md-table-row
-->

**The composable table primitive.** You author every row; the table owns the
CSS-Grid layout, sticky and frozen headers, column pinning and visibility,
sort and selection state, striping, expressive reorder motion, and the loading
and empty states.

> ⚠️ **Not a Material Design 3 component.** M3 has no data-table page, so the
> Do / Don't below is house rules derived from the M3 list guidance and the WAI
> table patterns.

> ⚠️ **Two table families exist in this library and they are separate
> implementations with separate CSS.** `md-table` is **hand-authored** — you
> write every row, and it never fetches, sorts or filters your data.

> Setup, theming, density and i18n are configured once for the whole library —
> see [`main-llm.md`](../../../../../main-llm.md) at the repo root.

---

## When to use

- A table whose rows you **compose by hand**: mixed content, embedded controls,
  bespoke cells, server-rendered markup.
- You need frozen headers, pinned columns, or column show/hide.
- You want selection, sorting affordances and reorder motion while keeping the
  data pipeline entirely yours.

## When NOT to use

| Situation | Use instead |
|---|---|
| A vertical list of records | `md-list` |
| Rich, self-contained items | `md-card` collection |
| Hierarchy / reporting lines | `md-organization-chart` |
| Comparing two values | Plain text |
| Layout (the old `<table>` misuse) | CSS Grid |

## Decision cues

| Need | Setting |
|---|---|
| Explicit column widths | `column-template` (a CSS `grid-template-columns` value) |
| Just a column count | `columns` (equal `1fr` tracks) |
| Header stays put inside the scroller | `sticky-header` + a bounded `md-table-container` |
| Header outside the scroll area, scrollbar on the body only | `frozen-header` |
| Column pinning or hiding | `column-template` (no `repeat()`) + `pinColumn()` / `setColumnVisibility()` |
| Several pinned columns all visible | `pin-mode="static"` |
| Zebra striping | `striped` |
| Row selection | `selection="single"` or `"multiple"` |
| Sorted state shown in the header | `sort-by` + `sort-order` (+ `md-table-sort-label`) |
| Loading | `loading` + `loading-mode="overlay"` or `"skeleton"` |
| Empty state | `empty` (+ the `empty` slot) |
| Row heights | `density="compact\|standard\|comfortable"`, or the numeric rungs `-1`…`-4` |
| Correct AT positions while paginating | `row-offset` + `row-count` |

## API contract

```html
<md-table-container max-height="60vh">
  <md-table
    column-template="2fr 1fr 1fr"          <!-- default: "" -->
    columns="0"                            <!-- default: 0 (derive from row 1) -->
    min-width="640px"                      <!-- default: "" -->
    density="compact|standard|comfortable" <!-- default: standard; also -1…-4 -->
    sticky-header                          <!-- default: false -->
    frozen-header                          <!-- default: false -->
    sticky-footer                          <!-- default: false -->
    keep-height="true"                     <!-- default: true -->
    scrollbar="overlay|gutter"             <!-- default: overlay (frozen mode) -->
    pin-mode="stack|static"                <!-- default: stack -->
    pin-icon=""                            <!-- default: "" (built-in push-pin) -->
    striped                                <!-- default: false -->
    no-dividers                            <!-- default: false -->
    hoverable                              <!-- default: true -->
    motion="expressive|none"               <!-- default: expressive -->
    selection="none|single|multiple"       <!-- default: none -->
    sort-by="name"                         <!-- default: "" -->
    sort-order="asc|desc|none"             <!-- default: asc -->
    loading                                <!-- default: false -->
    loading-mode="overlay|skeleton"        <!-- default: overlay -->
    loading-rows="4"                       <!-- default: 4 -->
    empty                                  <!-- default: false -->
    label="Invoices"                       <!-- default: "" -->
    caption=""                             <!-- default: "" -->
    summary=""                             <!-- default: "" -->
    row-offset="0"                         <!-- default: 0 -->
    row-count="0"                          <!-- default: 0 (use rendered count) -->
  >
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col">Client</md-table-cell>
        <md-table-cell head scope="col" numeric>Amount</md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="inv-1">
        <md-table-cell>Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200</md-table-cell>
        <md-table-cell>Paid</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>
```

**Events** (all bubble and cross shadow boundaries) —
`mdSortChange` `{ column, order }`,
`mdSelectionChange` `{ count, total, values, all, indeterminate }`,
`mdPinChange` `{ column, side }`,
`mdColumnVisibilityChange` `{ column, visible, hidden }`,
`mdScroll` `{ scrollLeft, scrollTop }` (frozen mode only, one per frame).

**Methods** (all async — `await` them) — `getSelection()`, `selectAll()`,
`deselectAll()`, `toggleSelectAll()`, `setSort(column, order)`,
`pinColumn(column, 'start' | 'end' | 'none')`,
`setColumnVisibility(column, visible)`, `animateNextChange()`.

**Slots** — the default slot takes the rowgroups (`md-table-head` /
`md-table-body` / `md-table-foot`) or bare rows; `empty` replaces the built-in
"No data" message; `loader` replaces the built-in progress line (`loading` is
the older alias for it). The `head` slot is **assigned by the table itself** in
`frozen-header` mode — never write `slot="head"` by hand.

**Parts** — `grid`, `header-grid`, `caption`, `empty`, `skeleton-row`,
`loading`, `progress`, `hscrollbar`, `hscrollbar-thumb`, `vscrollbar`,
`vscrollbar-thumb`.

### Behavioral contract worth knowing

- **The layout is CSS Grid, not a real `<table>`.** The shadow grid owns the
  tracks and every row is a real grid item that subgrids its cells onto them.
  The rowgroups are `display: contents`. Consequences: declare the tracks
  (`column-template` or `columns`, else they are derived from the first row's
  cell count), keep `md-table-cell` as the direct children of a row, and never
  wrap rows in your own element.
- **`md-table` sorts nothing and selects no data by itself.** `sort-by` /
  `sort-order` are display state, and `mdSortChange` is a *request* — you
  reorder the rows in the handler. Clicking an `md-table-sort-label` cycles that
  column: its `default-order`, then the opposite, then off (`sort-by` clears and
  `sort-order` resets to `asc`).
- **Selection checkboxes are auto-wired.** With `selection` set, an
  `md-checkbox` slotted into a body row toggles that row, and one slotted into
  `md-table-head` is the select-all. The table pushes the model back into
  those checkboxes (`checked`, `indeterminate`, `disabled`), so no wiring is
  needed — and adding your own handler is safe, because the table's side is
  declarative rather than a toggle.
- In `selection="single"` selecting a row deselects every other one, and the
  select-all checkbox is **disabled** — `selectAll()` is a no-op outside
  `selection="multiple"`. Head and foot rows never join the selection model.
- `mdSelectionChange` fires on user *and* programmatic selection changes, but
  **not** on first load; call `await table.getSelection()` for the initial
  snapshot.
- `sticky-header` keeps the header in the scroll region (bound the scroller with
  `md-table-container[max-height]`). **`frozen-header` is a different
  architecture**: the header gets its own grid outside the scroll area, the body
  becomes a focusable scroll region with custom always-visible scrollbars, and
  horizontal scroll is mirrored between the two. Size the frozen body with
  `md-table-container[max-height]` (it forwards the value) or the
  `--md-table-body-max-h` property. `mdScroll` and the `scrollbar` prop only
  apply in frozen mode.
- **`keep-height` is ON by default**: after the first render the table never
  shrinks below its initial height, so paging or filtering to fewer rows cannot
  make the page jump. Set `keep-height="false"` for a table that should resize.
- **`pinColumn()` and `setColumnVisibility()` have preconditions**: an explicit
  `column-template` **without `repeat()`**, no `colspan` cells, and every row
  carrying one cell per column. They warn to the console and no-op otherwise.
  Indexes are always the *original* column positions; the table re-sequences the
  cells, rewrites the host's `column-template` attribute, and keeps hidden cells
  in the DOM so their state survives. The last visible column cannot be hidden.
- `motion="expressive"` (the default) **already brackets sort and pagination**:
  the table FLIPs its rows around `mdSortChange`, and `md-table-container` arms
  it for a slotted `md-table-pagination`. Call `animateNextChange()` only for
  mutations of your own (filters, async refetch), immediately before the
  synchronous DOM change. `prefers-reduced-motion` always wins.
- `density` is **dual-typed** here: the semantic sizes `compact` / `standard` /
  `comfortable` (36 / 52 / 60px rows) *or* the numeric rungs `-1`…`-4` used by
  the rest of the library. `0` is accepted by the type but inert — it is the
  uncompacted default. The two combine: `density="compact"` inside a
  `data-density="-2"` region condenses further.
- `label`, `caption` and `summary` all feed accessibility: `aria-label` is
  `label` → `caption` → `"Data table"`, the caption is rendered visually but
  `aria-hidden` (so it is not announced twice), and `summary` becomes
  `aria-description`.
- The structural role **promotes from `table` to `treegrid`** as soon as any row
  carries `expandable`, because only a treegrid row may expose `aria-expanded`.
- The table stamps `rowgroup`, `data-stripe`, `data-sticky`, `data-last`,
  `data-adjacent-foot`, `aria-rowindex`, `aria-selected` and `aria-sort` onto
  your rows and cells on load and on every slot change. Don't write them
  yourself.
- `empty` swaps in the empty state and announces "No data" politely; `loading`
  sets `aria-busy`. `loading-mode="overlay"` dims the body under a progress
  line, `"skeleton"` replaces the body with `loading-rows` shimmer rows.

---

## Do / Don't

House rules, derived from
[M3 · Lists · Guidelines](https://m3.material.io/components/lists/guidelines)
and the WAI table patterns — M3 has no data-table page.

| ✅ Do | ❌ Don't |
|---|---|
| Declare `column-template` or `columns` | Don't rely on content to define the grid — only the first row's cell count is derived |
| Keep `md-table-row` / `md-table-cell` as the direct structure | Don't wrap rows in your own elements — `display: contents` depends on it |
| Give the table a `label` or `caption` | Don't ship an unnamed data grid |
| Use `md-table-cell head scope="col"` for headers | Don't style a body cell to look like a header |
| Reorder your own data in `mdSortChange` | Don't expect the table to sort |
| Use `numeric` on number cells | Don't left-align numbers |
| Use `frozen-header` or `sticky-header` for long tables | Don't make users scroll back for context |
| Use the `empty` slot for a real empty state | Don't render a zero-row table with no explanation |
| Set `row-offset` / `row-count` when paginating | Don't let AT announce "row 1 of 20" on page 5 |

---

## Patterns

```html
<!-- Sortable + selectable table with a toolbar and pagination -->
<md-table-container variant="outlined" max-height="60vh">
  <md-table-toolbar slot="top" headline="Invoices"></md-table-toolbar>

  <md-table id="invoices" column-template="auto 2fr 1fr 1fr" sticky-header striped
            selection="multiple" label="Invoices">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head padding="checkbox"><md-checkbox></md-checkbox></md-table-cell>
        <md-table-cell head scope="col">
          <md-table-sort-label column="name">Client</md-table-sort-label>
        </md-table-cell>
        <md-table-cell head scope="col" numeric>
          <md-table-sort-label column="amount" default-order="desc">Amount</md-table-sort-label>
        </md-table-cell>
        <md-table-cell head scope="col">Status</md-table-cell>
      </md-table-row>
    </md-table-head>

    <md-table-body id="invoice-rows">
      <md-table-row value="inv-1">
        <md-table-cell padding="checkbox"><md-checkbox></md-checkbox></md-table-cell>
        <md-table-cell>Acme Corp</md-table-cell>
        <md-table-cell numeric>$1,200</md-table-cell>
        <md-table-cell><md-chip label="Paid" color="success"></md-chip></md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>

  <md-table-pagination slot="bottom" count="120" rows-per-page="25"></md-table-pagination>
</md-table-container>

<script type="module">
  const table = document.getElementById('invoices');

  // The table already brackets the reorder with its FLIP motion — just
  // re-render the rows synchronously in the handler.
  table.addEventListener('mdSortChange', (e) => {
    renderRows(sortData(e.detail.column, e.detail.order));
  });

  table.addEventListener('mdSelectionChange', (e) => {
    console.log(e.detail.count, 'of', e.detail.total, e.detail.values);
  });

  // Initial snapshot: mdSelectionChange does not fire on load.
  console.log(await table.getSelection());
</script>
```

```html
<!-- Frozen header + pinned first column -->
<md-table-container max-height="420px">
  <md-table id="grid" frozen-header pin-mode="static"
            column-template="200px 120px 120px 120px" label="Metrics">
    <md-table-head>
      <md-table-row rowgroup="head">
        <md-table-cell head scope="col" sticky="start">Region</md-table-cell>
        <md-table-cell head scope="col" numeric>Q1</md-table-cell>
        <md-table-cell head scope="col" numeric>Q2</md-table-cell>
        <md-table-cell head scope="col" numeric>Q3</md-table-cell>
      </md-table-row>
    </md-table-head>
    <md-table-body>
      <md-table-row value="emea">
        <md-table-cell head scope="row" sticky="start">EMEA</md-table-cell>
        <md-table-cell numeric>120</md-table-cell>
        <md-table-cell numeric>135</md-table-cell>
        <md-table-cell numeric>141</md-table-cell>
      </md-table-row>
    </md-table-body>
  </md-table>
</md-table-container>

<script type="module">
  const grid = document.getElementById('grid');
  // Original 0-based column index; needs a repeat()-free column-template.
  await grid.pinColumn(1, 'end');
  await grid.setColumnVisibility(2, false);
</script>
```

```html
<!-- Loading and empty states -->
<md-table loading loading-mode="skeleton" loading-rows="6"
          column-template="2fr 1fr" label="Invoices"></md-table>

<md-table empty column-template="2fr 1fr" label="Invoices">
  <div slot="empty">No invoices yet.</div>
</md-table>

<md-table loading column-template="2fr 1fr" label="Invoices">
  <md-progress-indicator slot="loader" variant="circular" indeterminate
                         aria-label="Loading"></md-progress-indicator>
</md-table>
```

```html
<!-- Filtering your own rows, with the reorder animation -->
<script type="module">
  const table = document.getElementById('invoices');
  async function applyFilter(term) {
    await table.animateNextChange();   // arm BEFORE the mutation
    renderRows(data.filter((r) => r.client.includes(term)));
  }
</script>
```

## Anti-patterns

| ❌ Wrong | ✅ Right | Why |
|---|---|---|
| No `column-template` / `columns` on a table whose first row is not representative | Declare the tracks | Only the first row's cell count is derived. |
| Wrapping rows in a `<div>` for layout | Keep the rowgroup structure | `display: contents` and subgrid both break. |
| `column-template="repeat(4, 1fr)"` then `pinColumn()` | Write the four tracks out | Pinning refuses a template containing `repeat()`. |
| Calling `animateNextChange()` inside a `mdSortChange` handler | Just re-render | Sort and slotted pagination are bracketed automatically. |
| `table.getSelection()` used as a plain value | `await table.getSelection()` | Every `@Method` returns a Promise. |
| Waiting for `mdSelectionChange` to learn the initial state | `await table.getSelection()` | It does not fire on load. |
| `density="0"` expecting it to opt out of an inherited `data-density` | `style="--md-sys-density-scale: 0"` | Rung `0` is inert; only `-1`…`-4` have rules. |
| `sticky-header` with an unbounded container | `md-table-container[max-height]` | There is no finite scroll box to stick inside. |
| Writing `slot="head"` on `md-table-head` | Set `frozen-header` on the table | The table assigns and removes that slot itself. |
| Setting `aria-selected` / `data-stripe` on rows | Let the table stamp them | They are rewritten on every sync. |
| A table with no `label`/`caption` | Name it | Screen-reader users can't identify it. |
| Using a table for page layout | CSS Grid | Semantics. |

## Accessibility, RTL, density, i18n

**Accessibility**
- Because the layout is CSS Grid rather than a native `<table>`, ARIA carries the
  semantics: the inner structural element is `role="table"` (or `treegrid` once
  any row is `expandable`), the rowgroups are `rowgroup`, `md-table-row` is
  `row`, and `md-table-cell` is a cell or a column/row header via `head` +
  `scope`. **Get `scope` right** — it is what makes a cell announce with its
  column.
- `label`, `caption` and `summary` name and describe the grid; a caption alone
  is enough to name it.
- For a paginated table set `row-offset` and `row-count`, so AT announces
  "row 21 of 120" rather than "row 1 of 20".
- `aria-sort` is written onto the header cell for you whenever an
  `md-table-sort-label` is inside it.
- In `frozen-header` mode the body is a focusable scroll region (Tab reaches
  it) — required because the custom horizontal scrollbar is pointer-only. Left
  and Right arrows scroll horizontally, and Ctrl/Cmd + Home / End jump to the
  horizontal ends; all of that is inert unless the body actually overflows
  horizontally. Vertical scrolling (Up/Down, PageUp/PageDown, plain Home/End)
  is the browser's native behaviour.
- Sticky and frozen headers must not cover the focused row — check keyboard
  scrolling.
- `motion="none"` opts out of the reorder animation;
  `prefers-reduced-motion: reduce` already does.

**RTL** — the table uses logical properties throughout, and horizontal scrolling,
pin sides and the custom scrollbar thumbs all normalise the RTL `scrollLeft`
convention. `column-template` is a raw grid value, so a hardcoded asymmetric
template still needs checking per direction.

**Density** — `density="compact|standard|comfortable"`, or the numeric rungs
`-1`…`-4` (rung `0` exists in the type but has no rule — it is the default).
The table also follows a global `data-density` ancestor, and the semantic sizes
stack on top of it. Row heights are independently settable via
`--md-table-row-height-*`.

**i18n** — headers, cells, the caption and the empty state are your content.
Longer translations change column widths; prefer `fr` units over fixed `px` in
`column-template`, and format numbers and dates with `Intl`.

## Related components

`md-table-container` · `md-table-head` · `md-table-body` · `md-table-foot` ·
`md-table-row` · `md-table-cell` · `md-table-toolbar` · `md-table-pagination` ·
`md-table-sort-label` · `md-table-expand-toggle` · `md-list`

## Theming

| Custom property | Purpose | Default |
|---|---|---|
| `--md-table-row-height-standard` | Row height at `density="standard"` | `calc(52px + density scale × 4px)` |
| `--md-table-row-height-compact` | Row height at `density="compact"` | `max(28px, 36px + density scale × 4px)` |
| `--md-table-row-height-comfortable` | Row height at `density="comfortable"` | `max(40px, 60px + density scale × 4px)` |
| `--md-table-header-height` | Header row height | `max(40px, 56px + density scale × 4px)` |
| `--md-table-cell-padding-inline` | Cell inline padding | `--md-sys-spacing-inset-lg` (16px); 12px compact, 20px comfortable |
| `--md-table-cell-padding-block` | Cell block padding | `--md-sys-spacing-inset-sm` (8px); 4px compact |
| `--md-table-divider-color` | Rule between rows | `--md-sys-color-outline-variant` |
| `--md-table-stripe-color` | `striped` alternate-row overlay | `on-surface` at half the hover-layer opacity |
| `--md-table-head-bg` | Header row background | `--md-sys-color-surface-container` |
| `--md-table-head-color` | Header text color | `--md-sys-color-on-surface-variant` |
| `--md-table-foot-bg` | Footer row background | `--md-sys-color-surface-container-low` |
| `--md-table-row-hover-color` | Row hover state-layer color | `--md-sys-color-on-surface` |
| `--md-table-row-selected-bg` | Selected row background | `--md-sys-color-secondary-container` |
| `--md-table-row-selected-color` | Selected row text | `--md-sys-color-on-secondary-container` |
| `--md-table-columns-template` | `grid-template-columns` when no `column-template` prop is set | none |
| `--md-table-min-width` | Minimum grid width | `max-content` |
| `--md-table-empty-min-height` | Height of the empty state | `160px` |
| `--md-table-body-max-h` | Cap on the frozen body's scroll area | `none` (set for you by `md-table-container[max-height]`) |

**CSS parts** — `grid`, `header-grid`, `caption`, `empty`, `skeleton-row`,
`loading`, `progress`, `hscrollbar`, `hscrollbar-thumb`, `vscrollbar`,
`vscrollbar-thumb`.

```css
md-table {
  --md-table-head-bg: var(--md-sys-color-primary-container);
  --md-table-row-height-standard: 44px;
}
md-table::part(hscrollbar-thumb) {
  background: var(--md-sys-color-primary);
}
```

<!-- Auto Generated Below -->


## Overview

Material Design 3 — Table

The core composable table primitive for hand-authored tables.

Layout architecture: the shadow `.md-table__grid` owns the column tracks
(`grid-template-columns`), and every slotted `md-table-row` is a REAL grid
item spanning all tracks that lays its cells on the shared tracks via
`grid-template-columns: subgrid`. Rows being real boxes is what makes row
hover, stripes, dividers, sticky headers and focus rings actually work —
and a wrong cell count skews one row, never the whole table.

Coordination is push-based (the house pattern): the table stamps context
onto its rows (`rowgroup`, stripe parity, stickiness) and pushes sort state
into `md-table-sort-label`s — no MutationObservers, no `:host-context()`.

High-level features:
  - Density: `compact` | `standard` | `comfortable`
  - Sticky header / footer (pair with `md-table-container` for the scroll box)
  - Sticky first / last column via cell `sticky="start" | "end"`
  - Sortable columns via `<md-table-sort-label>` (3-state asc → desc → none)
  - Selection coordination — emits `mdSelectionChange`; `selectAll()` /
    `deselectAll()` / `toggleSelectAll()` for the select-all checkbox
  - Horizontal scroll when the content is wider than the container
  - Loading + empty-state slots, striped rows, configurable dividers

## Properties

| Property         | Attribute         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Type                                                                    | Default        |
| ---------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | -------------- |
| `caption`        | `caption`         | Optional caption rendered above the table head.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `string`                                                                | `''`           |
| `columnTemplate` | `column-template` | CSS `grid-template-columns` value (e.g. `"auto 1fr 120px"`). Takes precedence over the `columns` prop. Use this for fine control, including using `minmax()`, `fr` units and `auto`.                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `string`                                                                | `''`           |
| `columns`        | `columns`         | Number of columns when no `column-template` is provided. The grid uses `repeat(<columns>, minmax(0, 1fr))`. When neither is set, the column count is derived from the first row's cells.                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `number`                                                                | `0`            |
| `density`        | `density`         | Layout density. Accepts BOTH vocabularies:  - the semantic sizes `'compact' \| 'standard' \| 'comfortable'` (row heights   36 / 52 / 60px), which is this component's original API, and - a numeric rung `0 \| -1 \| -2 \| -3 \| -4`, the scale every other component in   the library uses.  A numeric value drives `--md-sys-density-scale` on the host (see the DENSITY block in the CSS) exactly as a global `data-density` ancestor would, and takes the `standard` row-height base. The two are not exclusive: the semantic sizes are themselves scale-aware, so `density="compact"` inside a `data-density="-2"` region condenses further. | `"comfortable" \| "compact" \| "standard" \| -1 \| -2 \| -3 \| -4 \| 0` | `'standard'`   |
| `empty`          | `empty`           | Render the empty-state slot when true.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `boolean`                                                               | `false`        |
| `frozenHeader`   | `frozen-header`   | Frozen-header architecture: the header is rendered OUTSIDE the vertical scroll area, so the scrollbar spans only the body and runs UNDER the head Pair with `md-table-container[max-height]` to cap the body — max-height controls the SIZE, this prop controls the ARCHITECTURE. Without it, a max-height container scrolls the whole table (use `sticky-header` there for the classic in-flow pinned header). | `boolean` | `false` |
| `hoverable`      | `hoverable`       | Hover surface on rows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `boolean`                                                               | `true`         |
| `keepHeight`     | `keep-height`     | Height ratchet (default ON): once the table has rendered, it never shrinks below that initial height. Paging, filtering to fewer/zero rows, or an async refetch that momentarily empties the body keep the table (and therefore the page) geometrically stable — no content below jumps up, and no scrollbar can flash from a transient collapse (async rebuilds have a few frames where fresh rows haven't hydrated and measure 0). Set `keep-height="false"` for tables that intentionally resize (e.g. a density-toggle demo).                                                                                                                 | `boolean`                                                               | `true`         |
| `label`          | `label`           | Accessible name for the `role="table"`. When omitted, the `caption` text names the table (WAI: a caption identifies the table for screen-reader users browsing in tables mode); the generic "Data table" is the last resort. IDREFs cannot cross the shadow boundary, so the caption text is mirrored into `aria-label` rather than referenced via `aria-labelledby`.                                                                                                                                                                                                                                                                             | `string`                                                                | `''`           |
| `loading`        | `loading`         | Show the loading state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | `boolean`                                                               | `false`        |
| `loadingMode`    | `loading-mode`    | Loading presentation: - `overlay` (default) — an indeterminate progress line under the header   plus a scrim that dims/disables the body while the header/footer stay put. - `skeleton` — the body is replaced by shimmering skeleton rows; the   header and footer are untouched.                                                                                                                                                                                                                                                                                                                                                                | `"overlay" \| "skeleton"`                                               | `'overlay'`    |
| `loadingRows`    | `loading-rows`    | Number of skeleton rows rendered in `loading-mode="skeleton"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `number`                                                                | `4`            |
| `minWidth`       | `min-width`       | Minimum table width (e.g. `"640px"`). When the container is narrower, the grid keeps this width and the container shows a horizontal scrollbar instead of squishing the columns. Also settable via `--md-table-min-width`.                                                                                                                                                                                                                                                                                                                                                                                                                        | `string`                                                                | `''`           |
| `motion`         | `motion`          | Built-in expressive motion. With `expressive` (the default) the table FLIP-animates its rows around sort and page changes: it snapshots the row boxes when the triggering event fires (`mdSortRequest`, or a pagination event heard by the surrounding `md-table-container`), lets the consumer's synchronous handler mutate the rows, then glides survivors to their new positions and fades + rises entrants. Async mutations settle as a clean no-op. `prefers-reduced-motion` always wins; set `none` to opt out — e.g. when driving your own `flipRows` wiring around the same events.                                                       | `"expressive" \| "none"`                                                | `'expressive'` |
| `noDividers`     | `no-dividers`     | Hide the dividers between rows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `boolean`                                                               | `false`        |
| `pinIcon`        | `pin-icon`        | Table-wide custom pin-indicator icon (Material Symbols ligature, e.g. "anchor"). Cast to every pinned header cell so consumers set it once; a cell's own `pin-icon` attribute wins over the cast. Empty = built-in push-pin SVG.                                                                                                                                                                                                                                                                                                                                                                                                                  | `string`                                                                | `''`           |
| `pinMode`        | `pin-mode`        | How MULTIPLE pinned columns on the same side behave during horizontal scroll: - `stack` (default) — every pinned column sticks at the same edge, so   later ones slide OVER earlier ones while scrolling (a deck-of-cards   effect; only the top one stays fully visible). - `static` — each pinned column gets a cumulative inset equal to the   widths of the pinned columns before it, so ALL of them stay visible   side-by-side (spreadsheet-style).                                                                                                                                                                                         | `"stack" \| "static"`                                                   | `'stack'`      |
| `rowCount`       | `row-count`       | Total row count for assistive tech when only a subset is rendered (pagination / virtualization). 0 = use the rendered count.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `number`                                                                | `0`            |
| `rowOffset`      | `row-offset`      | Absolute 0-based index of the FIRST rendered body row within the full dataset (WAI/ARIA pagination): with `row-count` set, each row gets an `aria-rowindex` so AT reports "row 42 of 5000" instead of a position within the rendered page. Update it on every page change.                                                                                                                                                                                                                                                                                                                                                                        | `number`                                                                | `0`            |
| `scrollbar`      | `scrollbar`       | Vertical scrollbar presentation (frozen mode): - `overlay` (default) — a custom always-visible thumb FLOATS over the   rows' right edge; no gutter is reserved, so row backgrounds and   dividers run the full width and the bar never takes layout space. - `gutter` — classic inset bar in a reserved gap: `scrollbar-gutter:   stable` keeps a fixed strip inside the table (rows stop short of the   edge) and the native bar renders in it, crossing the row borders.                                                                                                                                                                        | `"gutter" \| "overlay"`                                                 | `'overlay'`    |
| `selection`      | `selection`       | Selection mode. - `none`     — no selection (default) - `single`   — radio-like: selecting a row DESELECTS every other row;                `selectAll()`/the select-all checkbox are inert (disabled) - `multiple` — checkbox-like; select-all checkbox + selectAll() available                                                                                                                                                                                                                                                                                                                                                                           | `"multiple" \| "none" \| "single"`                                      | `'none'`       |
| `sortBy`         | `sort-by`         | Currently active sort column id. Read by `<md-table-sort-label column="…">` to render its arrow. Empty = no sort.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `string`                                                                | `''`           |
| `sortOrder`      | `sort-order`      | Currently active sort direction.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `"asc" \| "desc" \| "none"`                                             | `'asc'`        |
| `stickyFooter`   | `sticky-footer`   | Stick the foot row(s) to the bottom of the scroll container.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `boolean`                                                               | `false`        |
| `stickyHeader`   | `sticky-header`   | Stick the head row(s) to the top of the scroll container.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `boolean`                                                               | `false`        |
| `striped`        | `striped`         | Show alternating row colors.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `boolean`                                                               | `false`        |
| `summary`        | `summary`         | Long description of a COMPLEX table's structure (WAI caption & summary pattern) — e.g. "Columns are grouped under Profile and Employment". Exposed as `aria-description` on the table; invisible otherwise.                                                                                                                                                                                                                                                                                                                                                                                                                                       | `string`                                                                | `''`           |


## Events

| Event                      | Description                                                           | Type                                                                   |
| -------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `mdColumnVisibilityChange` | Emits when a column is hidden/shown via `setColumnVisibility`.        | `CustomEvent<{ column: number; visible: boolean; hidden: number[]; }>` |
| `mdPinChange`              | Emits when a column is pinned/unpinned via `pinColumn`.               | `CustomEvent<{ column: number; side: "start" \| "end" \| null; }>`     |
| `mdScroll`                 | rAF-throttled scroll position of the frozen body scroller.            | `CustomEvent<{ scrollLeft: number; scrollTop: number; }>`              |
| `mdSelectionChange`        | Emitted whenever the row selection state changes.                     | `CustomEvent<MdTableSelectionState>`                                   |
| `mdSortChange`             | Emitted when sort changes (after a `md-table-sort-label` is clicked). | `CustomEvent<MdTableSortState>`                                        |


## Methods

### `animateNextChange() => Promise<void>`

Snapshot the current row boxes and FLIP-animate whatever the next
SYNCHRONOUS DOM mutation does to them. Call it right before you reorder /
show-hide rows outside the table's own events (custom filters, async
refetch completion, …); sort and pagination are bracketed automatically.

#### Returns

Type: `Promise<void>`



### `deselectAll() => Promise<void>`

Programmatically deselect every row.

#### Returns

Type: `Promise<void>`



### `getSelection() => Promise<MdTableSelectionState>`

Returns the current selection state (synchronous snapshot).

#### Returns

Type: `Promise<MdTableSelectionState>`



### `pinColumn(column: number, side: "start" | "end" | "none") => Promise<"start" | "end" | null>`

Pin a column to an edge (or unpin with `'none'`). `column` is the ORIGINAL
0-based column index (its position before any pinning). The table owns the
whole mechanic: it physically re-sequences every row's cells (selection and
expansion state survive — the elements just move), maintains `sticky`
attributes, permutes the column template, and re-floors the header tracks
so pin icons / sort arrows never clip in frozen mode. The move itself is an
intentional SNAP (no FLIP) — the frozen header re-measures its tracks over
the next frames, and animating against that settling would jitter.
Resolves to the column's effective side after the call.

#### Parameters

| Name     | Type                         | Description |
| -------- | ---------------------------- | ----------- |
| `column` | `number`                     |             |
| `side`   | `"none" \| "start" \| "end"` |             |

#### Returns

Type: `Promise<"start" | "end" | null>`



### `selectAll() => Promise<void>`

Selects every body row that is not `disabled` (no-op unless selection="multiple"). Note that `selectable="false"` rows are selected too — that flag only removes a row from the selection totals.

#### Returns

Type: `Promise<void>`



### `setColumnVisibility(column: number, visible: boolean) => Promise<boolean>`

Hide or show a column. `column` is the ORIGINAL 0-based index (same
addressing as `pinColumn`). Hidden cells stay in the DOM (state
survives — they just stop displaying) and their track leaves the
template. The last visible column cannot be hidden. Resolves to the
column's effective visibility.

#### Parameters

| Name      | Type      | Description |
| --------- | --------- | ----------- |
| `column`  | `number`  |             |
| `visible` | `boolean` |             |

#### Returns

Type: `Promise<boolean>`



### `setSort(column: string, order: MdTableSortOrder) => Promise<void>`

Set the active sort column / order programmatically.

#### Parameters

| Name     | Type                        | Description |
| -------- | --------------------------- | ----------- |
| `column` | `string`                    |             |
| `order`  | `"none" \| "desc" \| "asc"` |             |

#### Returns

Type: `Promise<void>`



### `toggleSelectAll() => Promise<void>`

Toggle the "all selected" state (used by the select-all checkbox).

#### Returns

Type: `Promise<void>`




## Shadow Parts

| Part                 | Description |
| -------------------- | ----------- |
| `"caption"`          |             |
| `"empty"`            |             |
| `"grid"`             |             |
| `"header-grid"`      |             |
| `"hscrollbar"`       |             |
| `"hscrollbar-thumb"` |             |
| `"loading"`          |             |
| `"progress"`         |             |
| `"skeleton-row"`     |             |
| `"vscrollbar"`       |             |
| `"vscrollbar-thumb"` |             |


## Dependencies

### Depends on

- [md-progress-indicator](../md-progress-indicator)

### Graph
```mermaid
graph TD;
  md-table --> md-progress-indicator
  style md-table fill:#f9f,stroke:#333,stroke-width:4px
```

----------------------------------------------

*Built with [StencilJS](https://stenciljs.com/)*

AWC UI Operator’s Manual

Copy spec

# main-llm.md — AWC UI build director

<!-- llm:meta
role: director
audience: llm
library: "@awc-ui/core"
component-count: 57
sub-component-count: 24
manual-count: 81
per-component-docs: ./packages/core/src/components/<tag>/readme.md
-->

**You are building a web app with AWC UI, a Material Design 3 web-component
library.** This file is the entry point and the only document you need before
writing UI code. Everything here is self-contained: tokens, recipes,
composition rules and the ship checklist. Per-component detail lives in
`./packages/core/src/components/<tag>/readme.md` — e.g.
[`md-button`](./packages/core/src/components/md-button/readme.md).

Your job, in order:

1. **Interview** the user (§1). Do not skip it and do not guess.
2. **Lock the configuration** their answers imply (§2) and bootstrap it (§3–§4).
3. **Route every UI need through the decision matrix** (§5) — never pick a
   component by name-similarity.
4. **Load the component's readme.md before writing a single line of its
   markup** (§6). The file is
   `./packages/core/src/components/<tag>/readme.md` — read it in full, do not
   skim it, and do not write the markup from memory of a similar library. Each
   one has a `When NOT to use`, a `Do / Don't` table sourced from
   [m3.material.io](https://m3.material.io), and an `Anti-patterns` table of
   mistakes models actually make. If you are about to use three components,
   load all three readmes first.
5. **Check what nests inside what** (§7) and start from a recipe (§8) rather
   than from a blank page.
6. **Apply the universal rules** (§9) — the API, content and accessibility
   rules every component is bound by, and the ones §10 checks you against.
7. **Run the ship checklist** (§10) before declaring done.

**Fail closed.** If you cannot satisfy a step — no component fits, a token
doesn't exist, an accessible name has nowhere to come from — say so and ask.
Do not invent an `md-*` tag, a prop, or a token. If it is not in this file or
in the component's manual, it does not exist.

---

## §1 — Interview the user

Ask these **one at a time**, in this order. Each answer closes off decisions
downstream, so don't batch them into a wall of questions. Skip a question only
if the user has already answered it unprompted.

If the user says "just pick sensible defaults", use the **bold** option and tell
them what you chose.

### 1.1 Scope and shape

1. **What is the app?** One or two sentences — domain, primary job, who uses it.
2. **What kind of surface is it?**
   - Internal tool / admin console / dashboard
   - Data-heavy CRUD application
   - Consumer-facing product
   - Marketing or content site
   - Mobile-first / PWA
3. **Which framework?** React · Angular · Vue · Svelte · **plain HTML** ·
   Next · Nuxt · SvelteKit · Astro
4. **Does it server-render?** (SSR/SSG, or **client-only SPA**)
5. **Roughly how many distinct screens**, and what are the top 3?

### 1.2 Look and feel

6. **Density** — how much information per screen?
   - `0` — **default**, comfortable, touch-friendly
   - `-1` / `-2` — compact; typical for admin consoles
   - `-3` / `-4` — ultra-compact; dense data tables, trading/ops screens
7. **Theme** — light only, dark only, or **both with a user toggle**?
   Does it follow the OS preference?
8. **Brand color** — a seed/primary color, or **stock MD3 palette**?
9. **Expressive motion** — keep **ripple and shape-morph on** (default), or turn
   them off for a flatter, more utilitarian feel?
10. **Shape language** — **rounded** (MD3 default) or squared?

### 1.3 Internationalization

11. **How many locales**, and which?
12. **Any RTL locales** (Arabic, Hebrew, Farsi, Urdu)? — this changes layout
    verification and directional-icon handling.
13. **Which i18n engine?** (i18next, vue-i18n, ngx-translate, Paraglide, custom)
    Components are engine-agnostic — you localize in the consumer layer.
14. **Locale-formatted values** — dates, numbers, currency? Which locale drives
    `Intl`?

### 1.4 Data and forms

15. **Is there significant tabular data?** How many rows, and is it
    server-paged? (Drives how you page `md-table` — it holds the state, you
    supply each page of rows.)
16. **Are there charts?** Which questions should they answer?
17. **How heavy are the forms?** Validation rules, async validation, multi-step?
18. **Rich text editing anywhere?** — ⚠️ **AWC UI has no RTE component.** If yes,
    you must integrate a third-party editor (TipTap, Lexical, Quill) and style
    it to the MD3 tokens yourself. Confirm this with the user explicitly.

### 1.5 Constraints

19. **Accessibility target** — **WCAG 2.1 AA** (what the library is tested to),
    or stricter?
20. **Browser/device support floor?**
21. **Anything already decided** you must not change — existing design system,
    router, state library, CSS approach?

---

## §2 — Map answers to configuration

| Answer | What you set |
|---|---|
| Admin console / data-heavy | `data-density="-1"` or `-2` on `<html>`; prefer `size="xs"`/`"sm"` on actions |
| Consumer / marketing | leave density alone (`0` is the default); larger button sizes (`md`/`lg`) for CTAs |
| Mobile-first | `md-navigation-bar` + `md-fab`; avoid `md-navigation-rail`, `md-transfer-list`, wide tables |
| Desktop-first | `md-navigation-rail` or `md-app-bar`; rail over bottom bar |
| Dark mode | `data-theme="dark"` on `<html>`; wire a toggle, and mirror OS via `prefers-color-scheme` |
| Both themes with toggle | persist the choice; set the attribute before first paint to avoid a flash |
| Brand color | override the `--md-sys-color-*` roles in your own stylesheet, loaded after the tokens (§4.2) |
| Flat / utilitarian | `data-ripple="off"` and `data-shape-morph="off"` on `<html>` |
| Any RTL locale | `dir="rtl"` on `<html>`; add `mirror-icon` to `md-button`s with directional glyphs; swap the glyph name yourself everywhere else (§4.5) |
| Multiple locales | build a dictionary in the consumer layer and feed component text props from it; never hardcode strings in markup |
| `Intl`-formatted values | pass a `locale` prop where a component exposes one; format everything else before it reaches the component |
| SSR | import from `@awc-ui/core/hydrate` on the server; use the client/server wrappers in `@awc-ui/react` |
| Heavy forms | components are form-associated via `ElementInternals` — use a real `<form>`, `md-button type="submit"`, and native `required` (§4.7) |
| Rich text | integrate a third-party editor; there is no `md-rich-text` |

### 2.1 Global switches — the complete set

All are attributes on `<html>` (or any ancestor; the nearest one wins).

```html
<html
  lang="en"
  dir="ltr"                  <!-- or rtl -->
  data-theme="dark"          <!-- omit for light -->
  data-density="-1"          <!-- -1 … -4; see below -->
  data-ripple="off"          <!-- default on -->
  data-shape-morph="off"     <!-- default on -->
>
```

**`data-density="0"` is inert.** No `[density="0"]` rule exists — density `0` is
simply the base values on `:root`, and a `0` rule would pin them onto every
element (reflected props write `density="0"` almost everywhere) and break global
inheritance. So the *overriding* range is `-1 … -4`. To escape an inherited rung
for one subtree, reset the scale directly:

```css
.opt-out-of-density { --md-sys-density-scale: 0; }
```

Per-component overrides beat the global one: a `density` prop, or
`ripple="off"` / `shape-morph="off"` on the element. **53 of the 57 top-level
components expose a `density` prop.** The four that don't: `md-divider`,
`md-ripple`, `md-sparkline`, `md-tabs`. (Nine sub-components also lack one —
they inherit density from the parent that owns their layout.)

---

## §3 — Install and bootstrap

```bash
npm install @awc-ui/core
```

**Register everything (recommended).** Two imports, once per app entry — one
defines every component, one loads the tokens. Both come from `@awc-ui/core`
itself, so this path needs no second package:

```ts
import { defineCustomElements } from '@awc-ui/core/loader';
import '@awc-ui/core/css/tokens.css';

defineCustomElements(window);
```

`@awc-ui/core/css/tokens.css` is the complete, self-contained token sheet —
light and dark colour roles, shape, elevation, motion, typescale, spacing and
z-index. It is the same set documented in §4.1.

**One-line alternative.** `@awc-ui/core/define` does both steps in a single
import. It loads the package's own token sheet, so it needs nothing else
installed:

```ts
import '@awc-ui/core/define'; // defines every component + loads the token sheet
```

`define` is client-only (it eval-guards `window`) and, because it imports CSS,
it needs a bundler. Never import it into a server graph.

**Per-component registration**, for size-sensitive bundles — load the token
sheet once yourself:

```ts
import '@awc-ui/core/css/tokens.css';
import '@awc-ui/core/components/md-button';
import '@awc-ui/core/components/md-text-field';
```

**Framework wrappers** — use these instead of raw elements; they handle
registration, typed props, and event binding. Below the version floor, drop to
the raw custom elements and the `loader` import above.

| Framework | Package | Requires |
|---|---|---|
| React / Next | `@awc-ui/react` | React 18+ |
| Angular | `@awc-ui/angular` (`AwcUiModule`) | Angular 17+ |
| Vue / Nuxt | `@awc-ui/vue` | Vue 3 |
| Svelte / SvelteKit | `@awc-ui/svelte` | Svelte 4+ |
| Plain HTML / Astro | `@awc-ui/core/loader` | — |

**SSR** — `@awc-ui/core/hydrate` renders Declarative Shadow DOM on the server.
`@awc-ui/react` ships matching client/server wrappers. Keep `define` and
`loader` out of the server graph; both are browser entries.

**Fonts** — components expect Roboto and Material Symbols Outlined to be
available. The library does **not** inject them. Every `icon="…"` prop renders a
Material Symbols glyph inside shadow DOM, so the font must be registered at the
**document** level (font registration crosses shadow boundaries; class rules do
not — the components declare the class rule inside their own roots):

```html
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined">
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Roboto:wght@400;500&display=swap">
```

To swap the whole library to a different Material Symbols cut, set
`--md-sys-icon-font-family` on `:root` and load the matching `@font-face`.

---

## §4 — Global configuration reference

### 4.1 The token system

All AWC UI styling resolves to design tokens. **Never hardcode hex colours,
pixel radii, shadows, or font stacks** — they break theming, dark mode, density
and RTL in one stroke. Every value below is a real custom property defined by
`@awc-ui/tokens`; you may read them, and you may override them.

#### Color roles

Light is the default; `[data-theme="dark"]` swaps the palette. Every role has a
matching `on-` role for content drawn on top of it.

| Token | Light | Dark | Typical usage |
|---|---|---|---|
| `--md-sys-color-primary` | `#6750A4` | `#D0BCFF` | Filled buttons, active states |
| `--md-sys-color-on-primary` | `#FFFFFF` | `#381E72` | Text/icons on primary |
| `--md-sys-color-primary-container` | `#EADDFF` | `#4F378B` | FAB, selected segments |
| `--md-sys-color-on-primary-container` | `#21005D` | `#EADDFF` | Text on primary-container |
| `--md-sys-color-secondary` | `#625B71` | `#CCC2DC` | Secondary accents |
| `--md-sys-color-secondary-container` | `#E8DEF8` | `#4A4458` | Tonal buttons, chips |
| `--md-sys-color-tertiary` | `#7D5260` | `#EFB8C8` | Tertiary accents |
| `--md-sys-color-tertiary-container` | `#FFD8E4` | `#633B48` | Tertiary surfaces |
| `--md-sys-color-error` | `#B3261E` | `#F2B8B5` | Error / destructive |
| `--md-sys-color-on-error` | `#FFFFFF` | `#601410` | Content on error |
| `--md-sys-color-error-container` | `#F9DEDC` | `#8C1D18` | Error surfaces |
| `--md-sys-color-surface` | `#FFFBFE` | `#1C1B1F` | Page / card background |
| `--md-sys-color-on-surface` | `#1C1B1F` | `#E6E1E5` | Body text |
| `--md-sys-color-surface-variant` | `#E7E0EC` | `#49454F` | Muted fills |
| `--md-sys-color-on-surface-variant` | `#49454F` | `#CAC4D0` | Secondary text, icons |
| `--md-sys-color-surface-container-lowest` | `#FFFFFF` | `#0F0D13` | Lowest surface tier |
| `--md-sys-color-surface-container-low` | `#F7F2FA` | `#1D1B20` | Card / elevated button bg |
| `--md-sys-color-surface-container` | `#F3EDF7` | `#211F26` | Default container tier |
| `--md-sys-color-surface-container-high` | `#ECE6F0` | `#2B2930` | Dialog / menu surfaces |
| `--md-sys-color-surface-container-highest` | `#E6E0E9` | `#36343B` | Highest surface tier |
| `--md-sys-color-outline` | `#79747E` | `#938F99` | Borders (3:1 contrast) |
| `--md-sys-color-outline-variant` | `#CAC4D0` | `#49454F` | Dividers (low contrast) |
| `--md-sys-color-inverse-surface` | `#313033` | `#E6E1E5` | Snackbar, inverse chips |
| `--md-sys-color-inverse-on-surface` | `#F4EFF4` | `#313033` | Content on inverse-surface |
| `--md-sys-color-scrim` | `#000000` | `#000000` | Modal scrims |

**Semantic status roles** — beyond the baseline M3 palette, the library adds
`success`, `warning` and `info`, each with `on-`, `-container` and
`on-…-container` companions, in both themes, AA-verified. Used by `md-chip`,
`md-badge`, `md-meter`, `md-status-dot`.

| Token | Light | Dark |
|---|---|---|
| `--md-sys-color-success` | `#2E6B4F` | `#9DD5B0` |
| `--md-sys-color-success-container` | `#B8F0CE` | `#14512F` |
| `--md-sys-color-warning` | `#7A5900` | `#EFC148` |
| `--md-sys-color-warning-container` | `#FFDF9B` | `#5C4200` |
| `--md-sys-color-info` | `#38608F` | `#A2C9FE` |
| `--md-sys-color-info-container` | `#D3E4FF` | `#1E4975` |

#### Shape tokens

| Token | Value | Typical usage |
|---|---|---|
| `--md-sys-shape-corner-none` | `0px` | Square edges |
| `--md-sys-shape-corner-extra-small` | `4px` | Snackbar, small chips |
| `--md-sys-shape-corner-small` | `8px` | Cards (outlined), small surfaces |
| `--md-sys-shape-corner-medium` | `12px` | Cards (default), inputs |
| `--md-sys-shape-corner-large` | `16px` | Dialogs, large cards |
| `--md-sys-shape-corner-extra-large` | `28px` | Bottom sheets |
| `--md-sys-shape-corner-full` | `9999px` | Buttons, chips, FAB |

Partial-corner variants also exist for surfaces that meet an edge:
`--md-sys-shape-corner-extra-small-top`, `-large-top`, `-large-end`,
`-extra-large-top`. Their values are four-value `border-radius` shorthands
(e.g. `16px 16px 0px 0px`), so assign them to `border-radius`, not to a single
corner.

#### Elevation tokens

`-0` is the keyword `none`; `-1` through `-5` are complete `box-shadow` values,
and those five are **re-declared with deeper shadows under `[data-theme="dark"]`**
— so always use the token rather than copying its value.

| Token | When |
|---|---|
| `--md-sys-elevation-0` | `none` — resting cards, flat surfaces |
| `--md-sys-elevation-1` | Elevated buttons and cards at rest |
| `--md-sys-elevation-2` | Hover bump |
| `--md-sys-elevation-3` | FAB, menus, dialogs at rest |
| `--md-sys-elevation-4` – `-5` | Reserved for the most prominent surfaces |

#### Motion tokens

Durations come in four families of four: `short1…4` (50/100/150/200ms),
`medium1…4` (250/300/350/400ms), `long1…4` (450/500/550/600ms), and
`extra-long1…4` (700/800/900/1000ms).

| Token | Value | When |
|---|---|---|
| `--md-sys-motion-duration-short2` | `100ms` | Buttons, ripples, state layers |
| `--md-sys-motion-duration-medium2` | `300ms` | Dialogs, sheets, menus |
| `--md-sys-motion-duration-long2` | `500ms` | Large surface transitions |
| `--md-sys-motion-duration-extra-long1` | `700ms` | Ambient / chart entrances |
| `--md-sys-motion-easing-standard` | `cubic-bezier(0.2, 0, 0, 1)` | Small utility transitions |
| `--md-sys-motion-easing-standard-accelerate` | `cubic-bezier(0.3, 0, 1, 1)` | Exits |
| `--md-sys-motion-easing-standard-decelerate` | `cubic-bezier(0, 0, 0, 1)` | Entrances |
| `--md-sys-motion-easing-emphasized` | `cubic-bezier(0.2, 0, 0, 1)` | Expressive transitions |
| `--md-sys-motion-easing-emphasized-accelerate` | `cubic-bezier(0.3, 0, 0.8, 0.15)` | Expressive exits |
| `--md-sys-motion-easing-emphasized-decelerate` | `cubic-bezier(0.05, 0.7, 0.1, 1)` | Expressive entrances |
| `--md-sys-motion-easing-linear` | `linear` | Progress, indeterminate loops |

> `--md-sys-motion-easing-emphasized` deliberately equals the standard curve:
> the full M3 emphasized curve is a two-phase path interpolator that CSS cannot
> express. The accelerate and decelerate halves *are* expressible, and are the
> ones to reach for.

MD3 Expressive also ships spring pairs, each an easing plus its natural
duration: `--md-sys-motion-spring-{spatial,effects}-{fast,default,slow}-easing`
and `…-duration`. Spatial = position/size/shape; effects = colour/opacity.

#### State-layer opacities

| Token | Value |
|---|---|
| `--md-sys-state-hover-state-layer-opacity` | `0.08` |
| `--md-sys-state-focus-state-layer-opacity` | `0.12` |
| `--md-sys-state-pressed-state-layer-opacity` | `0.12` |
| `--md-sys-state-dragged-state-layer-opacity` | `0.16` |
| `--md-sys-state-disabled-container-opacity` | `0.12` |
| `--md-sys-state-disabled-content-opacity` | `0.38` |

#### Typography, spacing and layering

- **Typescale** — `--md-sys-typescale-<role>-<size>-*` for
  `display`/`headline`/`title`/`label`/`body` × `large`/`medium`/`small`. Each
  role exposes `-font-family`, `-font-size`, `-line-height`, `-font-weight`,
  `-letter-spacing`, plus a `-font` shorthand
  (e.g. `--md-sys-typescale-headline-medium-font: 400 28px/36px Roboto, sans-serif`).
  Use the shorthand on the `font` property for headings you write yourself.
- **Spacing** — a 4px scale that tightens with density:
  `--md-sys-spacing-inset-{xs,sm,md,lg,xl}` (internal padding, 4/8/12/16/24px)
  and `--md-sys-spacing-gap-{xs,sm,md,lg}` (between siblings, 4/8/12/16px), plus
  `--md-sys-spacing-row-height` (`56px` at density 0).
- **Layering** — `--md-sys-z-index-app-bar` (100), `-navigation` (200),
  `-bottom-sheet` (300), `-popup` (1000), `-dialog-scrim` (1001), `-tooltip`
  (1500), `-snackbar` (2000). Use these instead of inventing z-indexes, or your
  overlay will land under a menu.

### 4.2 Theming and rebranding

To rebrand, redefine the role variables **after** the tokens stylesheet — both
themes, or dark mode inherits your light brand colour:

```css
:root {
  --md-sys-color-primary: #00629E;
  --md-sys-color-on-primary: #FFFFFF;
  --md-sys-color-primary-container: #CFE5FF;
  --md-sys-color-on-primary-container: #001D33;
}
[data-theme="dark"] {
  --md-sys-color-primary: #9BCBFF;
  --md-sys-color-on-primary: #003354;
  --md-sys-color-primary-container: #004A78;
  --md-sys-color-on-primary-container: #CFE5FF;
}
```

Per-component knobs are `--md-<component>-*` custom properties, listed in each
manual's Theming section (`--md-button-container-color`,
`--md-card-container-shape`, …). Prefer those over `::part()`, and prefer
`::part()` over reaching into shadow internals, which are unstable and will
break on any release.

**Overriding a colour role forfeits the library's contrast testing.** Re-verify
AA (4.5:1 text, 3:1 borders and dividers) after any palette change. The Theme
Generator at <https://awc-ui.dev/theme-generator> takes a seed colour, emits both
palettes as `--md-sys-color-*` overrides, and runs the WCAG checks live — use it
rather than hand-picking container and `on-` pairs.

### 4.3 Density

`data-density` steps `-1 → -4`; each rung trims ~4px of padding and touch
target, driving `--md-sys-density-scale` and the spacing tokens. `-4` is the
floor. Set it globally, override locally with the `density` prop. Do not go
below `-2` on touch-primary surfaces — you will break the 48px target.

Two details that bite:

- **`density="0"` does nothing** — see §2 for why, and for the
  `--md-sys-density-scale: 0` escape hatch.
- **`md-table` accepts two vocabularies**: the semantic `compact` / `standard` /
  `comfortable` (row heights 36 / 52 / 60px) *and* the numeric rungs. They
  compose — `density="compact"` inside a `data-density="-2"` region condenses
  further.

### 4.4 Dark mode

Set `data-theme="dark"` on `<html>` (or any ancestor — the nearest wins). The
tokens swap automatically and inherit across every shadow boundary; no
per-component code. To mirror the OS, read `prefers-color-scheme` and write the
attribute **before first paint**, or the page flashes light.

### 4.5 RTL

Layout is written with CSS logical properties, so it flips with `dir="rtl"`
without extra work. Two things still need you:

- **Directional glyphs do not flip.** Material Symbols are not auto-mirrored.
  `md-button` has a `mirror-icon` prop that mirrors its own leading/trailing
  glyph — set it on buttons using arrows, chevrons, `send`, `reply`, and leave
  it off for `add`, `search`, `favorite`. **`mirror-icon` exists only on
  `md-button`.** Everywhere else — `md-icon-button icon="…"`, `md-list-item`
  leading/trailing icons, `md-app-bar leading-icon` — swap the glyph name
  yourself (`arrow_back` ↔ `arrow_forward`).
- **Icon props you supply yourself** — e.g. `md-transfer-list`'s
  `move-right-icon` / `move-left-icon` / `move-all-*-icon` — must be swapped by
  you when the direction flips.

Never write physical CSS (`margin-left`, `padding-right`, `left`) around these
components. Use `margin-inline-start`, `padding-inline-end`, `inset-inline-end`.

### 4.6 Internationalization

Components are **i18n-engine-agnostic by design**. Every user-visible string is
either slotted content or a prop. Localize in the consumer layer: resolve your
dictionary to plain strings, then pass them in. Do not add a translation engine
inside a component. `locale` props exist only where a component computes an
`Intl`-formatted value itself: `md-date-picker`, `md-number-field`,
`md-meter`, `md-dialog`, and the charts (`md-bar-chart`, `md-line-chart`,
`md-area-chart`, `md-pie-chart`). `md-time-picker` has no
`locale` prop — it takes `format="12h" | "24h"` instead.

Templated strings keep their placeholder tokens when translated — translate
around the braces, don't remove them:

```html
<md-transfer-list count-template="{checked} / {total} ausgewählt"></md-transfer-list>
```

Other templated props: `md-autocomplete status-template`, `md-otp-field
cell-label-template`. Default prop values are English (`Search`, `Dismiss`,
`No results`, `Move selected to target`, …) — every one of them needs
translating in a localized app.

### 4.7 Forms and validation

Fourteen components are form-associated via `ElementInternals`, so they
participate in `FormData` and constraint validation like native controls:

`md-text-field` · `md-number-field` · `md-otp-field` · `md-select` ·
`md-multi-select` · `md-autocomplete` · `md-checkbox` · `md-radio` ·
`md-switch` · `md-slider` · `md-rating` · `md-date-picker` · `md-time-picker` ·
`md-button`

Rules:

- Use a real `<form>`. `md-button type="submit"` calls `form.requestSubmit()`
  (not `submit()`), so the `submit` event fires **and** built-in constraint
  validation runs. `required` genuinely blocks submit.
  `md-button type="reset"` calls `form.reset()`.
- Give every control a `name`, or it will not appear in `FormData`.
- Do **not** add hidden `<input>`s to mirror values — that's the old pattern and
  it double-submits.
- Validity changes are announced on a `mdValidityChange` event on the control.
  Error presentation is `error` + `error-text` on the field.
- Boolean state props differ by control — `md-checkbox` uses `checked`,
  `md-switch` uses **`selected`**, `md-select-option` uses `selected`. Check the
  manual; guessing `checked` on a switch silently does nothing.

---

## §5 — Component decision matrix

Route by **need**, not by name. If the need isn't listed, find the closest row
and read that component's `When NOT to use`.

### 5.1 Actions

| Need | Use | Don't use |
|---|---|---|
| Discrete labelled action | `md-button` | `md-chip`, raw `<button>` |
| Icon-only action | `md-icon-button` | `md-button` with no label |
| A destructive action | `md-button` + `md-dialog` to confirm | an unconfirmed `filled` button |
| The single most prominent screen action (mobile) | `md-fab` | a second `filled` `md-button` |
| One prominent action that expands to several | `md-fab-menu` + `md-fab-menu-item` | a stack of FABs |
| Primary action + variants of it | `md-split-button` | button + separate menu |
| 2–5 related actions as one unit | `md-button-group` | loose adjacent buttons |
| Mutually exclusive view/mode switch | `md-segmented-button-set` + `md-segmented-button` | radio buttons, tabs |
| Overflow / contextual actions | `md-menu` + `md-menu-item` | a row of text buttons |

### 5.2 Text input

| Need | Use | Don't use |
|---|---|---|
| Any single-line or multi-line text entry | `md-text-field` | raw `<input>` |
| A number with steppers and locale formatting | `md-number-field` | `md-text-field type="number"` |
| A one-time code / PIN | `md-otp-field` | a row of text fields |
| Text entry with suggestions | `md-autocomplete` | `md-select` |
| Site/app-wide search with a results surface | `md-search` | `md-text-field` with an icon |

### 5.3 Selection

| Need | Use | Don't use |
|---|---|---|
| One of many, from a list | `md-select` + `md-select-option` | radio group over ~7 options |
| One of few (2–5), all visible | `md-radio` | `md-select` |
| Several of many | `md-multi-select` | many `md-checkbox`es |
| Several of few, all visible | `md-checkbox` | `md-multi-select` |
| Instant on/off setting | `md-switch` | `md-checkbox` |
| A value in a numeric range | `md-slider` | `md-text-field type=number` |
| Subjective score | `md-rating` | slider |
| A color | `md-color-picker` | `<input type=color>` |
| Assign a subset from a bounded pool, side by side | `md-transfer-list` | two lists + buttons |
| Filter / attribute / removable entry | `md-chip` | small buttons |
| A date | `md-date-picker` | three selects |
| A time | `md-time-picker` | text field |

### 5.4 Navigation

| Need | Use | Don't use |
|---|---|---|
| Top-level destinations, mobile | `md-navigation-bar` + `md-navigation-tab` | tabs |
| Top-level destinations, desktop | `md-navigation-rail` + `md-navigation-rail-tab` | bottom bar |
| App header: title, actions, search | `md-app-bar` | a custom `<header>` |
| A dense action strip | `md-toolbar` | app bar |
| Sibling views **within** one screen | `md-tabs` + `md-tab` + `md-tab-panels` + `md-tab-panel` | navigation bar |
| Hierarchy / where-am-I | `md-breadcrumbs` + `md-breadcrumb-item` | text links |
| A linear multi-step flow | `md-stepper` + `md-step` | tabs |
| Contextual popup actions | `md-menu` + `md-menu-item`, `md-menu-item-group`, `md-sub-menu-item` | dialog |
| Hierarchical command menu (File → Export → PDF) | `md-menu` + `md-sub-menu-item` | nested dialogs |

### 5.5 Containment and feedback

| Need | Use | Don't use |
|---|---|---|
| Group related content | `md-card` | a bare `<div>` with a border |
| Blocking decision or focused task | `md-dialog` | a new page |
| Critical error the user must acknowledge | `md-dialog` | `md-snackbar` |
| Supplementary content from the bottom (mobile) | `md-bottom-sheet` | dialog |
| Supplementary content from the side (desktop) | `md-side-sheet` | dialog |
| Brief confirmation of an action, optionally undoable | `md-snackbar` | dialog, alert |
| Explain a control on hover/focus | `md-tooltip` | a dialog or inline hint |
| Progressive disclosure of sections | `md-accordion` + `md-accordion-item` | tabs |
| Visual separation | `md-divider` | a styled `<hr>` |
| A vertical set of records | `md-list` + `md-list-item` | a table |
| Determinate/indeterminate progress | `md-progress-indicator` | spinner GIF |
| Brand-consistent page/content loading | `md-loading-indicator` | custom spinner |
| Content-shaped loading placeholder | `md-skeleton` | a spinner over the whole page |
| Count or status on an element | `md-badge` | superscript text |
| Compact status dot | `md-status-dot` | a colored emoji |
| Read-only value within a known range (quota, battery) | `md-meter` | `md-progress-indicator` |
| A person or entity image/initials | `md-avatar` | a raw `<img>` |
| Touch feedback inside a custom control | `md-ripple` | custom CSS animation |

### 5.6 Data

| Need | Use | Don't use |
|---|---|---|
| Any table | `md-table-container` wrapping `md-table`, with `-head`/`-body`/`-row`/`-cell`/`-foot` inside the table and `-toolbar`/`-pagination` beside it in the container (§7.1) | a native `<table>` |
| Sorting, selection, paging on that table | the same parts — `md-table` carries the STATE (`sort-by`, `sort-order`, `selection`, `row-offset`, `row-count`, `loading`) and emits events; you own the data and do the actual sorting/paging | expecting it to sort an array for you |
| Hierarchy / reporting lines | `md-organization-chart` | nested lists |
| Compare categories | `md-bar-chart` | pie chart |
| Trend over time | `md-line-chart` | bar chart |
| Trend with cumulative volume | `md-area-chart` | line chart |
| Parts of a whole (≤ ~6 slices) | `md-pie-chart` | bar chart |
| Inline micro-trend in a cell or card | `md-sparkline` | a full chart |

> **There is no data-driven table component.** `md-table` is composable: you
> render the rows. It tracks and announces sort, selection and pagination state
> and emits events when the user changes them, but the sorting, filtering and
> slicing of your data is yours to perform. Render rows from your own array in
> response to those events.

### 5.7 Choosing the variant

The matrix picks the component; this picks its shape. Every value below is a
real enum member — anything not listed here is not a valid value.

| Component | Prop | Values, and when |
|---|---|---|
| `md-button` | `variant` | `filled` the one primary action · `tonal` a strong secondary · `outlined` secondary, and the safe choice for a destructive action behind a confirm · `text` low emphasis, dialog Cancel · `elevated` when it sits on a busy or coloured background (default `filled`) |
| `md-button` / `md-icon-button` / `md-button-group` | `size` | `xs` `sm` `md` `lg` `xl` — default `sm`; go `md`/`lg` for consumer CTAs, `xs`/`sm` for dense admin UI |
| `md-icon-button` | `variant` | `standard` (default) · `filled` · `tonal` · `outlined` |
| `md-button-group` | `variant` | `standard` spaced · `connected` fused into one bar |
| `md-fab` | `size` | `standard` (default) · `medium` · `large` |
| `md-fab` | `variant` | `primary-container` (default) · `secondary-container` · `tertiary-container` · `surface` · `primary` · `secondary` · `tertiary` |
| `md-card` | `variant` | `filled` for a group of comparable items · `elevated` (default) for a hero or featured item · `outlined` for a settings or form section |
| `md-text-field` / `md-select` | `variant` | `outlined` for forms on a surface · `filled` for dense or tinted layouts (`md-text-field` defaults to `filled`, `md-select` to `outlined`) — pick one and use it for every field on the screen |
| `md-text-field` | `type` | any native input type: `password`, `email`, `tel`, `url`, `search`, … (default `text`) |
| `md-text-field` | `multiline` | `"auto-grow"` grows with content · `"fixed"` with `rows` for a fixed comment box · `false` (default) single line |
| `md-search` | `variant` | `contained` (default) · `divided` |
| `md-app-bar` | `variant` | `small` (default) · `medium` · `large` for a prominent headline · `search` for a bar that hosts a field |
| `md-chip` | `variant` | `assist` (default) · `filter` for toggleable facets · `input` for user-entered removable values · `suggestion` |
| `md-chip` | `appearance` | `outlined` (default) · `filled` · `elevated` |
| `md-badge` | `variant` | `small` a bare dot · `large` (default) a count |
| `md-tooltip` | `variant` | `plain` (default) a short label on an icon control · `rich` an explanatory popover that may hold a link or action |
| `md-divider` | — | **no `variant`** — use the booleans `inset`, `inset-start`, `inset-end` |
| `md-side-sheet` | `variant` | `standard` coexists with page content · `modal` overlays with a scrim |
| `md-bottom-sheet` | `variant` | `standard` (default) · `detached` floating above the edge |
| `md-dialog` | `fullscreen` | boolean — a full-screen dialog for a long mobile task |
| `md-date-picker` | `variant` | `modal-input` (default) calendar plus a typed field · `modal` calendar only · `docked` inline, anchored to the field |
| `md-time-picker` | `variant` | `dial` · `input` (default) |
| `md-progress-indicator` | `variant` | `linear` (default) · `circular`; add `indeterminate` when the total is unknown |
| `md-list-item` | `lines` | `1` · `2` · `3` — must match how much supporting text you pass |
| `md-navigation-bar` | — | 3–5 destinations. Fewer than three: use `md-tabs`. More than five: a rail or a menu |
| `md-navigation-rail` | — | 3–7 destinations; cap the overflow with `max-visible` |

### 5.8 Not in the library

Rich text editor · file upload/dropzone · calendar/scheduler view · map ·
toast stack manager (use `md-snackbar` and manage the queue yourself) ·
data grid with virtualized columns. If the user needs one, say so plainly and
integrate a third-party component styled with the MD3 tokens.

**There is no `md-grid`, no `md-data-table`, no `md-layout`, no `md-icon`.**
If a tag is not listed in §6, it does not exist — do not emit it.

---

## §6 — Component inventory

**Every component has exactly one manual, and it is the readme.md in its own
source folder:**

```
./packages/core/src/components/<tag>/readme.md
```

e.g. [`md-select`](./packages/core/src/components/md-select/readme.md),
[`md-button`](./packages/core/src/components/md-button/readme.md).

**Load that file before you use the component.** There is no second, shorter
summary to rely on — this readme is the single source, so anything you do not
read there, you do not know. Each one carries When-to-use, a Do/Don't table
from M3, copy-paste patterns, an anti-patterns table, and the theming surface.

Work through them one at a time: pick the component from the decision matrix
(§5), load its readme, write that component's markup, then move to the next.

There are 81 manuals for 57 components: 24 of them document sub-components that
are only valid inside a parent (a table cell, a tab panel, a select option).
Every sub-component manual names its parent in the first line, and §7 below
summarises the nesting.

`status` in each manual's `llm:meta` block is one of:

- **`md3-mapped`** — has a Material Design 3 guidelines page; the Do/Don't is
  sourced from it.
- **`custom`** — an addition to MD3; guidance is derived house rules.
- **`sub-component`** — only valid inside a specific parent.

| Category | Components |
|---|---|
| Actions | `md-button` `md-icon-button` `md-fab` `md-fab-menu` `md-fab-menu-item` `md-split-button` `md-button-group` `md-segmented-button` `md-segmented-button-set` |
| Text input | `md-text-field` `md-number-field` `md-otp-field` `md-autocomplete` `md-search` |
| Selection | `md-select` `md-select-option` `md-multi-select` `md-checkbox` `md-radio` `md-switch` `md-slider` `md-rating` `md-color-picker` `md-transfer-list` `md-chip` |
| Pickers | `md-date-picker` `md-time-picker` |
| Navigation | `md-app-bar` `md-toolbar` `md-navigation-bar` `md-navigation-tab` `md-navigation-rail` `md-navigation-rail-tab` `md-tabs` `md-tab` `md-tab-panels` `md-tab-panel` `md-breadcrumbs` `md-breadcrumb-item` `md-menu` `md-menu-item` `md-menu-item-group` `md-sub-menu-item` `md-stepper` `md-step` |
| Containment | `md-card` `md-dialog` `md-bottom-sheet` `md-side-sheet` `md-snackbar` `md-tooltip` `md-accordion` `md-accordion-item` `md-divider` `md-list` `md-list-item` |
| Data | `md-table` `md-table-container` `md-table-head` `md-table-body` `md-table-row` `md-table-cell` `md-table-foot` `md-table-toolbar` `md-table-pagination` `md-table-sort-label` `md-table-expand-toggle` `md-organization-chart` |
| Charts | `md-bar-chart` `md-line-chart` `md-area-chart` `md-pie-chart` `md-sparkline` |
| Status & feedback | `md-progress-indicator` `md-loading-indicator` `md-skeleton` `md-badge` `md-status-dot` `md-meter` `md-avatar` `md-ripple` |

---

## §7 — Composition rules

### 7.1 What nests inside what

A sub-component is only valid inside its parent. Putting one anywhere else
produces an unstyled, unregistered-looking element with no keyboard behaviour,
because the parent is what wires roving tabindex, ARIA ids and selection.

| Parent | Children it manages |
|---|---|
| `md-button-group` | `md-button`, `md-icon-button` |
| `md-segmented-button-set` | `md-segmented-button` |
| `md-fab-menu` | `md-fab-menu-item` (anchored to an `md-fab` via `anchor="<id>"`) |
| `md-menu` | `md-menu-item`, `md-sub-menu-item`, `md-menu-item-group` — **not** `md-divider`; separate rows with `md-menu-item`'s own `divider` (or `gap`) prop |
| `md-menu-item-group` | `md-menu-item` |
| `md-sub-menu-item` | a nested `md-menu` in `slot="submenu"` — the items go in *that* menu. There is no default slot, so anything else you nest renders nothing |
| `md-select`, `md-multi-select`, `md-autocomplete` | `md-select-option` |
| `md-list` | `md-list-item`, `md-divider` |
| `md-tabs` | `md-tab` |
| `md-tab-panels` | `md-tab-panel` (one per tab, in tab order) |
| `md-navigation-bar` | `md-navigation-tab` |
| `md-navigation-rail` | `md-navigation-rail-tab`, plus an `md-fab` in `slot="fab"` |
| `md-accordion` | `md-accordion-item` |
| `md-stepper` | `md-step` (horizontal steppers also take `slot="content"`) |
| `md-breadcrumbs` | `md-breadcrumb-item` |
| `md-table-container` | `md-table` — **it wraps the table, not the other way round** — plus `md-table-toolbar` in `slot="top"` and `md-table-pagination` in `slot="bottom"`, which sit outside the scroll region |
| `md-table` | `md-table-head`, `md-table-body`, `md-table-foot` (and bare `md-table-row`). It does **not** accept the container, toolbar or pagination |
| `md-table-head` / `-body` / `-foot` | `md-table-row` |
| `md-table-row` | `md-table-cell`, plus `md-table-expand-toggle` for an expandable row |
| `md-table-cell` | `md-table-sort-label` in a header cell |
| `md-tooltip` | **its trigger** — the tooltip wraps the element it describes in its default slot |
| `md-dialog` | body content in the default slot; `md-button` in `slot="actions"` |
| `md-bottom-sheet` / `md-side-sheet` | content in the default slot; `md-button` in `slot="actions"`; headline in `slot="headline"` |
| `md-app-bar` | `md-icon-button` in `slot="leading"` and `slot="trailing"`; `md-menu` for overflow; a field in `slot="search"` on `variant="search"` |
| `md-toolbar` | `md-icon-button`, `md-button`, `md-button-group`; an `md-fab` in `slot="fab"`; `slot="leading"` / `slot="trailing"` for the end clusters |

### 7.2 Pairs that belong together

These don't nest — they sit next to each other in a working flow. Reaching for
one usually means you want the other.

| This | Goes with | Why |
|---|---|---|
| `md-icon-button` | `md-tooltip` | The tooltip supplies the visible meaning the icon lacks |
| `md-button` (`soft-disabled`) | `md-tooltip` | Explains *why* the action is unavailable |
| `md-fab` | `md-fab-menu` | The FAB is the menu's anchor |
| `md-split-button` | `md-menu` | The trailing half opens it |
| `md-card` | `md-button`, `md-icon-button`, `md-divider` | Footer actions, corner action, internal sections |
| `md-list-item` | `md-checkbox`, `md-switch`, `md-icon-button` | Trailing controls in a selectable or settings row |
| `md-bottom-sheet` / `md-side-sheet` | `md-list` | Action menus and filter panels inside the sheet |
| `md-search` | `md-list`, `md-avatar`, `md-icon-button` | Results in the panel; account and voice/filter affordances in the trailing slot |
| `md-date-picker` | `md-time-picker` | Date + time row for booking and scheduling forms |
| `md-time-picker` | `md-button` | The trigger, when `hide-trigger` is set. The picker **is** its own dialog — don't nest it in another one |
| `md-text-field` | `md-button` | Submit / cancel in the form footer |
| `md-multi-select` / `md-autocomplete` | `md-text-field`, `md-menu`, `md-chip` | The field is the trigger (and inherits its variant, density and error state), the menu is the option surface, chips are the selected values |
| `md-autocomplete` | `md-progress-indicator` | The loading row while suggestions are fetched |
| `md-transfer-list` | `md-checkbox`, `md-text-field`, `md-icon-button` | Per-row select, per-side search, mover controls |
| `md-number-field` | `md-text-field` hooks, `md-icon-button` | It *is* an `md-text-field` internally — every `--md-text-field-*` custom property passes through — and its steppers are `md-icon-button`s |
| `md-otp-field` | `md-button` | Verify action (`auto-submit` covers the no-button flow) |
| Any chart | `md-card` | Charts belong on a dashboard tile |
| `md-line-chart` | `md-segmented-button-set` | Period picker (1W / 1M / 1Y) driving the range |
| `md-sparkline` | `md-list-item`, `md-table-cell` | Trend column beside a value |
| `md-skeleton` | `md-card`, `md-list` | Render N placeholders in the real layout while fetching |
| `md-meter` | `md-chip`, `md-card` | Same semantic status colour on both; quota and usage summaries live on a card |
| `md-color-picker` | `md-text-field`, `md-button` | Label and helper text beside it in a form; save / cancel in the surrounding popover or dialog |
| `md-rating` | `md-text-field`, `md-card` | A rating row in a review form; aggregate scores on a review card |
| `md-accordion` | `md-divider` | Optional inner dividers inside long item content |
| `md-stepper` | `md-button` | Next / back / submit adjacent to the stepper |

### 7.3 Nesting that is always wrong

- A dialog opened from inside a dialog. Use `md-stepper` inside **one**
  `md-dialog`.
- A component inside a native interactive element (`<button>`, `<a>`) — it
  nests interactive controls and destroys the accessibility tree. Use the
  component's own `href` / `type` props.
- `md-tabs` used for top-level app navigation. Tabs switch sibling views of the
  same data; destinations are `md-navigation-bar` / `md-navigation-rail`.

---

## §8 — Page recipes

Complete, runnable screens. Each renders as-is once the components are
registered and the token sheet and font links from §3 are loaded — no
placeholder identifiers, no helper functions to write.

### 8.1 Login screen

`<form>` is load-bearing: it is what makes `required` block submit and what
`type="submit"` calls `requestSubmit()` on.

```html
<main style="display: grid; place-items: center; min-block-size: 100dvh; padding: 24px;">
  <form id="login-form" style="inline-size: min(420px, 100%);">
    <md-card variant="elevated" style="padding: 32px; display: flex; flex-direction: column; gap: 20px;">
      <h1 style="margin: 0; font: var(--md-sys-typescale-headline-medium-font);">Sign in</h1>

      <md-text-field
        variant="outlined"
        label="Email"
        type="email"
        name="email"
        autocomplete="username"
        required
      ></md-text-field>

      <md-text-field
        variant="outlined"
        label="Password"
        type="password"
        name="password"
        autocomplete="current-password"
        password-toggle="internal"
        required
      ></md-text-field>

      <md-button variant="filled" type="submit" full-width>Sign in</md-button>
      <md-button variant="text" href="/forgot-password">Forgot password?</md-button>
    </md-card>
  </form>
</main>

<script type="module">
  document.getElementById('login-form').addEventListener('submit', (e) => {
    e.preventDefault();
    const data = new FormData(e.currentTarget);
    console.log(data.get('email'), data.get('password'));
  });
</script>
```

### 8.2 Settings page (mobile)

Top app bar + grouped rows of instant-apply switches. `md-switch` uses
**`selected`**, not `checked`. The rows are `type="text"` (non-interactive), so
the switch is the only control — one tab stop per setting.

```html
<md-app-bar variant="small" headline="Settings">
  <md-icon-button slot="leading" icon="arrow_back" aria-label="Back"></md-icon-button>
</md-app-bar>

<main style="padding: 16px; display: flex; flex-direction: column; gap: 16px;">
  <md-card variant="outlined">
    <md-list>
      <md-list-item headline="Notifications" supporting-text="Push, email, in-app" lines="2">
        <md-switch slot="trailing" selected aria-label="Enable notifications" data-setting="notifications"></md-switch>
      </md-list-item>
      <md-divider></md-divider>
      <md-list-item headline="Dark mode" supporting-text="Match system" lines="2">
        <md-switch slot="trailing" aria-label="Enable dark mode" data-setting="dark"></md-switch>
      </md-list-item>
      <md-divider></md-divider>
      <md-list-item headline="Sync over cellular">
        <md-switch slot="trailing" selected aria-label="Sync over cellular" data-setting="cellular"></md-switch>
      </md-list-item>
    </md-list>
  </md-card>
</main>

<md-snackbar id="settings-toast" message="Setting saved"></md-snackbar>

<script type="module">
  const toast = document.getElementById('settings-toast');
  document.querySelectorAll('md-switch[data-setting]').forEach((sw) => {
    sw.addEventListener('mdChange', (e) => {
      if (sw.dataset.setting === 'dark') {
        document.documentElement.setAttribute('data-theme', e.detail.selected ? 'dark' : 'light');
      }
      toast.show();
    });
  });
</script>
```

### 8.3 Settings form (deferred save, with validation)

When settings are saved on submit rather than applied instantly, use a real
form. `required` blocks the submit; every control needs a `name` to reach
`FormData`.

```html
<form id="profile-form" style="max-inline-size: 560px; margin: 24px auto; padding: 0 16px;">
  <md-card variant="outlined" style="padding: 24px; display: flex; flex-direction: column; gap: 20px;">
    <h2 style="margin: 0; font: var(--md-sys-typescale-title-large-font);">Profile</h2>

    <md-text-field
      variant="outlined"
      label="Display name"
      name="displayName"
      required
      supporting-text="Shown on your public profile"
    ></md-text-field>

    <md-select variant="outlined" label="Language" name="language" value="en" required>
      <md-select-option value="en" label="English"></md-select-option>
      <md-select-option value="de" label="Deutsch"></md-select-option>
      <md-select-option value="ar" label="العربية"></md-select-option>
    </md-select>

    <!-- md-checkbox has NO label slot. It is a labelable, form-associated
         element: wrap it in a native <label> (which names it AND forwards
         clicks), or give the host an aria-label. Text between the tags is
         NOT rendered. -->
    <label style="display: inline-flex; align-items: center; gap: 12px; cursor: pointer;">
      <md-checkbox name="newsletter" value="yes" supporting-text="Monthly, no more"></md-checkbox>
      <span>Send me product news</span>
    </label>

    <div style="display: flex; gap: 8px; justify-content: flex-end;">
      <md-button variant="text" type="reset">Reset</md-button>
      <md-button variant="filled" type="submit">Save changes</md-button>
    </div>
  </md-card>
</form>

<md-snackbar id="saved-toast" message="Changes saved" action="Undo"></md-snackbar>

<script type="module">
  const form = document.getElementById('profile-form');
  const toast = document.getElementById('saved-toast');

  form.addEventListener('submit', (e) => {
    e.preventDefault();
    const data = Object.fromEntries(new FormData(form));
    console.log(data); // { displayName, language, newsletter? }
    toast.show();
  });

  toast.addEventListener('mdAction', () => form.reset());
</script>
```

### 8.4 Dashboard with a FAB

```html
<md-app-bar variant="medium" headline="Inbox">
  <md-icon-button slot="trailing" icon="search" aria-label="Search"></md-icon-button>
  <md-icon-button slot="trailing" icon="filter_list" aria-label="Filter"></md-icon-button>
</md-app-bar>

<main style="padding: 16px; display: grid; gap: 12px; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));">
  <md-card variant="filled" interactive style="padding: 16px;">
    <strong>Acme contract</strong>
    <p style="margin: 4px 0 0; color: var(--md-sys-color-on-surface-variant);">Renewal due in 5 days</p>
  </md-card>
  <md-card variant="filled" interactive style="padding: 16px;">
    <strong>Q4 report draft</strong>
    <p style="margin: 4px 0 0; color: var(--md-sys-color-on-surface-variant);">Shared by Alex</p>
  </md-card>
</main>

<md-fab
  icon="add"
  aria-label="New item"
  style="position: fixed; inset-block-end: 16px; inset-inline-end: 16px; z-index: var(--md-sys-z-index-navigation);"
></md-fab>
```

`inset-inline-end` (not `right`) is what keeps the FAB in the correct corner
under `dir="rtl"`.

### 8.5 Destructive confirmation dialog

`md-dialog` traps focus and returns it to the trigger on close — do not add your
own focus management. The error colouring goes through the button's own custom
properties, never a hex.

```html
<md-button id="open-delete" variant="outlined">Delete account</md-button>

<md-dialog id="confirm-delete" headline="Delete account?" icon="warning">
  <p style="margin: 0;">
    This will permanently delete your account and all associated data.
    This action cannot be undone.
  </p>
  <md-button id="cancel-delete" slot="actions" variant="text">Cancel</md-button>
  <md-button
    id="do-delete"
    slot="actions"
    variant="filled"
    style="--md-button-container-color: var(--md-sys-color-error);
           --md-button-label-color: var(--md-sys-color-on-error);"
  >Delete</md-button>
</md-dialog>

<script type="module">
  const dialog = document.getElementById('confirm-delete');
  document.getElementById('open-delete').addEventListener('mdClick', () => dialog.show());
  document.getElementById('cancel-delete').addEventListener('mdClick', () => dialog.close());
  document.getElementById('do-delete').addEventListener('mdClick', () => {
    dialog.close();
    // perform the deletion
  });
</script>
```

If you omit `slot="actions"` entirely, `md-dialog` renders its own Cancel / OK
pair (labels via `cancel-label` / `ok-label`) and closes itself.

### 8.6 Tabbed content page

`md-tab-panels` finds the nearest preceding `md-tabs` (or the one named by
`for`), follows its `mdTabChange`, and wires `aria-controls` /
`aria-labelledby` both ways. **No JavaScript is required**, and `md-tab` has no
`value` or `selected` prop — selection lives on `md-tabs` as `active-tab-index`.

```html
<md-tabs id="profile-tabs" aria-label="Profile sections" active-tab-index="0">
  <md-tab label="Posts"></md-tab>
  <md-tab label="Replies"></md-tab>
  <md-tab label="Likes" badge="3"></md-tab>
</md-tabs>

<md-tab-panels for="profile-tabs">
  <md-tab-panel style="padding: 16px;">
    <p style="margin: 0;">Your posts appear here.</p>
  </md-tab-panel>
  <md-tab-panel style="padding: 16px;">
    <p style="margin: 0;">Your replies appear here.</p>
  </md-tab-panel>
  <md-tab-panel style="padding: 16px;">
    <p style="margin: 0;">Posts you liked appear here.</p>
  </md-tab-panel>
</md-tab-panels>
```

To react to the switch (lazy-loading a panel, for example), listen on the tabs:

```js
document.getElementById('profile-tabs')
  .addEventListener('mdTabChange', (e) => console.log(e.detail.index, e.detail.previousIndex));
```

### 8.7 The full recipe library

Twenty-two more complete screens live in the documentation, each with a live
demo, the full markup, framework tabs, and production notes. When the user's
request matches one of these, read that page (append the slug to
`https://awc-ui.dev/recipes/`) instead of composing from scratch:

| Recipe slug | Screen |
|---|---|
| `two-factor-verification` | OTP entry, resend countdown, backup-codes dialog |
| `kpi-overview` | Stat tiles with sparklines + charts under a range switcher |
| `data-grid-console` | Bulk-action data table: filters, selection, undo |
| `server-fleet-status` | Table of hosts with meters, sparklines, status dots |
| `release-health-drilldown` | Table row → side-sheet master-detail with charts |
| `csv-import-wizard` | Stepper: upload, map columns, validate, import |
| `role-permission-assignment` | Transfer-list permissions with confirm dialog |
| `org-chart-explorer` | Searchable org chart with side-sheet profiles |
| `moderation-queue` | Verdict controls, confidence meter, card queue |
| `checkout-wizard` | Three-step commerce checkout with validation |
| `appointment-booking` | Date + time pickers inside a stepper flow |
| `survey-nps` | Paged survey using every input control |
| `notification-preferences` | Accordion × switch matrix, quiet hours |
| `app-shell` | Responsive rail/bar chrome, SSR-ready, zero CLS |
| `inbox-shell` | Three-zone list + reading-pane layout |
| `mobile-filter-sheet` | Bottom-sheet filters with applied-chip row |
| `product-reviews` | Rating input + per-star meter breakdown |
| `order-tracking` | Shipment timeline stepper with progress meter |
| `portfolio-markets` | Finance charts + holdings table + trade ticket |
| `pricing-page` | Plan cards, billing toggle, comparison table |
| `async-feedback-patterns` | Skeleton/progress/snackbar choreography rules |
| `charts-gallery` | Every chart component, live-retheming palette |

---

## §9 — Universal do's and don'ts

Apply to every component. Component-specific rules live in each manual.

### 9.1 API and styling

| ✅ Do | ❌ Don't |
|---|---|
| Use the custom element directly — it *is* the control, with its own `href` / `type` props | Wrap it in a native `<button>` / `<a>` (§7.3) |
| Set arrays and objects as **JS properties** (`el.items = [...]`) | Pass them as HTML attributes — they won't parse |
| Theme via `--md-<component>-*` properties, then `::part()` | Reach into shadow internals or override `.md-*` classes |
| Change appearance through design tokens (§4.1) | Hardcode hex colors, px spacing, shadows, or font stacks |
| Use `--md-sys-z-index-*` for your own overlays | Invent z-indexes that land under a menu |
| Use logical CSS (`margin-inline-start`, `inset-inline-end`) | Use `margin-left`, `right`, `padding-right` |
| Set `data-density` / `data-theme` / `dir` once, globally | Set them per component unless you mean a local exception |
| Listen to the component's `md*` events | Rely on native `click` — it fires even when the component's `disabled` / `loading` guard suppressed the action |
| Check the manual for the state prop name | Assume `checked`; `md-switch` uses `selected` |
| Render the element, then call its `@Method` | Call `.show()` on an element not yet in the DOM |

Toggling components flip their own state on activation and *then* emit. On
`md-button`, `mdClick` is cancelable — `preventDefault()` on it vetoes the
toggle and any navigation. `mdChange` fires after the flip and is not
cancelable. If a controlled parent rejects a change it must revert the child
explicitly.

`md-button` has a **toggle mode**: set `toggle` and the button flips its own
`selected` on each activation and exposes `aria-pressed`. `selected` is the
state, not the switch — set it for the initial pressed state and read it back
from `mdClick`'s `detail.selected`. Setting `toggle` and then styling
"pressed" yourself, or setting `selected` without `toggle` (which emits no
`aria-pressed` at all), both produce a control that lies to assistive tech.

### 9.2 Content and hierarchy

| ✅ Do | ❌ Don't |
|---|---|
| Use sentence case for all labels | Uppercase or title-case UI text |
| Keep one high-emphasis action per screen region | Compete `filled` buttons against each other |
| Use `soft-disabled` + `md-tooltip` for contextually-unavailable actions | Use `disabled` and remove it from tab order with no explanation |
| Localize every text prop and `aria-label` | Leave default English prop values in a translated app |

**`disabled` vs `soft-disabled`.** Both render the disabled appearance, but
`disabled` also removes the control from the tab order, so a keyboard or screen
reader user can never find out *why* it is off. `soft-disabled` keeps the
control focusable and announced while still blocking activation — which is what
lets an `md-tooltip` on it explain the gate. Use it whenever the reason is
informative rather than obvious.

Nesting rules — dialog inside a dialog, a component inside a native
`<button>` / `<a>`, tabs used as app navigation — live in §7.3.

### 9.3 Accessibility contract

The library ships WCAG 2.1 AA keyboard and ARIA wiring by default. These are the
rules you must not break:

1. **Every icon-only control gets an accessible name.** `md-icon-button`,
   `md-fab`, and icon-only `md-tab` are nameless without `aria-label` (or
   `aria-labelledby`). `md-fab` will also accept `label`, and warns in the
   console when it has neither.
2. **Every form field gets a `label` prop.** `placeholder` is not a label — it
   disappears on type.
3. **Don't break the tab order.** Every interactive control must be reachable by
   Tab and operable by Enter/Space. If you add `tabindex="-1"` to anything,
   have a reason.
4. **Don't write your own focus trap.** `md-dialog`, `md-bottom-sheet` and
   `md-side-sheet` trap focus while open and restore it to the trigger on
   close — including across shadow boundaries. Adding your own fights theirs.
5. **Don't wrap components in your own live regions.** `md-snackbar` announces
   itself (`politeness="polite"` by default, `"assertive"` when the message must
   interrupt). For an error that blocks the task, use `md-dialog`.
6. **Don't disable motion yourself.** Components honour
   `prefers-reduced-motion: reduce` internally.
7. **Directional icons do not auto-flip in RTL** — see §4.5.
8. **Re-verify contrast after overriding any colour role** — the library's AA
   testing covers the shipped palette only. The Theme Generator at
   <https://awc-ui.dev/theme-generator> runs the WCAG checks live (§4.2).

---

## §10 — Before you ship

1. **Every icon-only control has an accessible name.**
2. **Keyboard-only pass**: reach and operate every control; focus is always
   visible; no traps in dialogs/menus/sheets; focus returns to the trigger.
3. **Theme pass**: light *and* dark, if both are supported — and the attribute
   is set before first paint.
4. **RTL pass**, if an RTL locale ships — check directional icons specifically,
   and grep your own CSS for physical properties.
5. **Density pass** at the configured rung — no clipped labels, touch targets
   still adequate. Remember `density="0"` is inert; use
   `--md-sys-density-scale: 0` to opt a subtree out.
6. **Forms**: every control has a `name`; `required` blocks submit; `FormData`
   contains every field; reset works.
7. **No hardcoded strings** left in markup if the app is localized — including
   default prop values like `Search`, `Dismiss`, `No results`.
8. **No hardcoded design values** — grep the diff for hex colours, `px` radii,
   `box-shadow`, and `z-index` literals.
9. **Contrast** re-verified against AA if colour roles were overridden.
10. **SSR**: if server-rendered, confirm no hydration mismatch and that content
    is present with JS disabled.
11. **No shadow-internal CSS** — only tokens, custom properties, and `::part()`.
12. **Every `md-*` tag you emitted appears in §6.** If it doesn't, it doesn't
    exist.