Задача: доступные табы
На этой странице
Табы — задача на проектирование переиспользуемого компонента: API через compound components (<Tabs>, <Tabs.List>, <Tabs.Tab>, <Tabs.Panel>) с общим состоянием в контексте, controlled и uncontrolled режимы (value/onChange или defaultValue) и доступность по паттерну WAI-ARIA: роли tablist/tab/tabpanel, связи aria-controls/aria-labelledby, roving tabindex (в табах Tab-ом попадаешь только в активную вкладку, а между вкладками двигаешься стрелками), клавиши Home и End.
Вопрос
Реализуйте компонент табов с API на compound components, поддержкой controlled и uncontrolled режимов и полной клавиатурной доступностью.
Решение
import { createContext, useContext, useId, useRef, useState, type ReactNode, type KeyboardEvent } from "react";
type TabsContextValue = {
value: string;
setValue: (v: string) => void;
baseId: string;
};
const TabsContext = createContext<TabsContextValue | null>(null);
function useTabs() {
const ctx = useContext(TabsContext);
if (!ctx) throw new Error("Компоненты Tabs.* должны быть внутри <Tabs>");
return ctx;
}
type TabsProps = {
value?: string; // controlled
defaultValue?: string; // uncontrolled
onChange?: (value: string) => void;
children: ReactNode;
};
export function Tabs({ value: controlled, defaultValue = "", onChange, children }: TabsProps) {
const [inner, setInner] = useState(defaultValue);
const isControlled = controlled !== undefined;
const value = isControlled ? controlled : inner;
const baseId = useId();
const setValue = (next: string) => {
if (!isControlled) setInner(next);
onChange?.(next);
};
return <TabsContext value={{ value, setValue, baseId }}>{children}</TabsContext>;
}
function TabList({ label, children }: { label: string; children: ReactNode }) {
const listRef = useRef<HTMLDivElement>(null);
function onKeyDown(e: KeyboardEvent<HTMLDivElement>) {
const tabs = [...(listRef.current?.querySelectorAll<HTMLButtonElement>('[role="tab"]:not([disabled])') ?? [])];
const index = tabs.indexOf(document.activeElement as HTMLButtonElement);
if (index === -1) return;
const next =
e.key === "ArrowRight" ? tabs[(index + 1) % tabs.length] :
e.key === "ArrowLeft" ? tabs[(index - 1 + tabs.length) % tabs.length] :
e.key === "Home" ? tabs[0] :
e.key === "End" ? tabs[tabs.length - 1] : null;
if (next) {
e.preventDefault();
next.focus();
next.click(); // автоматическая активация при перемещении
}
}
return (
<div ref={listRef} role="tablist" aria-label={label} onKeyDown={onKeyDown}>
{children}
</div>
);
}
function Tab({ value, disabled, children }: { value: string; disabled?: boolean; children: ReactNode }) {
const { value: active, setValue, baseId } = useTabs();
const selected = active === value;
return (
<button
type="button"
role="tab"
id={`${baseId}-tab-${value}`}
aria-selected={selected}
aria-controls={`${baseId}-panel-${value}`}
tabIndex={selected ? 0 : -1} // roving tabindex: в табах Tab-ом попадаешь только в активную
disabled={disabled}
onClick={() => setValue(value)}
>
{children}
</button>
);
}
function Panel({ value, children }: { value: string; children: ReactNode }) {
const { value: active, baseId } = useTabs();
if (active !== value) return null;
return (
<div role="tabpanel" id={`${baseId}-panel-${value}`} aria-labelledby={`${baseId}-tab-${value}`} tabIndex={0}>
{children}
</div>
);
}
Tabs.List = TabList;
Tabs.Tab = Tab;
Tabs.Panel = Panel;Использование
// uncontrolled
<Tabs defaultValue="description">
<Tabs.List label="Информация о товаре">
<Tabs.Tab value="description">Описание</Tabs.Tab>
<Tabs.Tab value="specs">Характеристики</Tabs.Tab>
<Tabs.Tab value="reviews">Отзывы (12)</Tabs.Tab>
</Tabs.List>
<Tabs.Panel value="description">Легкие кроссовки для бега…</Tabs.Panel>
<Tabs.Panel value="specs">Вес: 250 г…</Tabs.Panel>
<Tabs.Panel value="reviews"><Reviews /></Tabs.Panel>
</Tabs>
// controlled — вкладка в URL
const [searchParams, setSearchParams] = useSearchParams();
<Tabs value={searchParams.get("tab") ?? "description"} onChange={(tab) => setSearchParams({ tab })}>
…
</Tabs>Решения в API
| Решение | Зачем |
|---|---|
| compound components + контекст | пользователь управляет разметкой, состояние общее |
value / defaultValue / onChange | работает и как управляемый (URL, store), и как самостоятельный |
useId | уникальные и SSR-стабильные id для ARIA-связей |
| roving tabindex | в табах Tab-ом попадаешь только в активную вкладку, по вкладкам — стрелками |
ошибка вне <Tabs> | понятное сообщение при неправильном использовании |
Доп. вопросы интервьюера
- Скрывать неактивные панели или размонтировать? размонтирование сбрасывает их state и экономит рендер;
hiddenсохраняет state (формы) — выбор по задаче. - Автоматическая или ручная активация? автоматическая — при перемещении стрелками; ручная — стрелки только переводят фокус, а Enter/Space активирует (для тяжелых панелей).
- Как добавить анимацию индикатора? измерить активную вкладку (
getBoundingClientRect) вuseLayoutEffect. - Почему не
<a>для вкладок? если вкладки меняют URL и это навигация — используют ссылки иnav, а не рольtab.
Что важно помнить
role="tablist"сaria-label, у вкладокaria-selectedиaria-controls, у панелейaria-labelledby.- Стрелки, Home, End; Tab ведет из списка вкладок сразу в панель.
- Не смешивайте controlled и uncontrolled режим во время жизни компонента.
- Теория: Compound Components, Control Props, useId.
Мини-шпаргалка
<Tabs> хранит value (controlled или нет) в контексте → Tabs.List (role="tablist", стрелки/Home/End) → Tabs.Tab (role="tab", aria-selected, aria-controls, tabIndex 0/-1) → Tabs.Panel (role="tabpanel", aria-labelledby). useId для связей.
Документация
W3C APG: Tabs Pattern, React: Passing Data Deeply with Context, Radix UI: Tabs.