One page of one site's mentions, the same in Carrel and in every site admin.
<p>Tabs with the site's counts; <kbd>j</kbd> and <kbd>k</kbd> move, <kbd>a</kbd> approves and <kbd>r</kbd> rejects at once with Undo (<kbd>z</kbd>), <kbd>x</kbd> selects for the bulk bar, and <kbd>d</kbd> deletes after a confirm with the count to type. The sweep shows what the site's retention will remove before it runs.</p>
<div data-mount="editor"></div>
The delivered HTML: what a server sends, before any script runs
<p>Rendered to a string and put in the page as it is, with nothing attached: the tabs and pages are links, a sender's name is a link that opens the mention through the address, each row's decisions are a form of submit buttons, and the bar's actions post the ticked boxes.</p>
<div id="mentions-static"></div>
API reference
MentionsList
Prop
Type
Required
Does
data
MentionsData
Yes
The loader's view data: one page of one site's mentions.
action
string
Yes
Where the forms post, and the list's own address: usually the route itself.
Form
FormComponent
The host router's form component. Without it a plain <form> is rendered.
submit
SubmitIntent
The script path: posts a form and resolves with the action's result (a useFetcher wrapper). With it, a decision happens in place with Undo in the message, and the keys decide.
result
IntentResult | null
The last result from the action, for the page that comes back after a post with no script.
now
number
A fixed "now" for the times, for a test or a server's clock.
Functions
Function
Signature
Does
mentionsHref
(base: string, q: MentionsQuery): string
The list's address with a query (content.ts, queryHref).
The kit's query from the list's address: the list names its tab view, the kit's filter is status. The host hands the answer to site-api's readMentionsQuery.
The kit's page as the list renders it: each mention in the queue's words (the sender's name, the source's host as text, never a link), the counts with All, and what the site offers. Carrel and each site's own admin draw the same page from it.
Parts and data attributes
Class
Is
.cap-mentions
the root
.cap-mentions-act
a part
.cap-mentions-count
a part
.cap-mentions-pages
a part
.cap-mentions-withheld
a part
Accessibility
Key
Does
j, k
Move between the rows
a
Approves the focused row, or the whole selection when the row is part of it
r
Rejects it
d
Deletes it, after the confirm dialog with the count to type
x
Selects or unselects the focused row
z
Undo (the message region's key)
Esc
Clears the selection, from a row or the bulk bar
With script, as the queue's (single keys can be turned off):
The keys do nothing in a text field, with Ctrl, Alt or Meta held, in an open dialog, or when single-key shortcuts are off (the shortcuts switch, data-cap-single-keys="off" on <html>; z is the message region's and follows it too); the hints and aria-keyshortcuts are shown only while the keys work.
The list is a region named by its heading ("Mentions on example.com"); the tabs are a nav of links, the current one with aria-current="page".
Each row's decisions are a form named for its sender ("Decide the mention from Rosa Park"), and each button names the sender too.
The live line is a polite status; the result box and the bar's outcome list are the content components' own.
A status is a shape, a word and a color. Text reaches 4.5:1 and edges 3:1 in both themes.