@exode-team/sdk/miniapp/react предоставляет декларативный слой над ExodeMiniApp для React-приложений. Все хуки реактивные: при событиях хоста компоненты автоматически перерендериваются.
React — опциональная peer-зависимость. Если в проекте нет React, этот модуль не нужен — используйте ванильный клиент.
Provider
Оборачивает приложение, создаётExodeMiniApp, выполняет handshake и распространяет подписки на события:
Параметры
Конфигурация клиента:
appId, targetOrigin?, timeout?, edgeToEdge?, applyEnvironment?, applyTheme?
(см. параметры ExodeMiniApp) плюс renderMode?.
В отличие от ExodeMiniApp, у провайдера edgeToEdge и applyTheme по умолчанию включены (SDK 0.4+): в
приложении фрейм уходит под шапку и нижнее меню хоста, <body> получает отступы по --exode-inset-*, фон и цвет
текста — из цветов школы. Чтобы вести отступы или тему самому, передайте edgeToEdge: 'manual' или
applyTheme: false — см. Нативный вид.useExodeApp
Состояние подключения и низкоуровневый доступ к инстансуExodeMiniApp.
В режиме
renderMode: 'defer' (по умолчанию) дети провайдера не монтируются, пока идёт handshake, поэтому
ветка «Соединение с Exode…» из примера выше не отрисуется. Чтобы показывать состояние загрузки, используйте
renderMode: 'immediate'.useExodeUser
Текущий пользователь. Обновляется на событииuser:updated. isLoggedIn — true, если user.id > 0;
для неавторизованного посетителя страницы хост передаёт user.id === 0.
useExodeTheme
Текущая тема. Обновляется на событииtheme:changed. Также возвращает isReady — получена ли тема от хоста, и
с хостом 0.4+ — accent (акцент школы, CSS-цвет) и colors (цвета хоста, MiniAppThemeColors); со старым хостом
они null. До handshake схема берётся из имени фрейма, которое хост задаёт при открытии.
useExodeSchool
Данные школы. Обновляется на событииschool:updated.
useExodeConfig
Конфигурация окружения. Обновляется на событииconfig:updated. Поле os (ios / android / web) передаёт
хост 0.4+, со старым хостом — null.
useExodeNavigation
Команды навигации основного приложения.navigate(path, params) принимает шаблон маршрута и параметры —
см. раздел «Навигация» в Клиент ExodeMiniApp.
useExodeUI
UI-команды к хосту. С SDK 0.4 хук возвращает иopenLink(url, { external? }), share({ url?, text?, title? }) и
copyText(text) — см. Нативный вид.
minimize работает только для страниц с типом окна «Плавающее окно», «Панель справа» или «Во весь экран»
(см. Кастомные страницы). Отследить сворачивание можно
хуком useExodeVisibility. setHeaderVisible на кастомных страницах пока ничего не меняет.useExodeVisibility
Видно ли приложение пользователю прямо сейчас. Хост не выгружает iframe при уходе на другую страницу и при сворачивании окна — вместо этого он присылаетvisibility:changed. Используйте
хук, чтобы останавливать опросы, видео и анимации в фоне.
useExodeInitData
Подписанная строка Init Data из адреса iframe (#exodeInitData=...).
Значение читается один раз, удаляется из адресной строки и кэшируется. Провайдер для этого хука не нужен.
Отправьте строку на свой бэкенд и проверьте её там функцией verifyInitData — в браузере ей доверять нельзя.
Хуки нативного вида (SDK 0.4+)
Хуки хрома хоста подробно описаны на странице Нативный вид.useExodeHeader, useExodeBackButton, useExodeMainButton и useExodeComposer возвращают isSupported — если
false, отрисуйте свой интерфейс. Шапка, главная кнопка и поле ввода у хоста одни: один такой хук на экран.
Требования
Полный пример
Обновлено: 2026-10-22 23:06 UTC