mirror of
https://github.com/Matysh/houseplan-card
synced 2026-10-06 06:38:57 +00:00
Claudeandclaude[bot]
df46fd1c3e
Волна 5 эпика #674, перенос ТЗ (класс C). Из 240 файлов `docs/specs/` в `legacy/specs/` уехали 219: на них не ссылается ни один живой файл (код, тесты, скрипты, workflow, документы вне архива и ревью). Остались 21 ТЗ — на которые ссылаются код, ADR, ISOMETRIC, SUN, RADAR, LIGHT (`docs/specs/067`), DECOR-EDITOR, support-relay, и те, на которые ссылаются они сами; README каталога объясняет, где искать остальное. Открытых issue с файлом ТЗ среди перенесённых нет. Относительные ссылки перенесённых файлов переписаны (`../X` → `../../docs/X`, соседние оставшиеся ТЗ → `../../docs/specs/…`) — все 26 резолвятся. Попутно: битая ссылка в `089-isometric-view-stage1.md:8` на удалённый `089-isometric-view.md` — теперь команда `git show` по истории. Строка в `legacy/README.md`. Issue: #682 User-Visible: no Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018qZfe7YS4rqEMKoVeS3GKd
57 lines
3.3 KiB
Markdown
57 lines
3.3 KiB
Markdown
# ТЗ #31 — Доступная семантика режима View
|
|
|
|
- Issue: https://github.com/Matysh/houseplan-card/issues/31
|
|
- Приоритет: P1
|
|
- Статус ТЗ: draft, требуется UX-проверка screen reader
|
|
- Зависимость: room dialog #28
|
|
|
|
## Цель
|
|
|
|
Обеспечить основные View-сценарии клавиатурой и screen reader без сотен
|
|
tab-stop и без изменения pointer UX.
|
|
|
|
## Рекомендуемая модель
|
|
|
|
Над SVG существует одна визуально скрытая, но screen-reader доступная
|
|
`PlanNavigator`-структура с тремя группами: Комнаты, Устройства, Проёмы.
|
|
Внутри применяется roving tabindex: в общем Tab-порядке одна активная запись,
|
|
стрелки перемещают активную запись, Home/End — края группы, Ctrl+стрелка —
|
|
соседняя группа. SVG shapes остаются `aria-hidden`, чтобы не дублировать дерево.
|
|
|
|
## Accessible projection
|
|
|
|
Один pure resolver создаёт для объекта:
|
|
|
|
- стабильный id и role (`button` для действия, `group` для read-only);
|
|
- label: имя, тип, комната, локализованное состояние, основное действие;
|
|
- description: доступные метрики/предупреждения;
|
|
- action: room dialog, device action/more-info, opening status.
|
|
|
|
`static_icon` влияет на визуал, но accessible label всё равно сообщает реальное
|
|
HA-состояние. Disabled/orphaned объекты явно называются недоступными.
|
|
|
|
## Keyboard и focus lifecycle
|
|
|
|
- Enter/Space активирует основной action; контекстное more-info остаётся
|
|
отдельной подписанной командой в открывшейся карточке.
|
|
- Смена пространства фокусирует PlanNavigator heading, затем первую комнату.
|
|
- Закрытие room/device dialog возвращает фокус на исходную запись.
|
|
- Исчезнувший объект возвращает фокус к ближайшему соседу/заголовку.
|
|
- Kiosk сохраняет доступный View, но editor controls отсутствуют.
|
|
|
|
## Нецветовые состояния
|
|
|
|
Critical alarm получает alert glyph и текст; open/unlocked — outline/glyph;
|
|
mechanical activity — motion glyph/accessible live text. Не добавлять постоянные
|
|
satellite badges каждому marker. `prefers-reduced-motion` отключает pulse, но
|
|
не текстовый state.
|
|
|
|
## Проверки и приёмка
|
|
|
|
- axe: name/role/value, landmark, focus order, dialog boundaries;
|
|
- NVDA/Chrome и TalkBack ручной checklist;
|
|
- keyboard: room, ordinary device, alarm, opening, disabled device;
|
|
- 200 markers дают один Tab entry на plan navigator, не 200;
|
|
- выключенный цвет/анимация не лишает пользователя состояния;
|
|
- pointer hit-testing и golden View не меняются без осознанного glyph delta.
|