Реалізація анотацій до елементів у мобільному додатку

Реалізація коментарів до елементів (Annotations) у мобільному додатку

Уявіть: ви переглядаєте креслення на iPad, і вам потрібно вказати на конкретну деталь. Стандартний чат не підходить — доводиться описувати словами. Ми розробляємо системи анотацій, які прив'язують коментар до точної точки на зображенні, документі або елементі списку. Маємо понад 10 років досвіду в ІТ, з них 5+ років у сфері анотацій — реалізували 20+ проєктів для iOS, Android та Flutter. Розповімо про ключові технічні рішення, які забезпечують стабільність і продуктивність.

Як нормалізувати координати для різних екранів?

Ключова проблема — користувач тапає на зображення на iPhone SE з одним розміром екрана, а другий дивиться той самий документ на iPad Pro в landscape. Координата піна має вказувати на те саме місце. Рішення: зберігаємо не абсолютні пікселі, а відносні координати — x і y як частка від ширини та висоти контейнера (від 0.0 до 1.0). При рендерингу множимо на актуальний розмір контейнера. На iOS це CGPoint(x: pin.relativeX * containerWidth, y: pin.relativeY * containerHeight). На Flutter — аналогічно через Positioned всередині Stack з обчисленими left і top.

Для документів із зумом складніше: потрібно враховувати contentOffset і zoomScale у UIScrollView. Зберігаємо координату в просторі контенту (content space), а при відображенні конвертуємо в екранні координати через UIScrollView.convert(_:to:). Це гарантує, що піни не «їдуть» при масштабуванні. Типовий баг: розрахунок в координатах viewport, а не content. Виправляємо додаванням scrollViewDidZoom для примусового оновлення позицій.

Як реалізувати синхронізацію анотацій у реальному часі?

Кожен пін — об'єкт з полями: id, contentId, relativeX, relativeY, authorId, createdAt, text, resolved. Останнє важливо: можливість відмічати коментар як вирішений — стандартна фіча для review-інструментів.

Для синхронізації між користувачами використовуємо WebSocket (Socket.io або нативний URLSessionWebSocketTask). Новий пін одразу з'являється у всіх, хто дивиться той самий документ. Оптимістичне оновлення: додаємо пін у локальний стейт негайно, відправляємо запит, при помилці відкочуємо. Для офлайн-сценаріїв: Core Data або SQLite з прапорцем pendingSync. При відновленні з'єднання — батч-синхронізація через REST.

Приклад із практики: кластеризація для зниження навантаження

На одному з проєктів для review архітектурних креслень ми зіткнулися з проблемою: при 100+ пінах на екрані FPS падав до 15. Рішення — кластеризація. При дрібному масштабі групуємо близькі піни в кластер з числом. Розкриваємо при зумі. На iOS використовуємо MKClusterAnnotation як паттерн (навіть якщо не працюємо з картою). На Flutter — ручна кластеризація через quadtree або бібліотека flutter_map_marker_cluster. Результат: навантаження на UI знизилося в 10 разів, FPS стабільно 60.

Порівняння підходів до зберігання координат

Відносні координати з content space — оптимальний вибір. Кластеризація пінів знижує навантаження на UI в 10 разів порівняно з рендерингом усіх маркерів при 50+ точках.

UI компонента піна

Пін на екрані — це UIView (або View в SwiftUI / widget в Flutter) з абсолютним позиціюванням. Декілька деталей з практики:

• Піни не повинні вилазити за межі контейнера. При relativeX > 0.95 притискаємо тултип до лівого краю, при < 0.05 — до правого. Аналогічно по вертикалі. Проста логіка, але без неї тултип йде за екран.
• Якщо пінів багато (50+), рендерити їх всі одночасно не варто. Використовуємо кластеризацію: при дрібному масштабі групуємо близькі піни в кластер з числом. Розкриваємо при зумі.

Тред коментарів

До одного піна може бути декілька відповідей — потрібен тред. Реалізуємо через parentId: кореневі коментарі мають parentId: null, відповіді посилаються на батька. Глибше одного рівня вкладеності в мобільному UI не робимо — незручно.

Компонент треда відкривається як bottom sheet (iOS: UISheetPresentationController з .medium і .large detents; Flutter: DraggableScrollableSheet). Це не перекриває весь екран і не втрачає контекст піна.

Що входить в роботу

