Files
SHiNE-server/docs/UI-Design/PWA_VIEWPORT_AND_AVATAR_PREVIEW.md
T

22 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PWA: масштабирование страницы и просмотр аватара
## Контракт поведения
- В `shine-UI/index.html` viewport ограничен единичным масштабом: мобильное приложение не должно увеличиваться при разведении двух пальцев.
- `styles/main.css` и `services/pwa-viewport-gestures.js` дополнительно отключают pinch-zoom, включая жесты Safari. Однопальцевая прокрутка, поля ввода и обычные свайпы остаются доступными.
- Прокрутка `html/body` и оболочки приложения запрещена. `.screen-content` прокручивается **вертикально**, без горизонтального выхода за края и с ограничением scroll chaining. Ленты, длинные страницы, переписка и специализированные внутренние scroll-контейнеры сохраняют свою прокрутку. Не добавлять глобальный `touchmove.preventDefault()` для одиночного касания.
- На **своём** (`pages/profile-view.js`) и **чужом** (`pages/user-profile-view.js`) профиле нажатие на большую аватарку открывает её поверх всего интерфейса. Нажатие на увеличенную аватарку или фон, Escape и браузерная навигация назад закрывают просмотр. При закрытии/размонтировании страницы временные обработчики удаляются.
- `components/profile-avatar-preview.js` использует существующий `renderUserAvatar` и переносит **тот же DOM-элемент** во временное окно и обратно. Нельзя копировать URL изображения: загрузчик фото из Arweave может отозвать `blob:` после загрузки; повторный запрос также не нужен. Инициалы при отсутствии фотографии продолжают работать.
- Надписи для доступности находятся в словарях `js/i18n/locales/{ru,en}.json`; просмотр открывается обычной кнопкой и закрывается кнопкой/клавишей Escape.
## Ограничение
Отключение масштабирования страницы снижает доступность для людей, которым необходим pinch-zoom. Это осознанное ограничение интерфейса PWA по текущему требованию продукта; для дальнейшего развития стоит рассмотреть отдельно управляемый параметр «Разрешить масштабирование» в настройках доступности.
## Проверить на устройствах
1. Android Chrome / PWA, iOS Safari / PWA: два пальца не увеличивают/не уменьшают всю страницу, жест прокрутки и клавиатура работают как раньше.
2. На своём и чужом профиле фотография открывается крупно, повторное нажатие закрывает, инициалы без фотографии также отображаются.
3. Назад / Escape, переключение экрана, обновление данных профиля во время просмотра не оставляют висящих окон.
4. Лента, длинный профиль и чат прокручиваются внутри приложения; горизонтального сдвига корневой страницы нет.