Bulk action bar · batches of 100
Select a page, then “select all 2,131 matching”. The frontend splits the run into batches of 100 (T003 #13): batch progress, Stop after this batch, partial failure with the failed ids and a retry, and only the bulk verbs the role holds.
Covers: action-bar primitive, action-bar designer, bulk-bar designer. Exports: BulkBar.
Anatomy
The component as it sits in the product: English, compact, real data shapes.
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
3 selectedon this pagePrintCompleteData ExportClear
States
8 states, left to right, top to bottom. A mock poll never finishes, so each state is drawn on purpose.
rows selected
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
3 selectedon this pagePrintCompleteData ExportClear
page selected → select all
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
50 selectedthis pagePrintCompleteData ExportClear
all matching selected
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
2,131 selectedall matching · 43 pagesPrintCompleteData ExportClear
running · batch 4 of 22
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
2,131 selectedCompletebatch 4 of 22 · 100 per request300 of 2,131Stop after this batch
stopped after a batch
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
Stopped after batch 6600 of 2,131 completedResume remaining 1,531Close
partial failure · retry 7
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
Complete22 of 22 batches2,124 done · 7 failedRetry 7Show failures
batch failed
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
Batch 1 failed500 from the server; nothing was changedRetryClose
done
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
2,131 orders completed22 batches · 1 min 48 sUndo not available: completion is final
Density
The phone shell is always comfortable (POWERUPS #15): 44px tap targets, 16px inputs. Compact exists on desktop only; see the desktop page.
comfortable · phone default
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
3 selectedon this pagePrintCompleteData ExportClear
English · 中文
Staff pick en or cn (T001 Q25). Labels arrive localised; CJK falls back to PingFang SC / Noto Sans SC.
en
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
3 selectedon this pagePrintCompleteData ExportClear
中文 · lang=zh-Hans
4528 · J. OkaforHarrow & Vale · 两件套JATR可以下单加急
4527 · R. LindqvistAtelier North · 衬衫 ×2SHSH可以下单
已选 3 项本页打印完成数据导出清除
Long string · permission denied
The long-string case (PL-063) and what a role without the permission sees (the server decides; T003).
long string
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
3 selectedPrint: Markup · Order · QC Tags · Shirt Tags · Buying Sheet · Single Buying SheetData ExportClear
permission denied
4528 · J. OkaforHarrow & Vale · 2-PieceJATRReady For FulfilmentUrgent
4527 · R. LindqvistAtelier North · Shirt ×2SHSHReady For Fulfilment
12 selectedData ExportClear
Only the bulk verbs the role holds: no Print (print orders), no Complete (edit orders).Contract
The @rj/admin-kit API for this family. Mirrored in CONTRACT.md.
- Export
BulkBar·@rj/admin-kit- Props
selected·matching·actions(filtered by permission) ·batchSize100 ·run- States
- idle · page-selected · all-selected · running · stopping · stopped · partial · failed · done
- shadcn / Radix
- Progress · DropdownMenu (Print ▾)
- Package underneath
- TanStack row selection · zustand (selection across pages) · sequential useMutation runner
- Accessibility
- progress is a live region (polite); Stop is reachable by keyboard while running
- API operations
- admin.accounts.bulk-permissions (dry_run) · admin.api-keys.bulk-revoke · admin.accessory-codes.bulk · orders Complete = POST orders/completed in batches (proposal)
- Phone variant
- long-press to select; bar docks at the bottom