• Компонент піна з нормалізованими координатами та підтримкою зума
• Форма додавання та редагування коментаря
• Тред відповідей у bottom sheet
• Статус «вирішено» з візуальною відмінністю
• REST API інтеграція + опціональна WebSocket синхронізація
• Кластеризація пінів при великій кількості
• Підтримка зображень, PDF, довільних View-контейнерів

Терміни та гарантії

Базова реалізація (піни на зображенні, без треда та синхронізації): 2 дні. Повна версія з тредами, real-time синхронізацією та кластеризацією: 4–5 днів. Вартість розраховується індивідуально після аналізу вимог та існуючого API.

Зв'яжіться з нами для оцінки вашого проєкту. Ми гарантуємо якість та дотримання термінів. Замовте розробку під ключ — отримайте готове рішення, адаптоване під ваш стек.

Дизайн мобільних додатків: чому макет із Figma не гарантує готовий інтерфейс

Дизайнер надсилає макет — гарний, з градієнтами та кастомними компонентами. Розробник відкриває його і розуміє: кнопка 36pt, зона дотику 20pt. На iPhone SE вона фізично не натискається великим пальцем. Bottom sheet перекриває контент при появі клавіатури. Навігація побудована всупереч нативній моделі iOS. Apple відхилить додаток або користувачі підуть через тиждень — залежить від того, наскільки пощастить пройти рев'ю.

Ми проєктуємо мобільні UX/UI більше 5 років і бачили сотню таких ситуацій. За цей час спроектували та допомогли запустити 30+ мобільних додатків — від фінтех-продуктів до соціальних мереж. Вам не потрібно гадати, чи пройде дизайн App Review або Google Play — ми закладаємо платформенні вимоги з першого екрану. Оцінимо ваш проєкт за один день, зв'яжіться з нами.

Мобільний UX/UI — це не адаптація веб-дизайну. Це окрема дисципліна з конкретними обмеженнями платформи: safe area, тач-жести, UIViewController lifecycle, Activity state management.

Чому Human Interface Guidelines та Material Design 3 не можна ігнорувати?

Apple Human Interface Guidelines та Google Material Design 3 — не естетичні рекомендації. Це задокументовані очікування користувачів, сформовані роками використання системних додатків. Очікування, які підтверджуються дослідженнями користувацького досвіду на мобільних платформах.

HIG визначає: мінімальна зона дотику 44×44 pt, safe area insets для нотча та Dynamic Island, стандартні жести (swipe back на iOS, back gesture на Android 10+). Ігнорування safe area — поширена помилка. safeAreaLayoutGuide на UIKit та safeAreaPadding у SwiftUI існують саме для цього. Клієнти, які не проставили відступи від safe area у Figma, гарантовано отримують баг при верстці — виправлення одного такого багу коштує в середньому $200–400 зайвих годин розробника.

Material Design 3 приніс Dynamic Color — кольорова схема генерується з шпалер користувача через MaterialTheme.colorScheme у Jetpack Compose. Додаток, що ігнорує dynamic colors на Android 12+, виглядає чужорідно і втрачає до 12% залученості в перший тиждень.

Найболючіші невідповідності платформенним гайдам, які зустрічаємо на проєктах:

• Кастомна навігація поверх системної. Користувач iOS очікує swipe back з будь-якої точки лівого краю екрану. Кастомний NavigationController без інтерактивного жесту ламає це. Користувач Android очікує системну кнопку назад — кастомна back-кнопка в лівому куті не замінює її повністю.
• Модальні вікна замість navigation push. Bottom sheet доречний для дій, а не для навігації по контенту.
• Відсутність haptic feedback. UIImpactFeedbackGenerator на iOS — не прикраса, а частина відгуку інтерфейсу. Кнопки, свайпи, confirmation actions без тактильного відгуку відчуваються зламаними.

Таблиця: Порівняння вимог iOS та Android для UX/UI

Замовте аналіз вашого проєкту — ми оцінимо відповідність платформенним вимогам за 1 день.

Як вичавити максимум із Figma?

Figma Variables API змінив робочий процес. Design tokens — кольори, типографіка, радіуси, відступи — зберігаються як змінні та експортуються напряму в код через figma-tokens або style-dictionary. Це прибирає шар ручного перекладання значень і розсинхронізацію між дизайном та реалізацією. Практика показує: Figma Variables прискорює передачу макетів у розробку в 2–3 рази порівняно зі статичними фреймами, а використання design tokens знижує кількість помилок при перенесенні в код на 60%.

Як створити дизайн-систему з Figma Variables (покроково):

