astrbot_plugin_imagestudio/docs/ui-redesign-state-matrix-2026-07-21.md

30 行
2 KiB
Markdown

# UI State Matrix
Date: 2026-07-21
Branch: codex/ui-redesign-gallery
## Coverage
| Area | default | hover | focus | selected | disabled | loading | empty | error | success | disconnected |
|---|---|---|---|---|---|---|---|---|---|---|
| Navigation rail | yes | yes | yes | aria-current=page | n/a | n/a | n/a | n/a | n/a | yes |
| Generate composer | yes | yes | yes | mode button | yes | submit text | preview empty | inline error | result card | write blocked |
| Queue | yes | yes | yes | filter/task | action disabled | refresh text | empty state | task error | completed status | read-only |
| Gallery | yes | yes | yes | card/batch | batch disabled | media loading | empty state | media fallback | selection feedback | read-only |
| Profiles | yes | yes | yes | profile/tab | sealed/read-only | pane loading | empty pane | inline error | saved state | read-only |
| Materials | yes | yes | yes | filter/category | permission disabled | operation busy | empty state | action error | operation message | read-only |
| Settings | yes | yes | yes | section/tab | permission disabled | save/reload | missing schema | validation error | saved message | read-only |
| Logs | yes | yes | yes | filter | refresh disabled | load text | empty state | error state | refreshed state | unavailable |
| Workflow | yes | yes | yes | node/candidate | sealed/locked | task progress | candidate empty | node error | adopted state | read-only |
## Keyboard paths
- Global search: focus, ArrowUp/ArrowDown, Enter, Escape.
- Navigation and tabs: Tab, Enter, Space, aria-current/aria-pressed.
- Confirm dialog: Escape, Tab loop, focus return.
- Image preview dialog: Escape, Tab loop, focus return, zoom controls.
- Backend banner: retry is keyboard reachable and status is aria-live.
## Notes
The matrix is backed by shared states in App.vue and feature components. Real backend disconnected states are represented by the existing preview/error/blocked paths; live plugin-host acceptance remains a deployment-bound check.