Ir para o conteúdo
DevFlash

Júnior

Abas que funcionam com teclado

O padrão de abas do guia ARIA: papéis, tabindex itinerante e setas do teclado.

GrátisJúnior~30 min

Este desafio está em revisão editorial.

Por que cai em entrevista

As perguntas de acessibilidade estão saindo do "você conhece ARIA?" para o "construa este componente para funcionar sem mouse". Abas são as favoritas porque o padrão é bem documentado e fácil de acertar quase tudo.

É no quase que o candidato perde pontos: foco que não acompanha a seleção, todas as abas alcançáveis com Tab, ou painel sem ligação com a aba. Este exercício confere cada um desses detalhes com testes, do jeito que um avaliador faria.

O que você vai construir

  1. As abas são botões com role="tab" dentro de um role="tablist"; o conteúdo fica num role="tabpanel".
  2. A primeira aba começa selecionada (aria-selected="true"); as outras ficam "false".
  3. Clicar numa aba seleciona e mostra o conteúdo dela.
  4. ArrowRight e ArrowLeft movem seleção e foco, dando a volta nas duas pontas.
  5. Home e End vão para a primeira e a última aba.
  6. Só a aba selecionada tem tabindex="0"; as outras têm "-1".
  7. O aria-labelledby do painel aponta para a aba selecionada, e o aria-controls da aba aponta para o painel.

Fora do escopo: Ativação manual (selecionar só com Enter). Abas verticais.

Como você será avaliado

Passar nos testes é o começo. Na conversa depois, uma boa explicação cobre:

  • Explica o tabindex itinerante e por que as outras abas recebem -1.
  • Diz como o foco acompanha a seleção.
  • Fala de ativação automática versus manual e quando cada uma serve.

Código inicial

/src/Tabs.tsx

type Tab = { id: string; label: string; content: string };
export function Tabs({ tabs }: { tabs: Tab[] }) {
// implemente aqui
return (
<div>
{tabs.map((tab) => <button key={tab.id} type="button">{tab.label}</button>)}
<div>{tabs[0].content}</div>
</div>
);
}
Ver os testes que vão rodar /src/Tabs.test.tsx
import "@testing-library/jest-dom";
import { render, screen, fireEvent } from "@testing-library/react";
import { Tabs } from "./Tabs";
const TABS = [
{ id: "a", label: "Alpha", content: "First panel" },
{ id: "b", label: "Beta", content: "Second panel" },
{ id: "c", label: "Gamma", content: "Third panel" },
];
const tab = (name: string) => screen.getByRole("tab", { name });
const press = (name: string, key: string) => fireEvent.keyDown(tab(name), { key });
describe("Tabs", () => {
it("selects the first tab by default", () => {
render(<Tabs tabs={TABS} />);
expect(tab("Alpha")).toHaveAttribute("aria-selected", "true");
expect(tab("Beta")).toHaveAttribute("aria-selected", "false");
expect(screen.getByRole("tabpanel")).toHaveTextContent("First panel");
});
it("shows the content of a clicked tab", () => {
render(<Tabs tabs={TABS} />);
fireEvent.click(tab("Gamma"));
expect(tab("Gamma")).toHaveAttribute("aria-selected", "true");
expect(screen.getByRole("tabpanel")).toHaveTextContent("Third panel");
});
it("moves selection and focus with the arrow keys", () => {
render(<Tabs tabs={TABS} />);
press("Alpha", "ArrowRight");
expect(tab("Beta")).toHaveAttribute("aria-selected", "true");
expect(tab("Beta")).toHaveFocus();
});
it("wraps around at both ends", () => {
render(<Tabs tabs={TABS} />);
press("Alpha", "ArrowLeft");
expect(tab("Gamma")).toHaveAttribute("aria-selected", "true");
press("Gamma", "ArrowRight");
expect(tab("Alpha")).toHaveAttribute("aria-selected", "true");
});
it("jumps to the first and last tab with Home and End", () => {
render(<Tabs tabs={TABS} />);
press("Alpha", "End");
expect(tab("Gamma")).toHaveFocus();
press("Gamma", "Home");
expect(tab("Alpha")).toHaveFocus();
});
it("keeps only the selected tab in the tab order", () => {
render(<Tabs tabs={TABS} />);
expect(tab("Alpha")).toHaveAttribute("tabindex", "0");
expect(tab("Beta")).toHaveAttribute("tabindex", "-1");
expect(tab("Gamma")).toHaveAttribute("tabindex", "-1");
});
it("links the panel to the selected tab", () => {
render(<Tabs tabs={TABS} />);
fireEvent.click(tab("Beta"));
const panel = screen.getByRole("tabpanel");
expect(panel).toHaveAttribute("aria-labelledby", tab("Beta").id);
expect(tab("Beta")).toHaveAttribute("aria-controls", panel.id);
});
});

Dicas

Abra só se travar. Cada uma entrega um pouco mais.

Dica 1

Guarde um único estado: o índice selecionado. aria-selected, tabindex e o painel saem dele.

Dica 2

Mudar a seleção não basta para quem usa teclado. Guarde refs dos botões e chame focus() no novo.

Referências