Check matrix
A grid of checkboxes: things in rows grouped by area, options in columns. The header and the first column stay in place while the box scrolls, and each area has one checkbox per column for all of it.
Usage
Use it when
- Permissions by role: which roles can invite people, see billing, export reports.
- Notifications by channel: which events reach email, push and SMS.
- Any yes or no decision for each pair of two short lists (features per plan in an admin, courses per study program).
Use something else when
- A few independent options for one thing: use Checkbox.
- Settings that take effect at once, one per row: use Switch.
- Plans compared on a pricing page, read only: use Compare table.
- Records with values, not choices: use Data table.
Where it goes. Full width of the content column, inside .matrix-box. Give the box a height (--h) when the rows run long so the header stays visible; on phones it scrolls sideways with the first column pinned. Save changes with a button next to it when the choices are costly; otherwise save each change and confirm with a toast.
Examples
| Permission | Owner lock | Admin | Editor | Viewer |
|---|---|---|---|---|
| People | ||||
| Invite peopleSend invites by email | ||||
| Change rolesPromote or demote members | ||||
| Remove people | ||||
| Billing | ||||
| See invoices | ||||
| Change the planUpgrades bill at once | ||||
| Reports | ||||
| View dashboards | ||||
| Export dataCSV and PDF |
<div class="matrix-box" tabindex="0" role="region" aria-label="Permissions by role, scrolls" style="--h: 360px;">
<table class="matrix" data-lds-matrix>
<caption class="sr-only">Permissions by role</caption>
<thead><tr><th scope="col">Permission</th><th scope="col">Owner <span class="ic" aria-label="Locked">lock</span></th><th scope="col">Admin</th><th scope="col">Editor</th><th scope="col">Viewer</th></tr></thead>
<tbody>
<tr class="matrix__group" data-group="people"><th scope="rowgroup">People</th><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All People permissions for Owner"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All People permissions for Admin"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All People permissions for Editor"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All People permissions for Viewer"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="people"><th scope="row">Invite people<span class="matrix__sub">Send invites by email</span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: Invite people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Admin: Invite people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Editor: Invite people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Viewer: Invite people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="people"><th scope="row">Change roles<span class="matrix__sub">Promote or demote members</span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: Change roles"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Admin: Change roles"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Editor: Change roles"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Viewer: Change roles"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="people"><th scope="row">Remove people<span class="matrix__sub"></span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: Remove people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Admin: Remove people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Editor: Remove people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Viewer: Remove people"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr class="matrix__group" data-group="billing"><th scope="rowgroup">Billing</th><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Billing permissions for Owner"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Billing permissions for Admin"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Billing permissions for Editor"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Billing permissions for Viewer"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="billing"><th scope="row">See invoices<span class="matrix__sub"></span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: See invoices"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Admin: See invoices"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Editor: See invoices"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Viewer: See invoices"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="billing"><th scope="row">Change the plan<span class="matrix__sub">Upgrades bill at once</span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: Change the plan"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Admin: Change the plan"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Editor: Change the plan"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Viewer: Change the plan"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr class="matrix__group" data-group="reports"><th scope="rowgroup">Reports</th><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Reports permissions for Owner"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Reports permissions for Admin"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Reports permissions for Editor"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" data-lds-matrix-all aria-label="All Reports permissions for Viewer"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="reports"><th scope="row">View dashboards<span class="matrix__sub"></span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: View dashboards"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Admin: View dashboards"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Editor: View dashboards"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Viewer: View dashboards"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr data-group="reports"><th scope="row">Export data<span class="matrix__sub">CSV and PDF</span></th><td><label class="check"><input type="checkbox" checked disabled aria-label="Owner: Export data"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Admin: Export data"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Editor: Export data"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Viewer: Export data"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
</tbody>
</table>
</div>| Event | Push | |
|---|---|---|
| Mentions | ||
| Assigned to me | ||
| Weekly summary |
<div class="matrix-box" tabindex="0" role="region" aria-label="Notifications by channel, scrolls" style="max-width: 520px;">
<table class="matrix" data-lds-matrix style="--min: 420px; --first: 180px; --col: 88px;">
<caption class="sr-only">Notifications by channel</caption>
<thead><tr><th scope="col">Event</th><th scope="col">Email</th><th scope="col">Push</th></tr></thead>
<tbody>
<tr><th scope="row">Mentions</th><td><label class="check"><input type="checkbox" checked aria-label="Email: Mentions"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" checked aria-label="Push: Mentions"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr><th scope="row">Assigned to me</th><td><label class="check"><input type="checkbox" checked aria-label="Email: Assigned to me"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Push: Assigned to me"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
<tr><th scope="row">Weekly summary</th><td><label class="check"><input type="checkbox" checked aria-label="Email: Weekly summary"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td><td><label class="check"><input type="checkbox" aria-label="Push: Weekly summary"><span class="check__box" aria-hidden="true"><svg viewBox="0 0 14 14"><path class="tick" d="M2.5 7.4 L5.7 10.4 L11.5 3.8"></path><path class="dash" d="M3 7 L11 7"></path></svg></span></label></td></tr>
</tbody>
</table>
</div>Anatomy
| Part | What it is |
|---|---|
.matrix-box | Required. The scroll box: white, ring, large radius. --h sets a max height. Give it tabindex="0", role="region" and an aria-label so keyboard users can scroll it. |
table.matrix[data-lds-matrix] | Required. A real table with a caption (can be sr-only). --min sets the width under which it scrolls (560 px), --first the first column (220 px), --col each option column (112 px). |
thead th | The options (roles, channels), sticky at the top on the quiet fill. .matrix__sub under a name for a count. |
tr.matrix__group[data-group] | An area heading row: th[scope=rowgroup] and one input[data-lds-matrix-all] per column. |
tr[data-group] > th[scope=row] | Required. The thing being decided, sticky on the left, with an optional .matrix__sub line. |
td > .check | Required. One checkbox per cell with an aria-label that names both ("Admin: Invite people"). The whole cell is the target. |
Variants and sizes
| Class or attribute | When |
|---|---|
--h on .matrix-box | A max height: the box scrolls vertically and the header sticks. |
--min / --first / --col on .matrix | Widths: below --min the box scrolls sideways with the first column pinned. |
States
| State | How |
|---|---|
checked / unchecked | The checkbox tick draws in on change. |
mixed | An area box shows the dash (.check.is-mixed, indeterminate) when only some cells in its column are on. |
locked | disabled on a cell (a role nobody may change); say why in the header (a lock icon with a label) or a note. |
changed | .is-changed on a cell (its td) not saved yet: an accent ring around the box. Clear it after saving. |
new column | .is-new on the cells of a column just added: they glow on the accent tint once. |
hover | The row tints on pointer devices so the eye can follow it across. |
Motion and microinteractions
- Ticks draw in on
--ease-enter(260 ms) and out on--ease-exit(160 ms), as the checkbox does; an area tick runs every box in its column at once, no stagger. - A new column glows on the accent tint and fades out over 1600 ms on
--ease-standard, once. - Row hover tints in 60 ms linear. The sticky header and column do not move.
- Reduced motion: no glow; ticks still change.
Accessibility
- It is a real
table: options areth[scope=col], things areth[scope=row], areasth[scope=rowgroup], with acaption. - Every checkbox has an
aria-labelthat names the row and the column ("Admin: Invite people"); area boxes say "All People permissions for Admin". - The box is focusable with a label so keyboard users can scroll it; Tab moves through the checkboxes in reading order and Space ticks.
- A locked column says so in words, not only by dimming.
Do and don't
Do
- Group rows by area when there are more than eight.
- Pin the first column and the header; keep column names short.
- Show what is not saved yet and offer Discard next to Save.
Don't
- Use switches in the cells; a grid of switches reads as noise.
- Put more than about eight columns; split the decision instead.
- Hide locked cells; show them ticked and dimmed so the rule is visible.
Behavior and code
Plain HTML. data-lds-matrix on the table: area boxes tick or clear their column in that area and show mixed, checked or disabled from their cells; a lds:change event (bubbles) carries { input, changed } after each change by a person. After changing cells from code, call matrixRefresh(table).