Реализация Tooltip-подсказок для новых функций в мобильном приложении
После крупного обновления пользователи не замечают новую кнопку в тулбаре. Не потому что она плохо спроектирована, а потому что никто не показал, что она появилась. Tooltip решает это точечно — без онбординга, без модальных окон.
Техническая реализация
На iOS с SwiftUI — модификатор .popover(isPresented:) для простых случаев или кастомный ViewModifier с ZStack + GeometryReader для позиционирования bubble относительно target-элемента. Системный UIToolTip появился только в iOS 15 и работает исключительно с pointer (iPad + Apple Pencil / trackpad), для смартфонов не подходит. Поэтому tooltip делается через overlay с anchorPreference для вычисления координат target'а в глобальном пространстве.
В UIKit — UIView bubble с CAShapeLayer для стрелки, позиционируется через convert(_:to:) и window?.addSubview(). Ключевой момент: добавлять в window, а не в superview — иначе bubble обрежется при clipsToBounds родительского контейнера.
На Android с Compose — Popup + кастомная composable с измерением через onGloballyPositioned. Material3 не имеет встроенного tooltip с произвольным позиционированием; PlainTooltip и RichTooltip появились в Material3 1.1.0, но работают только с TooltipBox и ограничены в кастомизации. Для полного контроля — собственная реализация через Popup с alignment = Alignment.TopStart и смещением на основе координат target.
В React Native — библиотека react-native-walkthrough-tooltip или кастомный Modal с measure() для вычисления позиции. Modal с transparent={true} и animationType="fade" даёт нужный эффект.
Управление состоянием показа
Tooltip показывается один раз при первом обнаружении функции. Логика: при каждом запуске приложения проверяем UserDefaults / SharedPreferences на ключ tooltip_feature_X_shown. Показываем — записываем флаг. Повторный показ — только по явному триггеру (например, «Что нового?»).
Для нескольких одновременных фич — очередь: tooltipQueue: [TooltipConfig], показываем по одному с задержкой 300–500 мс между показами. Не показываем во время активной анимации или перехода между экранами — отслеживаем состояние навигации.
Задержка перед показом в 500–800 мс после загрузки экрана обязательна. Tooltip поверх ещё не дорисованного контента выглядит как баг.
Доступность
accessibilityLabel на dismiss-кнопке. VoiceOver должен зачитывать текст подсказки автоматически при появлении через UIAccessibility.post(notification: .announcement, argument: tooltipText). TalkBack — AccessibilityEvent.TYPE_ANNOUNCEMENT через View.announceForAccessibility().
Срок: 1–3 дня в зависимости от количества подсказок, сложности позиционирования и необходимости поддержки нескольких платформ.