Skip to content

webdev1881/scale-S2L / .claude/skills/kiosk-motion

kiosk-motion

Verified

Движение в киоске — свайп-лента страниц, переходы между уровнями каталога, спокойный режим карточек, стартовая заставка. Использовать при правке жестов, анимаций и SplashScreen.vue.

Движение в киоске

При prefers-reduced-motion все переходы отключаются.

Свайп-лента

  • Страницы каталога — одна лента: все страницы стоят подряд внутри .ribbon, а листание сводится к её сдвигу. Ничего не монтируется, не подменяется и не меняет размеров, поэтому дёргаться нечему. Прежняя схема — текущая страница плюс две соседние, с подменой содержимого в конце жеста — давала рывок на каждой подмене.
  • Сдвиг ленты собран из двух слагаемых, и у каждого свой хозяин: --page пишет Vue из состояния, --shift — обработчик жеста прямо в стиль. Оба в transform писать нельзя: ручная правка и реактивная привязка затирают друг друга, и лента остаётся на первой странице.
  • Переход между уровнями каталога живёт на обёртке .track, а не на самой ленте: он анимирует тот же transform, и на одном элементе они спорят.
  • Под пальцем лента идёт без сглаживания (transition: none), после отпускания сдвиг снимается и лента доезжает переходом из CSS. Номер страницы меняется сразу — доводить нечего, все страницы уже на месте.
  • Листание засчитывается по длине (четверть ширины, но не больше 200 px — на широком экране четверть длиннее удобного движения кистью) либо по скорости короткого броска.
  • На краю каталога лента почти не поддаётся (сопротивление 0.12, упор 56 px) — это и есть ответ «дальше ничего нет», понятный без подписи.
  • Край следующей страницы виден всегда, когда есть куда листать: справа зарезервирован жёлоб, и затухание на самом блоке начинается ровно там, где кончается текущая страница. Жёлоб держится, пока страниц больше одной, иначе на последней странице карточки меняли бы ширину. Это подсказка, что ленту можно потянуть.
  • Ширину жёлоба задаёт админка — долей карточки (kiosk_peek_percent, по умолчанию 28%), а не пикселями: карточка меняет ширину вместе с числом колонок, и зашитый пиксель показывал бы на сетке 4x2 половину товара, а на 6x2 — четверть. 0 убирает подсказку вовсе, вместе с отступом и затуханием.
  • Считает жёлоб updatePeek в App.vue, а не CSS: он забирает ширину у самой сетки, поэтому карточка зависит от жёлоба и наоборот. Из P = k * Карточка + отступ выводится P = (k * (W - 2*отступ - зазоры) + отступ * C) / (C + k). Пересчёт идёт на смену сетки, настройки и размера блока (ResizeObserver).
  • В ленте собраны только текущая страница и две соседние с каждой стороны (RIBBON_WINDOW = 2), остальные держат своё место пустым блоком той же ширины: сдвиг считается от номера страницы, поэтому места должны стоять все. Ближнюю соседку видно в жёлобе подсказки, вторая страхует прыжок — номер страницы меняется скачком после поиска и набора кода, не только стрелкой пейджера.
  • Собирать всю ленту нельзя: на боевом каталоге (363 товара — 31 страница) в DOM оказывалось столько же карточек, каждая со снимком и бесконечным переливом плашки. Заставка при запуске дёргалась, свайп терял кадры. С окном в разметке пять-шесть десятков карточек вместо четырёх сотен.
  • Окно заодно заменило собой ленивую загрузку снимков: оно знает, что понадобится, по номеру страницы, и знает это заранее. Подробности — в скилле product-photos.
  • Жест забирается у браузера (touch-action: pan-y на слоте сетки), иначе он уходит под его собственную навигацию вместе с pointercancel посреди свайпа.
  • Захват указателя (setPointerCapture) не используется. Он делает своё дело — палец, ушедший за край сетки, жест не теряет, — но после него браузер съедает следующий click: касание приходит (в журнале видно pointerdown и pointerup по карточке), а клика уже нет. Именно это выглядело как «кнопки и карточки срабатывают только со второго раза», и поймать это можно было лишь диагностикой на живом экране. Вместо захвата на время жеста вешаются слушатели окна.
  • После протяжки гасится ровно один клик — тот, что браузер шлёт следом за жестом, и только если он приходит в точку отрыва пальца (± 40 px) и в ближайшие 120 мс. Раньше глушились все нажатия в течение 300 мс, и покупатель, нажавший кнопку сразу после свайпа, не получал ничего: со стороны это выглядело как «кнопки и карточки работают только со второго раза». Ловится это плохо: в фоновой вкладке таймеры зажаты до секунды, и проверка всегда попадает уже за окно подавления.

