<ul class="cap-rows" data-cap="row-list" role="list" aria-labelledby="s-long" id="list-long">
<li class="cap-row">
<span class="cap-row-status" id="l1-s"><span class="cap-status" data-tone="info"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true"><rect x="1.5" y="1.5" width="13" height="13" rx="2" fill="none" stroke="currentColor" stroke-width="1.6" /><path fill="currentColor" d="M7.2 7h1.6v5H7.2zM7.2 4h1.6v1.7H7.2z" /></svg>Notice</span></span>
<div class="cap-row-title"><a href="#mention" aria-describedby="l1-s l1-d" id="long-title">A mention on a reading list about the spring survey, its sampling and counting rules, the 2019 field notes paper, and why the measured numbers in that paper disagree with the model by a factor of two, and what the second team found when it counted them again with the same tally sheet, the same plots and a fresh count every time</a></div>
<p class="cap-row-detail" id="l1-d">From a blog that has linked here three times this year, each time with a long excerpt and a request to reply</p>
<span class="cap-row-meta"><time datetime="2026-09-30T08:00Z">6 hours ago</time></span>
</li>
</ul>
The list's name: the heading id that names it (preferred), or a label.
label
string
primary
boolean
The page's main list: j and k work on it even before focus is inside it. One per page.
gap
"sm" | "xs" | "default"
shadcn's ItemGroup gap: separate the rows (use with variant "outline" or "muted" on the rows).
children
ReactNode
Yes
Row
Prop
Type
Required
Does
title
ReactNode
Yes
href
string
The row opens its detail by following href (a link), or by calling onOpen (a button) when the detail opens in place, such as a side panel. With neither, the row is read, not opened (a checklist step, a fact): its title is plain text, and only its actions are controls.
onOpen
() => void
status
ReactNode
A status (.cap-status: glyph, word and color), shown first.
detail
ReactNode
meta
ReactNode
The time or other trailing fact, usually a .cap-time.
actions
ReactNode
Real buttons, raised above the stretched link.
tone
"crit"
variant
"outline" | "muted"
shadcn's Item variants and sizes: "outline" draws the row's edge, "muted" tints it.
size
"sm" | "xs"
media
ReactNode
shadcn's ItemMedia, shown in the first column instead of a status: an icon or a picture.
mediaVariant
"icon" | "image"
expanded
boolean
A row that opens in place (a group of like rows): its button reports aria-expanded and names what it controls, and a chevron after the time turns when it is open.
controls
string
className
string
A class a composing component adds to the row (the attention list's cap-attention-child).
renderLink
(props: RowLinkProps) => ReactNode
A router's link component; a plain <a> by default.
reply
ReactNode
A reply opened in the row (an answer to a question, a note that unblocks a job): a RowReply, shown under the row's text across the row, above the stretched link.
RowReply
Prop
Type
Required
Does
label
string
Yes
What the words are for, as the box's label: "Your answer, sent to its driver".
Moves focus to the next (1) or previous (-1) row's title. From outside the list, j starts at the first row and k at the last (the Portal's rule, App.tsx "step"). At either end focus stays where it is. Focus moves without the browser's own scroll, then the row is scrolled the least distance that shows it ("nearest"), as the Portal does: a row already in view does not jump, and the scroller's scroll-padding keeps it clear of a sticky bar. Returns the element focused, or null when nothing moved.
isTypingKey
(e: KeyboardEvent): boolean
A key typed into a field, or with a modifier, is never a list shortcut. A checkbox, a radio or a button is not a field (shortcuts' isTyping), so a list key works from a box a person has just ticked.
listOwnsKeys
(list: HTMLElement): boolean
Whether j and k should act on this list now: focus is in it, or it is the page's primary list and focus is in no other list and no open dialog.
The keys a queue's rows share (approval queue, mentions list, moderation queue): j and k move through list as attachRowList does, and nothing acts on a held key, a key typed into a field, or while single keys are off. Returns true when the key is the caller's to act on (a, r, d, x).
attachRowList
(list: HTMLElement): () => void
Attaches j and k to one list. Returns a function that detaches them. A list already attached (by enhance or by the React wrapper) is left alone, so keys never act twice.
enhance
(root?: ParentNode): () => void
Attaches to every [data-cap="row-list"] under root that is not attached yet. Returns a function that detaches them all.
Parts and data attributes
Class
Is
.cap-row-chevron
its own class
.cap-row-media
its own class
.cap-row-reply
its own class
.cap-row-reply-actions
its own class
.cap-row-reply-form
its own class
.cap-row-text
its own class
.cap-rows
the root
Attribute
Values
data-gap
smxs
data-size
smxs
data-static
present or absent
data-tone
crit
data-variant
iconimagemutedoutline
State
Read from
:focus-visible
the platform
:hover
the platform
[aria-expanded="true"]
an attribute
Accessibility
Key
Does
Tab
Moves to the next row's title, then into that row's actions, if any
j
Moves focus to the next row's title (from outside the primary list, to its first row)
k
Moves focus to the previous row's title (from outside the primary list, to its last row)
Enter
Follows the focused row's link, or presses its button
Enter or Space on a group row's button
Shows or hides the rows it holds
A reply opens in its row (reply, with RowReply): answering a question or saying what unblocked a job happens where the row is, not on another page. The box is labeled for what the words are for ("Your answer, sent to its driver"), takes focus when it opens, says why an empty or refused reply was not sent (announced), sends on Ctrl or Cmd+Enter (not during an IME composition) and cancels on Esc. It sits under the row's text, across the row and above the stretched link.
A ul with role="list": Safari drops list semantics from a list with list-style: none otherwise.
The list is named by the heading above it (aria-labelledby).
One focus indicator, on the row, as an outline, so it survives forced colors; the critical edge turns CanvasText there.
The stretched hit area makes the whole row at least --target high.