Tooltip injects `aria-describedby` into its focusable child (merged with any existing value) instead of a non-focusable wrapper span, and Escape hides the tooltip until the next hover or focus (WCAG 1.4.13). The listener is on the document so a hovered, unfocused trigger closes too. Verified with tests/component/tooltip.test.tsx (RED: 3 of 3 failed before the change) and the lane gates. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
64 lines
1.8 KiB
TypeScript
64 lines
1.8 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { render, screen } from "@testing-library/react";
|
|
import userEvent from "@testing-library/user-event";
|
|
import { describe, expect, it } from "vitest";
|
|
|
|
import { Button, Tooltip } from "../../src/presentation/design-system/index.ts";
|
|
|
|
describe("Tooltip", () => {
|
|
it("describes the focusable trigger itself", async () => {
|
|
const user = userEvent.setup();
|
|
render(
|
|
<>
|
|
<p id="existing-hint">Existing hint</p>
|
|
<Tooltip content="Optional detail">
|
|
<Button aria-describedby="existing-hint">Help</Button>
|
|
</Tooltip>
|
|
</>,
|
|
);
|
|
|
|
await user.tab();
|
|
const trigger = screen.getByRole("button", { name: "Help" });
|
|
expect(trigger).toHaveFocus();
|
|
expect(trigger).toHaveAccessibleDescription("Existing hint Optional detail");
|
|
});
|
|
|
|
it("closes with Escape and opens again on the next focus", async () => {
|
|
const user = userEvent.setup();
|
|
render(
|
|
<>
|
|
<Tooltip content="Optional detail">
|
|
<Button>Help</Button>
|
|
</Tooltip>
|
|
<Button>Elsewhere</Button>
|
|
</>,
|
|
);
|
|
|
|
await user.tab();
|
|
const tooltip = screen.getByRole("tooltip");
|
|
expect(tooltip).toBeVisible();
|
|
|
|
await user.keyboard("{Escape}");
|
|
expect(tooltip).not.toBeVisible();
|
|
expect(screen.getByRole("button", { name: "Help" })).toHaveFocus();
|
|
|
|
await user.tab();
|
|
await user.tab({ shift: true });
|
|
expect(screen.getByRole("tooltip")).toBeVisible();
|
|
});
|
|
|
|
it("closes a hovered tooltip with Escape", async () => {
|
|
const user = userEvent.setup();
|
|
render(
|
|
<Tooltip content="Optional detail">
|
|
<Button>Help</Button>
|
|
</Tooltip>,
|
|
);
|
|
|
|
await user.hover(screen.getByRole("button", { name: "Help" }));
|
|
await user.keyboard("{Escape}");
|
|
expect(screen.getByRole("tooltip", { hidden: true })).not.toBeVisible();
|
|
});
|
|
});
|