Files
bare/docs/decisions/075-no-zoom-app-feel.md
T
mayatnikovandClaude Opus 5 f9ac83bef8 Развести номера ADR: 064/065/066 этой ветки → 073/074/075
Ветка отведена от 522ba89, где последним был ADR-063, и заняла
064–072. Тем временем в main через #3 и #4 пришли свои 064
(строка ввода — div вместо form), 065 (стороны сообщений)
и 066 (серверного перца нет).

Переезжают три ADR этой ветки, 067–072 остаются на месте:
их номера свободны, а внутренние ссылки менять незачем.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QR8uS3zGkybzWRW4GEY1oz
2026-08-24 11:23:12 +03:00

6.8 KiB
Raw Blame History

ADR-075: Масштабирования нет, размеры шрифтов прежние

Уточняет ADR-024: типографика из docs/identity/brief.md остаётся как записана, а страница перестаёт масштабироваться.

Уточнён ADR-069: строка сообщения стала редактируемым блоком, и она в перечне элементов управления, по которым второй тап не гасится.

Контекст

На iPhone интерфейс жил в постоянных микрозумах. Тап по строке ввода приближал страницу: iOS Safari обязан приблизить поле мельче 16 px и обратно масштаб не возвращает. Двойной тап приближал её же, щипок — тем более. Ощущения приложения не было: страница ездила под пальцами.

Лечится это двумя способами, и они друг друга исключают. Первый — вырастить поля до 16 px: причина фокус-зума уходит, масштаб остаётся человеку. Второй — запретить масштабирование целиком. Владелец выбрал второй и отклонил первый прямо: «интерфейс должен быть как в нативном приложении, это нужно запретить», «с 16 шрифтом всё станет огромное».

Образец рядом — sixlines.ru той же команды: там maximum-scale=1, user-scalable=no, и на устройствах владельца страница не масштабируется.

Решение

  • Масштабирование запрещено, включая щипок. viewportwidth=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover.
  • Размеры шрифтов не меняются: поля ввода остаются 14 px, остальное — как в docs/identity/brief.md. 16 px на полях владельцем отклонены.
  • Установленное приложение объявляется двумя мета-строками сразу: mobile-web-app-capable и его исторический двойник apple-mobile-web-app-capable — iOS до сих пор смотрит на второй. Имя на экране «Домой» — apple-mobile-web-app-title со значением bare.
  • apple-mobile-web-app-status-bar-styledefault. Тема одна и светлая (ADR-024): black-translucent пустил бы страницу под системную полосу и написал бы её часы и значки белым по bone, то есть по светлому. default оставляет полосу над страницей, тёмными знаками по светлому фону.
  • touch-action: manipulation на html: снимает зум по двойному тапу и задержку 300 мс, которую браузер держит, ожидая второго касания. Двойной тап — жест документа, поэтому правило на корне действует на всю страницу.
  • Страховка на JS — web/js/zoom.js: мета-строке Safari верен не всегда. Слушатели непассивные, иначе preventDefault не действует. gesturestart, gesturechange, gestureend — события щипка, они бывают только в Safari — гасятся целиком. Второй тап подряд, ближе 350 мс и 40 px к первому, гасится, если он не по элементу управления: preventDefault на touchend уносит с собой click, а нажать кнопку дважды подряд — обычное дело. Прокрутка, свайпы и одиночные нажатия не трогаются вовсе.
  • overscroll-behavior: none у страницы и contain у лент: резинового отскока и «потянуть для обновления» нет, прокрутка внутри лент прежняя.
  • Выделение текста снято с шапки, сайдбара, кнопок и разделителей: долгое нажатие по ним показывало лупу и «копировать», а копировать там нечего. С текста сообщений, отпечатков, полей ввода и версии в подвале сайдбара (ADR-067) не снято — их копируют; версию на iPhone взять больше неоткуда, там нет ни строки адреса, ни консоли.
  • viewport-fit=cover пускает страницу под вырез и системную полосу, поэтому отступы считаются с ней: подвал сайдбара и строка ввода добавляют к нижнему полю env(safe-area-inset-bottom), страница — боковые и верхнюю вставки. Верхняя при status-bar-style: default нулевая и не делает ничего; она стоит на случай, когда браузер решит иначе, — строка кода против шапки, уехавшей под часы.

Следствия

  • Человек, которому нужно увеличить мелкое, средства лишается. Это сознательная цена ощущения приложения, и платят её все. Записана в docs/ui.md, «Доступность», рядом с контрастом и целями нажатия — чтобы её видели, а не находили.
  • Safari вправе не послушаться: user-scalable=no он игнорирует с десятой версии, и maximum-scale однажды может пойти тем же путём. Тогда вернётся и фокус-зум на поле в 14 px — лечить его 16-м шрифтом отклонено, а другого лекарства нет.
  • Двойной тап по кнопке не гасится страховкой: масштаба он и так не даёт, а второе нажатие важнее.
  • Клиент вырос на один модуль — web/js/zoom.js. Он в оболочке service worker и в раскладке docs/plan.md.