mcp/carbon-components-svelte
1
0
Fork 0
mirror of https://github.com/carbon-design-system/carbon-components-svelte.git synced 2025-09-14 09:51:36 +00:00
Code Issues Projects Releases Packages Wiki Activity

fix(combo-box): address accessibility issues (#2186)

Browse source 
Supports #2172
This commit is contained in:
Eric Liu 2025-08-19 10:35:18 -07:00 • committed by GitHub
commit 2fc884caca
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 49 additions and 57 deletions
Download patch file Download diff file Expand all files Collapse all files

23
src/ComboBox/ComboBox.svelte
View file

@ -116,7 +116,6 @@
import WarningFilled from "../icons/WarningFilled.svelte";
import WarningAltFilled from "../icons/WarningAltFilled.svelte";
import ListBox from "../ListBox/ListBox.svelte";
import ListBoxField from "../ListBox/ListBoxField.svelte";
import ListBoxMenu from "../ListBox/ListBoxMenu.svelte";
import ListBoxMenuIcon from "../ListBox/ListBoxMenuIcon.svelte";
import ListBoxMenuItem from "../ListBox/ListBoxMenuItem.svelte";
@ -254,22 +253,12 @@
{warn}
{warnText}
>
<ListBoxField
role="button"
aria-expanded={open}
on:click={async () => {
if (disabled) return;
open = true;
await tick();
ref.focus();
}}
{id}
{disabled}
{translateWithId}
>
<div class:bx--list-box__field={true}>
<input
bind:this={ref}
bind:value
type="text"
role="combobox"
tabindex="0"
autocomplete="off"
aria-autocomplete="list"
@ -287,6 +276,10 @@
class:bx--text-input={true}
class:bx--text-input--light={light}
class:bx--text-input--empty={value === ""}
on:click={() => {
if (disabled) return;
open = true;
}}
on:input={({ target }) => {
if (!open && target.value.length > 0) {
open = true;
@ -384,7 +377,7 @@
{translateWithId}
{open}
/>
</ListBoxField>
</div>
{#if open}
<ListBoxMenu aria-label={ariaLabel} {id} on:scroll bind:ref={listRef}>
{#each filteredItems as item, i (item.id)}

83
tests/ComboBox/ComboBox.test.ts
View file

@ -4,6 +4,7 @@ import ComboBox from "./ComboBox.test.svelte";
import ComboBoxCustom from "./ComboBoxCustom.test.svelte";
describe("ComboBox", () => {
const getInput = () => screen.getByRole("combobox");
const getClearButton = () =>
screen.getByRole("button", { name: "Clear selected item" });
@ -15,15 +16,13 @@ describe("ComboBox", () => {
render(ComboBox);
expect(screen.getByText("Contact")).toBeInTheDocument();
const input = screen.getByRole("textbox");
expect(input).toHaveAttribute("placeholder", "Select contact method");
expect(getInput()).toHaveAttribute("placeholder", "Select contact method");
});
it("should open menu on click", async () => {
render(ComboBox);
const input = screen.getByRole("textbox");
await user.click(input);
await user.click(getInput());
const dropdown = screen.getAllByRole("listbox")[1];
expect(dropdown).toBeVisible();
@ -33,20 +32,20 @@ describe("ComboBox", () => {
const consoleLog = vi.spyOn(console, "log");
render(ComboBox);
await user.click(screen.getByRole("textbox"));
await user.click(getInput());
await user.click(screen.getByText("Email"));
expect(consoleLog).toHaveBeenCalledWith("select", {
selectedId: "1",
selectedItem: { id: "1", text: "Email" },
});
expect(screen.getByRole("textbox")).toHaveValue("Email");
expect(getInput()).toHaveValue("Email");
});
it("should handle keyboard navigation", async () => {
render(ComboBox);
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
await user.keyboard("{ArrowDown}");
await user.keyboard("{Enter}");
@ -66,7 +65,7 @@ describe("ComboBox", () => {
await user.click(getClearButton());
expect(consoleLog).toHaveBeenCalledWith("clear", expect.any(String));
expect(screen.getByRole("textbox")).toHaveValue("");
expect(getInput()).toHaveValue("");
});
it("should handle clear selection via keyboard navigation (Enter)", async () => {
@ -79,7 +78,7 @@ describe("ComboBox", () => {
});
expect(consoleLog).not.toHaveBeenCalled();
expect(screen.getByRole("textbox")).toHaveValue("Email");
expect(getInput()).toHaveValue("Email");
const clearButton = getClearButton();
clearButton.focus();
@ -87,7 +86,7 @@ describe("ComboBox", () => {
await user.keyboard("{Enter}");
expect(consoleLog).toHaveBeenCalledWith("clear", expect.any(String));
expect(screen.getByRole("textbox")).toHaveValue("");
expect(getInput()).toHaveValue("");
});
it("should handle clear selection via keyboard navigation (Space)", async () => {
@ -100,7 +99,7 @@ describe("ComboBox", () => {
});
expect(consoleLog).not.toHaveBeenCalled();
expect(screen.getByRole("textbox")).toHaveValue("Email");
expect(getInput()).toHaveValue("Email");
const clearButton = getClearButton();
clearButton.focus();
@ -108,7 +107,7 @@ describe("ComboBox", () => {
await user.keyboard(" ");
expect(consoleLog).toHaveBeenCalledWith("clear", expect.any(String));
expect(screen.getByRole("textbox")).toHaveValue("");
expect(getInput()).toHaveValue("");
});
it("should use custom translations when translateWithId is provided", () => {
@ -134,7 +133,7 @@ describe("ComboBox", () => {
it("should handle disabled state", () => {
render(ComboBox, { props: { disabled: true } });
expect(screen.getByRole("textbox")).toBeDisabled();
expect(getInput()).toBeDisabled();
expect(screen.getByText("Contact")).toHaveClass("bx--label--disabled");
});
@ -181,7 +180,7 @@ describe("ComboBox", () => {
it("should handle light variant", () => {
render(ComboBox, { props: { light: true } });
expect(screen.getByRole("textbox")).toHaveClass("bx--text-input--light");
expect(getInput()).toHaveClass("bx--text-input--light");
});
test.each([
@ -195,7 +194,7 @@ describe("ComboBox", () => {
it("should handle filtering items", async () => {
render(ComboBox);
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
await user.type(input, "em");
@ -229,21 +228,21 @@ describe("ComboBox", () => {
expect(consoleLog).not.toBeCalled();
await user.click(getClearButton());
expect(screen.getByRole("textbox")).toHaveValue("");
expect(getInput()).toHaveValue("");
expect(consoleLog).toHaveBeenCalledWith("clear", "clear");
});
it("should handle disabled items", async () => {
render(ComboBoxCustom);
await user.click(screen.getByRole("textbox"));
await user.click(getInput());
const disabledOption = screen.getByText(/Fax/).closest('[role="option"]');
assert(disabledOption);
expect(disabledOption).toHaveAttribute("disabled", "true");
expect(disabledOption).toHaveAttribute("aria-disabled", "true");
await user.click(disabledOption);
expect(screen.getByRole("textbox")).toHaveValue("");
expect(getInput()).toHaveValue("");
// Dropdown remains open
const dropdown = screen.getAllByRole("listbox")[1];
@ -253,7 +252,7 @@ describe("ComboBox", () => {
it("should handle custom item display", async () => {
render(ComboBoxCustom);
await user.click(screen.getByRole("textbox"));
await user.click(getInput());
const options = screen.getAllByRole("option");
expect(options[0]).toHaveTextContent("Item Slack");
@ -272,19 +271,18 @@ describe("ComboBox", () => {
render(ComboBoxCustom, { props: { selectedId: "1" } });
await user.click(getClearButton());
const input = screen.getByRole("textbox");
expect(input).toHaveValue("");
expect(getInput()).toHaveValue("");
});
it("should programmatically clear selection", async () => {
render(ComboBoxCustom, { props: { selectedId: "1" } });
const textbox = screen.getByRole("textbox");
expect(textbox).toHaveValue("Email");
const input = getInput();
expect(input).toHaveValue("Email");
await user.click(screen.getByText("Clear"));
expect(textbox).toHaveValue("");
expect(textbox).toHaveFocus();
expect(input).toHaveValue("");
expect(input).toHaveFocus();
});
it("should not re-focus textbox if clearOptions.focus is false", async () => {
@ -295,19 +293,20 @@ describe("ComboBox", () => {
},
});
const textbox = screen.getByRole("textbox");
expect(textbox).toHaveValue("Email");
const input = getInput();
expect(input).toHaveValue("Email");
await user.click(screen.getByText("Clear"));
expect(textbox).toHaveValue("");
expect(textbox).not.toHaveFocus();
expect(input).toHaveValue("");
expect(input).not.toHaveFocus();
});
it("should close menu on Escape key", async () => {
render(ComboBox);
expect(screen.getByRole("textbox")).toHaveValue("");
expect(getInput()).toHaveValue("");
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
const dropdown = screen.getAllByRole("listbox")[1];
@ -315,8 +314,8 @@ describe("ComboBox", () => {
await user.keyboard("{Escape}");
expect(dropdown).not.toBeVisible();
expect(screen.getByRole("textbox")).toHaveValue("");
expect(screen.getByRole("textbox")).toHaveFocus();
expect(getInput()).toHaveValue("");
expect(getInput()).toHaveFocus();
});
it("should close menu and clear selection on Escape key", async () => {
@ -327,9 +326,9 @@ describe("ComboBox", () => {
},
});
expect(screen.getByRole("textbox")).toHaveValue("Email");
expect(getInput()).toHaveValue("Email");
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
const dropdown = screen.getAllByRole("listbox")[1];
@ -337,8 +336,8 @@ describe("ComboBox", () => {
await user.keyboard("{Escape}");
expect(dropdown).not.toBeVisible();
expect(screen.getByRole("textbox")).toHaveValue("");
expect(screen.getByRole("textbox")).toHaveFocus();
expect(getInput()).toHaveValue("");
expect(getInput()).toHaveFocus();
});
it("should use custom shouldFilterItem function", async () => {
@ -353,7 +352,7 @@ describe("ComboBox", () => {
item.text.startsWith(value),
},
});
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
await user.type(input, "B");
const options = screen.getAllByRole("option");
@ -371,7 +370,7 @@ describe("ComboBox", () => {
itemToString: (item: { text: string }) => `Item ${item.text}`,
},
});
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
const options = screen.getAllByRole("option");
expect(options[0]).toHaveTextContent("Item Apple");
@ -395,7 +394,7 @@ describe("ComboBox", () => {
],
},
});
const input = screen.getByRole("textbox");
const input = getInput();
await user.click(input);
await user.keyboard("{ArrowDown}"); // should highlight A
await user.keyboard("{ArrowDown}"); // should skip B and highlight C
@ -417,7 +416,7 @@ describe("ComboBox", () => {
render(ComboBox);
await user.keyboard("{Tab}");
expect(screen.getByRole("textbox")).toHaveFocus();
expect(getInput()).toHaveFocus();
const dropdown = screen.queryAllByRole("listbox")[1];
expect(dropdown).toBeUndefined();