Обработка событий касания с помощью interop на iOS

Касания в прокручиваемой области interop

Если каждое касание в области interop сразу передаётся базовому нативному элементу интерфейса, составной элемент-контейнер не может отреагировать на то же касание. Самая очевидная проблема возникает при прокрутке. Если область interop находится в прокручиваемом контейнере, пользователь может ожидать, что эта область:

• Реагирует на касание, когда пользователь хочет с ней взаимодействовать.

• Не реагирует на касание, когда пользователь хочет прокрутить родительский контейнер.

Для решения этой проблемы в Compose Multiplatform реализовано поведение, вдохновлённое UIScrollView. При первом обнаружении касания возникает небольшая задержка (150 мс), которая позволяет приложению решить, следует ли сообщить о нём контейнеру:

• Если компоненты Compose потребляют какие-либо события касания в течение этой задержки, Compose Multiplatform не сообщает нативному элементу интерфейса об этой последовательности касаний.

• Если за время задержки события не потребляются, Compose Multiplatform передаёт управление нативному интерфейсу до конца последовательности касаний.

Таким образом, при прокручиваемом содержимом, если пользователь удерживает касание, интерфейс воспринимает это как намерение взаимодействовать с нативным элементом; если последовательность касаний короткая, пользователь, скорее всего, хочет взаимодействовать с родительским элементом.

Если ваше представление interop не предназначено для взаимодействия, можно заранее отключить обработку всех касаний. Для этого вызовите конструктор UIKitView или UIKitViewController, задав для параметра isInteractive значение false.

Выбор стратегии обработки касаний

В Compose Multiplatform 1.12.0 также можно опробовать экспериментальный API для более точного управления интерфейсом interop.

Новые конструкторы для UIKitView или UIKitViewController принимают в качестве аргумента объект UIKitInteropProperties. С его помощью можно задать:

• Параметр interactionMode для заданного представления interop, позволяющий выбрать стратегию обработки касаний.

• Параметр isNativeAccessibilityEnabled, изменяющий поведение специальных возможностей для представления interop.

Для параметра interactionMode можно задать значение Cooperative или NonCooperative:

• Режим Cooperative — это новое значение по умолчанию, описанное выше: Compose Multiplatform добавляет задержку при обработке касаний. Экспериментальный API позволяет настроить эту задержку, выбрав другое значение вместо значения по умолчанию — 150 мс.

• В режиме NonCooperative используется предыдущая стратегия: Compose Multiplatform не обрабатывает события касания в представлении interop. Несмотря на перечисленные выше общие недостатки, этот режим может быть полезен, если вы уверены, что касания в interop никогда не нужно обрабатывать на уровне Compose.

• Чтобы отключить любое взаимодействие с нативным интерфейсом, передайте interactionMode = null конструктору.

Что дальше?

Подробнее об интеграции UIKit и SwiftUI в Compose Multiplatform.