Files

T

mayatnikovandClaude Opus 5 383e374f0f iOS: запрет масштабирования, версия в подвале, самообновление, строка ввода

Отзыв с iPhone после первого живого прогона.

Масштабирование запрещено (ADR-066): viewport как в соседнем sixlines плюс
viewport-fit=cover, мета-теги установленного приложения, touch-action против
двойного тапа и страховка на JS — гашение жестов iOS, потому что мета-строку
Safari вправе проигнорировать. Размеры шрифтов не тронуты: 14 px из брифа
остаются, поднимать поля до 16 px владелец отклонил. Цена — доступность
для тех, кому зум нужен — записана в ADR и в ui.md честно.

Версия в подвале (ADR-065, 067): GET /api/config отдаёт короткую ревизию
и время коммита. Именно коммита, а не сборки: штамп компиляции в бинаре
means каждая пересборка даёт новый хеш, и обещание ADR-022 «бинарь собирается
из тега байт в байт» перестаёт проверяться.

Самообновление PWA (ADR-068, 070): в режиме приложения на iPhone перезагрузки
нет, и старая версия жила бы вечно. Проверка при возврате в приложение,
включение ждущей оболочки, перезагрузка — но не тогда, когда в строке набран
текст. Замок от петли сравнивает версию оболочки, а не считает перезагрузки:
счётчик отменял саму фичу, долгоживущая вкладка переставала обновляться.
Замерено: было 30, 60, 120, 240 секунд между релизами, стало ровно 30.

Строка ввода — редактируемый блок (ADR-069): iOS рисует над клавиатурой
полосу со стрелками и «готово» для полей формы, и убрать её со страницы
нельзя. Для contenteditable не рисует. Режим plaintext-only с проверкой,
что он применился, и запасным путём с разбором вставки: невалидное значение
атрибута в части браузеров делает блок нередактируемым вовсе. Чтение
и запись только через textContent, innerHTML в клиенте по-прежнему нет.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015DbCjVfTFq4ZFG8juD45YJ

2026-08-23 15:11:13 +03:00

6.8 KiB

Raw Blame History

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

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

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

Контекст

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

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

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

Решение

Масштабирование запрещено, включая щипок. viewport — width=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-style — default. Тема одна и светлая (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.

6.8 KiB Raw Blame History Unescape Escape

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

Контекст

Решение

Следствия

6.8 KiB

Raw Blame History