Переходы страниц и уровней

  • Смена уровня каталога анимируется наложением: уходящая и приходящая сетки лежат в одной ячейке. Последовательный режим (mode="out-in") требует, чтобы уход обязательно завершился, и любая заминка оставила бы каталог пустым.
  • Листание анимируется страницей целиком: номер страницы входит в ключ сетки, уходящая уезжает в сторону движения, приходящая приезжает с противоположной. Переход достаётся только кнопкам пейджера: свайп двигает ленту сам, и добавленный поверх сдвиг читался бы как второе, чужое движение.
  • Свайп меняет страницу без перехода — имя none, у которого одно-единственное правило: display: none на уходящей сетке. Vue держит её в DOM до следующего кадра, и на более короткой новой странице старые карточки просвечивали в пустых ячейках — блик ровно в конце жеста.
  • Карточками листать нельзя: на время перехода в сетке оказывается вдвое больше карточек, ряды пересобираются и кадр дёргается — а вертикальный влёт карточек ещё и спорит с горизонтальным жестом.

Анимация карточек

  • Смена набора карточек анимируется самими карточками через TransitionGroup: он даёт перестановку соседей, а лесенка задержек (--i) превращает подмену списка в проявление. Лишние карточки на время перехода уходят в неявные ряды нулевой высоты, чтобы не сжимать страницу.
  • Спокойный режим (класс calm) включается на время смены самой сетки — столбцы под выехавшей панелью, ряды под клавиатурой. Это не изменение списка, а изменение раскладки: влёт карточек снизу со ступенчатой задержкой поверх меняющейся ширины читается как рывок в конце анимации. По той же причине ширина каталога под панель меняется одним шагом, а не едет 0.22 с вместе с карточками.
  • Пока набирают код или название, перестановка тоже выключена: список пересобирается на каждой цифре, карточки не успевают доехать до новых мест и на следующем нажатии едут заново — особенно заметно, когда их осталось мало и ехать далеко. В наборе карточки не двигаются, новые просто проявляются.
  • Отсутствие перехода у .card-move — не украшение: Vue проверяет, есть ли у класса перестановки переход, и без него пропускает FLIP целиком, не трогая позиции. Уходящая карточка при этом получает display: none, иначе оставшиеся встают вокруг неё и через кадр перескакивают.

Экран «Оновлення»

components/UpdatingOverlay.vue — блокирующий экран на время, пока нет связи с бэкендом (перезапуск службы, обновление, обрыв сети) или пока его включили настройкой kiosk_force_updating. Сверху строкой кружок ожидания и надпись, под ними картинка (public/updating.jpg): покупатель читает экран сверху вниз и первым должен получить ответ «что происходит», а не разглядывать иллюстрацию. Пустой же экран с одним кружком он читает как поломку — картинка показывает, что прибор занят, а не сломан.

Размеры — долями экрана (min(52vw, 720px), max-height: 46vh), скругление и тень те же, что у плиток киоска: экран должен выглядеть частью интерфейса, а не заставкой от другого приложения. Кружок и надпись стоят в строку — столбцом они растягивали экран и не оставляли картинке места. При prefers-reduced-motion кружок не крутится.

Стартовая заставка

components/SplashScreen.vue вместо спиннера: пиксели слетаются в надпись SMK. Точки берутся из растра текста, поэтому надпись подстраивается под любой экран.

  • Кадр пишется прямо в ImageData, а не тысячами fillRect: на J6412 вызовы канвы упираются в CPU уже на нескольких тысячах частиц, а запись в буфер стоит одинаково при любом их количестве (замер: 13 тыс. частиц — 2.4 мс/кадр). Если на приборе кадр всё же не укладывается в бюджет, крутить MIN_STEP (шаг сетки точек), а не число частиц: плотность упирается именно в него.
  • Пиксели — приём сборки, а не конечный вид: кадр перетекает в тот же текст, нарисованный шрифтом со сглаживанием. Переход перекрывает хвост влёта и заканчивается ровно в момент посадки последних частиц — иначе зритель успевает увидеть готовую надпись из квадратов, и она читается как низкое разрешение экрана.
  • Сторона точки равна шагу сетки, а позиция округляется, а не усекается. Иначе зерно рассыпается в дизеринг (точка мельче шага) или покрывается крапиной (погрешность float уводит часть точек на пиксель).
  • Перелив по надписи — выборка из таблицы «оттенок × прозрачность», индекс считается от координаты и времени. Оттенки берутся вокруг #409EFF Element Plus; светлые токены (#79bbff, #a0cfff) в заливку не годятся — на белом выцветают.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall