Исправил баг UI: PWA и просмотр аватаров

This commit is contained in:
AidarKC
2026-11-10 14:09:54 +03:00
parent 9c30b33b39
commit 003cc942d8
14 changed files with 252 additions and 28 deletions
@@ -0,0 +1,21 @@
# 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. Лента, длинный профиль и чат прокручиваются внутри приложения; горизонтального сдвига корневой страницы нет.
+1
View File
@@ -8,6 +8,7 @@
Галерея сохранена без изменений и ещё не отражает итоговое сочетание решений. Для последующего переноса источником истины служит `DESIGN.md`, а не детали одного старого варианта. Эта галерея не является описанием текущего кода приложения.
- [Локализация UI (этап 1)](I18N.md) — языковой движок, приоритет системного языка и глобальные настройки.
- [PWA: масштабирование и аватар профиля](PWA_VIEWPORT_AND_AVATAR_PREVIEW.md) — поведение полноэкранного интерфейса и просмотра фотографии.
- [Заявления о статусах и предупреждения о блокчейне](PROFILE_DECLARATIONS_AND_CONSENT.md) — действующие сценарии профиля, лайков и подтверждений на 06.11.2026.
## Как посмотреть
+2 -2
View File
@@ -4,7 +4,7 @@
<meta charset="UTF-8" />
<meta
name="viewport"
content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-visual"
content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover, interactive-widget=resizes-visual"
/>
<meta name="theme-color" content="#121419" />
<base href="/" />
@@ -39,7 +39,7 @@
}());
</script>
<script>
window.__SHINE_BUILD_HASH__ = '20261109100500';
window.__SHINE_BUILD_HASH__ = '20261110-pwa-avatar-01';
window.__SHINE_CLIENT_VERSION__ = '1.20.9';
</script>
<script>
+4 -2
View File
@@ -1,4 +1,6 @@
import { initI18n, onLanguageChange, t } from './i18n/index.js';
import { preventPagePinchZoom } from './services/pwa-viewport-gestures.js';
preventPagePinchZoom();
import {
navigate,
getRoute,
@@ -81,7 +83,7 @@ import * as loginOtherDeviceView from './pages/login-other-device-view.js?v=2026
import * as loginPasswordView from './pages/login-password-view.js?v=202606201650';
import * as publicSupportQueueView from './pages/public-support-queue-view.js';
import * as profileView from './pages/profile-view.js?v=202610130400';
import * as profileView from './pages/profile-view.js?v=20261110-pwa-avatar';
import * as profileEditView from './pages/profile-edit-view.js';
import * as profilesView from './pages/profiles-view.js';
import * as walletView from './pages/wallet-view.js?v=202609260900';
@@ -122,7 +124,7 @@ import { isDmChatMuted } from './services/dm-chat-prefs.js';
import { getDevicePref } from './services/device-prefs.js';
import { isDeveloperToolsEnabled } from './services/feature-settings.js';
import { confirmDialog } from './components/confirm-dialog.js';
import * as userProfileView from './pages/user-profile-view.js';
import * as userProfileView from './pages/user-profile-view.js?v=20261110-pwa-avatar';
import * as userProfileListView from './pages/user-profile-list-view.js';
import * as userRelationManageView from './pages/user-relation-manage-view.js';
import * as channelsList from './pages/channels-list.js?v=20261011-search';
@@ -0,0 +1,76 @@
import { t } from '../i18n/index.js';
import { renderUserAvatar } from './avatar-image.js';
let activeClose = null;
/**
* Тот же экземпляр Avatar переносится во всплывающее окно, а затем обратно.
* Так сохраняются уже загруженная фотография и blob URL, который может быть
* отозван загрузчиком после onload; клонировать img/src здесь нельзя.
*/
export function attachProfileAvatarPreview(slot, card) {
if (!slot || !card) return { cleanup() {} };
const trigger = document.createElement('button');
trigger.type = 'button';
trigger.className = 'user-profile-avatar-trigger';
trigger.setAttribute('aria-label', t('screens.profile_avatar_preview.open'));
const avatar = renderUserAvatar({
login: card.login,
firstName: card.firstName,
lastName: card.lastName,
avatar: card.avatar,
size: 'xl',
className: 'user-profile-hero-avatar',
official: card.accountRole === 'primary',
});
trigger.append(avatar);
slot.append(trigger);
let closePreview = null;
trigger.addEventListener('click', () => {
if (closePreview) return;
activeClose?.({ restoreFocus: false });
const overlay = document.createElement('div');
overlay.className = 'profile-avatar-preview';
overlay.setAttribute('role', 'dialog');
overlay.setAttribute('aria-modal', 'true');
overlay.setAttribute('aria-label', t('screens.profile_avatar_preview.dialog'));
const largeButton = document.createElement('button');
largeButton.type = 'button';
largeButton.className = 'profile-avatar-preview__image';
largeButton.setAttribute('aria-label', t('screens.profile_avatar_preview.close'));
largeButton.append(avatar);
overlay.append(largeButton);
const onKey = (event) => {
if (event.key === 'Escape') close();
};
const onPopState = () => close({ restoreFocus: false });
const close = ({ restoreFocus = true } = {}) => {
if (closePreview !== close) return;
closePreview = null;
if (activeClose === close) activeClose = null;
document.removeEventListener('keydown', onKey);
window.removeEventListener('popstate', onPopState);
// При обновлении карточки или уходе со страницы прежний trigger уже может быть удалён.
if (trigger.isConnected) trigger.append(avatar);
overlay.remove();
if (restoreFocus && trigger.isConnected) trigger.focus({ preventScroll: true });
};
closePreview = close;
activeClose = close;
overlay.addEventListener('click', (event) => {
if (event.target === overlay || event.target.closest('.profile-avatar-preview__image')) close();
});
document.addEventListener('keydown', onKey);
window.addEventListener('popstate', onPopState);
(document.getElementById('modal-root') || document.body).append(overlay);
largeButton.focus({ preventScroll: true });
});
return {
cleanup() { closePreview?.({ restoreFocus: false }); },
};
}
+5
View File
@@ -4191,6 +4191,11 @@
},
"message_menu": {
"text_001": "Action of the communication"
},
"profile_avatar_preview": {
"open": "Enlarge avatar",
"dialog": "Avatar preview",
"close": "Close avatar preview"
}
},
"errors": {
+5
View File
@@ -4191,6 +4191,11 @@
},
"message_menu": {
"text_001": "Действия сообщения"
},
"profile_avatar_preview": {
"open": "Увеличить аватар",
"dialog": "Просмотр аватара",
"close": "Закрыть просмотр аватара"
}
},
"errors": {
+13 -13
View File
@@ -1,7 +1,7 @@
import { t, th } from '../i18n/index.js';
import { profile } from '../mock-data.js';
import { state } from '../state.js';
import { renderUserAvatar } from '../components/avatar-image.js';
import { attachProfileAvatarPreview } from '../components/profile-avatar-preview.js';
import { createTopBar } from '../components/topbar.js';
import { loadUserProfileCard } from '../services/user-connections.js';
import { profileCardHtml, profileTileHtml } from '../components/profile-card.js';
@@ -47,8 +47,12 @@ export function render({ navigate, chrome }) {
body.className = 'user-profile-body';
screen.append(status, body);
let avatarPreview = null;
let disposed = false;
function renderProfile() {
if (!card) return;
if (!card || disposed) return;
avatarPreview?.cleanup();
avatarPreview = null;
body.innerHTML = profileCardHtml({
card,
login,
@@ -62,16 +66,7 @@ export function render({ navigate, chrome }) {
<button class="nav-row" type="button" data-self-profile-action="profiles"><span class="nav-row__label">${th('screens.profile_view.text_015')}</span><span class="nav-row__hint">${th('screens.profile_view.text_016')}</span></button>
</div>`;
const avatarSlot = body.querySelector('.user-profile-avatar-slot');
avatarSlot?.append(renderUserAvatar({
login: card.login,
firstName: card.firstName,
lastName: card.lastName,
avatar: card.avatar,
size: 'xl',
className: 'user-profile-hero-avatar',
official: card.accountRole === 'primary',
}));
avatarPreview = attachProfileAvatarPreview(body.querySelector('.user-profile-avatar-slot'), card);
status.replaceChildren();
}
@@ -104,7 +99,7 @@ export function render({ navigate, chrome }) {
return;
}
const fresh = await loadUserProfileCard(login);
if (!screen.isConnected && card) return;
if (disposed || (!screen.isConnected && card)) return;
// Та же карточка – не перерисовываем, иначе аватар и счётчики мигают.
if (card && JSON.stringify(card) === JSON.stringify(fresh)) return;
card = fresh;
@@ -127,5 +122,10 @@ export function render({ navigate, chrome }) {
};
refresh().catch(showLoadError);
screen.cleanup = () => {
disposed = true;
avatarPreview?.cleanup();
avatarPreview = null;
};
return screen;
}
+8 -11
View File
@@ -1,7 +1,7 @@
import { t } from '../i18n/index.js';
import { createTopBar } from '../components/topbar.js';
import { SHINE_CONNECTIONS_LOGO_SRC } from '../components/shine-logo.js';
import { renderUserAvatar } from '../components/avatar-image.js';
import { attachProfileAvatarPreview } from '../components/profile-avatar-preview.js';
import { state } from '../state.js';
import { loadRelationsForPair, loadUserProfileCard } from '../services/user-connections.js';
import { createErrorState, createLoadingState } from '../components/feedback.js';
@@ -44,9 +44,13 @@ export function render({ navigate, route, chrome }) {
screen.append(status, body);
let card = null;
let relation = null;
let avatarPreview = null;
let disposed = false;
function renderProfile() {
if (!card || disposed) return;
avatarPreview?.cleanup();
avatarPreview = null;
const isSelf = card.login.toLowerCase() === selfLogin.toLowerCase();
body.innerHTML = profileCardHtml({
@@ -62,16 +66,7 @@ export function render({ navigate, route, chrome }) {
syncRelationTile();
const avatarSlot = body.querySelector('.user-profile-avatar-slot');
avatarSlot?.append(renderUserAvatar({
login: card.login,
firstName: card.firstName,
lastName: card.lastName,
avatar: card.avatar,
size: 'xl',
className: 'user-profile-hero-avatar',
official: card.accountRole === 'primary',
}));
avatarPreview = attachProfileAvatarPreview(body.querySelector('.user-profile-avatar-slot'), card);
status.replaceChildren();
}
@@ -134,6 +129,8 @@ export function render({ navigate, route, chrome }) {
screen.cleanup = () => {
if (disposed) return;
disposed = true;
avatarPreview?.cleanup();
avatarPreview = null;
};
async function refresh() {
@@ -0,0 +1,11 @@
// Safari (iOS) может игнорировать user-scalable=no из-за настроек доступности.
// Блокируем только попытки pinch-zoom, сохраняя одиночную прокрутку, свайпы и ввод.
export function preventPagePinchZoom(target = document) {
const preventGesture = (event) => event.preventDefault();
const preventMultiTouch = (event) => {
if (event.touches?.length > 1 && event.cancelable) event.preventDefault();
};
target.addEventListener('gesturestart', preventGesture, { passive: false });
target.addEventListener('gesturechange', preventGesture, { passive: false });
target.addEventListener('touchmove', preventMultiTouch, { passive: false });
}
+2
View File
@@ -36,7 +36,9 @@
right: 0;
bottom: calc(var(--toolbar-height, 78px) + var(--composer-height, 0px));
z-index: var(--z-shell-content);
overflow-x: hidden;
overflow-y: auto;
overscroll-behavior: contain;
padding: 0 16px 24px;
}
+51
View File
@@ -291,3 +291,54 @@
.avatar.avatar-image.avatar-plain > .avatar-fallback,
.avatar.avatar-image.avatar-plain > .avatar-photo { width: 100%; height: 100%; box-shadow: none; text-shadow: none; }
.avatar.avatar-image.avatar-plain > .avatar-fallback { background: var(--surface-selected); color: var(--accent); }
/* Просмотр фото профиля: без повторной загрузки картинки и без масштабирования PWA. */
.user-profile-avatar-trigger {
display: grid;
place-items: center;
width: 100%;
height: 100%;
margin: 0;
padding: 0;
border: 0;
border-radius: 50%;
background: transparent;
color: inherit;
cursor: zoom-in;
touch-action: manipulation;
}
.user-profile-avatar-trigger:focus-visible {
outline: 2px solid var(--focus-ring);
outline-offset: 6px;
}
.profile-avatar-preview {
position: fixed;
inset: 0;
z-index: 140;
display: grid;
place-items: center;
padding: 20px;
background: rgb(0 0 0 / 90%);
-webkit-backdrop-filter: blur(10px);
backdrop-filter: blur(10px);
touch-action: none;
}
.profile-avatar-preview__image {
display: grid;
place-items: center;
width: min(82vw, 430px, calc(100dvh - 96px));
aspect-ratio: 1;
padding: 0;
border: 0;
border-radius: 50%;
background: transparent;
cursor: zoom-out;
}
.profile-avatar-preview__image > .avatar.avatar-image {
width: 100%;
height: 100%;
min-width: 0;
min-height: 0;
font-size: clamp(44px, 22vw, 128px);
}
.profile-avatar-preview__image:focus-visible { outline: 2px solid #fff; outline-offset: 8px; }
+2
View File
@@ -135,6 +135,8 @@ body {
min-height: 100%;
overflow: hidden;
overscroll-behavior: none;
/* Прокрутка остаётся внутри экранов, а pinch/double-tap не масштабирует всю PWA. */
touch-action: pan-x pan-y;
background: var(--background);
color: var(--text);
font-family: var(--font-main);
@@ -0,0 +1,51 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync } from 'node:fs';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { preventPagePinchZoom } from '../js/services/pwa-viewport-gestures.js';
const ui = resolve(dirname(fileURLToPath(import.meta.url)), '..');
const source = (path) => readFileSync(resolve(ui, path), 'utf8');
test('PWA запрещает масштабирование, сохраняя прокрутку содержимого', () => {
const html = source('index.html');
assert.match(html, /initial-scale=1, maximum-scale=1, user-scalable=no/);
const shell = source('styles/app-shell.css');
assert.match(shell, /\.screen-content\s*\{[^}]*overflow-y:\s*auto/s);
assert.match(shell, /\.screen-content\s*\{[^}]*overflow-x:\s*hidden/s);
assert.match(source('styles/main.css'), /touch-action:\s*pan-x pan-y/);
});
test('pinch-zoom блокируется, но одно касание не блокируется', () => {
const handlers = new Map();
const target = { addEventListener(name, callback, options) {
handlers.set(name, { callback, options });
} };
preventPagePinchZoom(target);
for (const name of ['gesturestart', 'gesturechange', 'touchmove']) {
assert.equal(handlers.get(name).options.passive, false);
}
let prevented = 0;
const event = (count) => ({ touches: Array(count).fill({}), cancelable: true, preventDefault() { prevented++; } });
handlers.get('touchmove').callback(event(1));
assert.equal(prevented, 0);
handlers.get('touchmove').callback(event(2));
assert.equal(prevented, 1);
handlers.get('gesturestart').callback(event(2));
handlers.get('gesturechange').callback(event(2));
assert.equal(prevented, 3);
});
test('единый просмотр аватара подключён к обоим профилям и закрывается при cleanup', () => {
for (const page of ['profile-view.js', 'user-profile-view.js']) {
const js = source(`js/pages/${page}`);
assert.match(js, /attachProfileAvatarPreview\(body\.querySelector\('\.user-profile-avatar-slot'\), card\)/);
assert.match(js, /avatarPreview\?\.cleanup\(\)/);
}
const viewer = source('js/components/profile-avatar-preview.js');
assert.match(viewer, /largeButton\.append\(avatar\)/);
assert.match(viewer, /trigger\.append\(avatar\)/);
assert.match(viewer, /event\.key === 'Escape'/);
assert.match(viewer, /window\.addEventListener\('popstate', onPopState\)/);
});