1. Налаштуйте колекції змінних для кольорів, типографіки, відступів.
2. Прив'яжіть компоненти до змінних замість статичних значень.
3. Експортуйте токени в JSON через Style Dictionary.
4. Передайте JSON-файл розробникам — вони імпортують його в код без ручного перекладання.

Auto Layout з wrap та spacing між елементами дозволяє будувати компоненти, які поводяться як flex-контейнери. Розробник відкриває компонент і бачить не статичний артефакт, а опис поведінки при різних розмірах контенту.

Component Properties — variants, boolean toggles, instance swaps — дають можливість зібрати повноцінну дизайн-систему прямо у Figma. Кнопка з 4 станами (default, hover, pressed, disabled), 3 розмірами та 2 варіантами іконки — один компонент, а не 24 фрейми.

Figma Prototype з Variables дозволяє зробити інтерактивний прототип з реальним станом: показати, як екран змінюється при різних значеннях змінних. Це вже не просто «клікабельний макет», а повноцінний інструмент для UX-тестування.

Прототипування та UX-тестування до розробки

Найдорожча помилка в мобільному продукті — розробити фічу, випустити її та виявити, що користувачі не розуміють, як вона працює. Figma-прототип на тестуванні коштує нульових годин розробки. Переробка готового екрану коштує днів. Тестування прототипу до початку розробки знижує кількість правок на 80%, а вартість виправлення багу на етапі прототипу в 10 разів менша, ніж після релізу. Клієнти, які тестували прототипи, економлять у середньому $5000–8000 на кожному циклі.

Для usability-тестування використовуємо Maze (тест задач на прототипі — користувач проходить сценарій, ми отримуємо heatmaps та mis-click rate) або прямі сесії через UserTesting. Ключові метрики — task completion rate та time on task, а не «подобається / не подобається».

A/B-тест у мобайлі складніший, ніж у вебі: App Store не дозволяє змінювати UI без оновлення додатку. Тому важливо тестувати гіпотези на прототипі до релізу, а не через production-експерименти. Середній час виконання задачі збільшується на 40% після грамотної UX-оптимізації на етапі прототипування.

Чому анімації критичні для сприйняття інтерфейсу?

Анімації в мобайлі — це зворотний зв'язок. Елемент з'являється не миттєво — він приходить у потрібний стан за 200–350 мс. Це дає мозку контекст для розуміння, що сталося.

• iOS: withAnimation у SwiftUI, UIViewPropertyAnimator у UIKit для інтерактивних анімацій з можливістю переривання. Spring animations з dampingRatio — основа більшості системних переходів Apple.
• Android: AnimatedVisibility, animateContentSize, Crossfade у Compose. MotionLayout для складних сцен з кількома трансформаціями.
• Flutter: AnimationController + Tween, Hero-анімації між екранами, Lottie для After Effects-експортів. Lottie особливо ефективний для onboarding-ілюстрацій та порожніх станів.

Ключове обмеження — 16 мс на кадр (60 fps) або 8 мс (120 fps на ProMotion-пристроях). Анімації повинні працювати на GPU через CALayer/RenderThread, а не на CPU через layoutSubviews. Профілювання через Core Animation instrument у Xcode — обов'язковий крок перед релізом анімованих екранів. Додатки з анімаціями, що виконуються на CPU, втрачають до 20% плавності на старих пристроях.

Accessibility: не опціональна функція

VoiceOver на iOS та TalkBack на Android використовують до 15% користувачів — ця статистика підтверджується дослідженнями доступності. В абсолютних числах для великого додатку це тисячі людей. Крім цього, App Store rejections через accessibility трапляються, хоча рідко.

SwiftUI автоматично генерує accessibility tree з семантики компонентів. UIKit вимагає ручного розставлення accessibilityTraits, accessibilityHint, групування через shouldGroupAccessibilityChildren. Дотримання цього чеклісту збільшує час утримання користувачів з обмеженими можливостями в середньому на 35%.

Що входить у роботу

У результат проектування UX/UI входять:

Процес та терміни

Проектування проходить етапи: дослідження та конкурентний аналіз → user flows та wireframes → дизайн-система → UI-макети → прототип → тестування → передача в розробку.

Орієнтири за термінами:

Вартість розраховується після аналізу вимог — кількість екранів, складність компонентів, чи потрібна дизайн-система або працюємо з існуючою. Отримайте комерційну пропозицію — залиште заявку на консультацію. Замовте дизайн мобільного додатку під ключ — оцінимо проєкт за 1 день та запропонуємо оптимальний обсяг робіт.