fix(ui): a reviewed log takes the focus back once, and a dialog's focus survives a Retry

E32 review round 1 (F1, F2).

- Issue composer: the review's focus-return token became state in S4 and was never spent, so every
  Preview → Edit round trip remounted the attachments and moved the focus from the toggle to the
  log's Review button. The token is cleared once it has been used, as the ref was.
- Modal (initialFocus "field"): the late-form watch moved the focus to the first control once and
  stopped. A failed load's Retry then gave way to the spinner, its focus fell to <body> inside the
  aria-modal dialog, and the form's first field never got it. The watch now re-arms when the focus
  falls to <body>: it waits on the ✕ and moves to the first field when the form arrives. Focus in a
  dialog stacked on top is left alone.
This commit is contained in:
2026-10-04 02:29:03 +02:00
parent 38943fa93e
commit e09d613b04
4 changed files with 50 additions and 6 deletions
@@ -539,6 +539,22 @@ describe("the issue composer", () => {
expect(api.saved).toHaveLength(0); // sent: nothing to save, only the rest to send
});
it("returns the focus to a reviewed log once, not on every way back from the preview", async () => {
mount();
fireEvent.click(
(await screen.findAllByRole("button", { name: "recorder.composer.review" }))[0]!,
);
fireEvent.click(screen.getByRole("button", { name: "recorder.composer.reviewDone" }));
const review = screen.getAllByRole("button", { name: "recorder.composer.review" })[0];
expect(document.activeElement).toBe(review);
fireEvent.click(screen.getByRole("button", { name: "recorder.composer.preview" }));
const edit = screen.getByRole("button", { name: "recorder.composer.edit" });
edit.focus();
fireEvent.click(edit);
await screen.findAllByRole("button", { name: "recorder.composer.review" });
expect(document.activeElement).toBe(edit); // the toggle keeps it; the log's button does not take it
});
it("previews through the tracker in a frame where no script runs", async () => {
tracker = { repo: "o/r" };
mount();
+8 -3
View File
@@ -412,6 +412,7 @@ function ComposerBody({
}}
onReview={setReviewing}
reviewed={reviewed}
setReviewed={setReviewed}
/>
</div>
)}
@@ -596,6 +597,7 @@ function Attachments({
onAdd,
onReview,
reviewed,
setReviewed,
}: {
session: DebugSession;
shotsQ: { data?: { items: DebugScreenshot[] }; isError: boolean; refetch: () => unknown };
@@ -605,6 +607,7 @@ function Attachments({
onAdd: (files: Iterable<File>) => void;
onReview: (source: Source) => void;
reviewed: Source | null;
setReviewed: (spent: null) => void;
}) {
const { t, i18n } = useTranslation();
const lang = i18n.language;
@@ -614,10 +617,12 @@ function Attachments({
const pick = useRef<HTMLInputElement>(null);
const reviewButtons = useRef<Partial<Record<Source, HTMLButtonElement | null>>>({});
// On mount after a review closed (this list unmounts while one is open), that log's Review button
// takes the focus back. Only a mount or a new review moves it, so no later render steals it.
// takes the focus back — once: the spent token keeps a later remount (back from the preview) off it.
useEffect(() => {
if (reviewed) reviewButtons.current[reviewed]?.focus();
}, [reviewed]);
if (!reviewed) return;
reviewButtons.current[reviewed]?.focus();
setReviewed(null);
}, [reviewed, setReviewed]);
const remove = useMutation({
mutationFn: (shotId: number) => api.removeDebugScreenshot(session.id, shotId),
meta: { failTitle: "recorder.composer.removeShotFailed" },
@@ -53,6 +53,21 @@ describe("the download-quota editor", () => {
expect(get).toHaveBeenCalledTimes(2);
});
it("gives the first field the focus when the form arrives after a retry", async () => {
// jsdom lays nothing out, so every element reads as hidden to the dialog's focus rules.
vi.spyOn(HTMLElement.prototype, "offsetParent", "get").mockReturnValue(document.body);
vi.spyOn(api, "adminGetDownloadQuota")
.mockRejectedValueOnce(new Error("down"))
.mockResolvedValueOnce(QUOTA as never);
open();
await screen.findByRole("alert");
const retry = screen.getByText("common.retry").closest("button")!;
await waitFor(() => expect(document.activeElement).toBe(retry));
fireEvent.click(retry); // the Retry gives way to the spinner: its focus must not fall to <body>
const first = await screen.findByDisplayValue("5");
await waitFor(() => expect(document.activeElement).toBe(first));
});
it("saves the GB field as bytes, and the reset drops the override", async () => {
vi.spyOn(api, "adminGetDownloadQuota").mockResolvedValue(QUOTA as never);
const set = vi.spyOn(api, "adminSetDownloadQuota").mockResolvedValue(QUOTA as never);
+11 -3
View File
@@ -106,14 +106,22 @@ export default function Modal({
// A form that loads after the dialog opens (the issue composer shows a spinner first) has no field
// to take the focus at open, so it lands on the ✕. When the first control arrives the focus moves
// there — but only while it still rests on the ✕: a user who has moved it keeps it where it is.
// The watch re-arms when the focused control is taken away (a failed load's Retry giving way to
// the spinner again): the focus fell to <body>, so it waits on the ✕ for the form (E32 review).
// Only <body>: focus in a dialog stacked on top is not this one's to take.
useEffect(() => {
const body = bodyRef.current;
if (initialFocus !== "field" || !body || focusablesIn(body).length > 0) return;
let armed = true;
const watch = new MutationObserver(() => {
if (document.activeElement === document.body && closeRef.current) {
closeRef.current.focus();
armed = true;
}
const first = focusablesIn(body)[0];
if (!first) return;
watch.disconnect();
if (document.activeElement === closeRef.current) first.focus();
if (!armed || !first || document.activeElement !== closeRef.current) return;
armed = false;
first.focus();
});
watch.observe(body, { childList: true, subtree: true });
return () => watch.disconnect();