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

4.0 KiB
Raw Blame History

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. Лента, длинный профиль и чат прокручиваются внутри приложения; горизонтального сдвига корневой страницы нет.