Docs: Add "Frontend Focus Management" to Repository Guidelines

Signed-off-by: Michael Mayer <michael@photoprism.app>
This commit is contained in:
Michael Mayer 2025-11-11 03:26:54 +01:00
parent 326de57fd8
commit d391f834b1

View file

@ -1,6 +1,6 @@
# PhotoPrism® Repository Guidelines
**Last Updated:** November 2, 2025
**Last Updated:** November 11, 2025
## Purpose
@ -220,6 +220,12 @@ Note: Across our public documentation, official images, and in production, the c
> Remember to update the `**Last Updated:**` line at the top whenever you edit these guidelines or other files containing a timestamp.
### Frontend Focus Management
- Dialogs must follow the shared focus pattern documented in `frontend/src/common/README.md`.
- Always expose `ref="dialog"` on `<v-dialog>` overlays, call `$view.enter/leave` in `@after-enter` / `@after-leave`, and avoid positive `tabindex` values.
- When a dialog opens nested menus (for example, combobox suggestion lists), ensure they work with the global trap; see the README for troubleshooting tips.
## Safety & Data
- Never commit secrets, local configurations, or cache files. Use environment variables or a local `.env`.