Перейти к основному содержанию
Модуль @exode-team/sdk/miniapp/react предоставляет декларативный слой над ExodeMiniApp для React-приложений. Все хуки реактивные: при событиях хоста компоненты автоматически перерендериваются.
React — опциональная peer-зависимость. Если в проекте нет React, этот модуль не нужен — используйте ванильный клиент.

Provider

Оборачивает приложение, создаёт ExodeMiniApp, выполняет handshake и распространяет подписки на события:

Параметры

ExodeMiniAppProviderConfig
обязательно
Конфигурация клиента: 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, отрисуйте свой интерфейс. Шапка, главная кнопка и поле ввода у хоста одни: один такой хук на экран.

Требования

Все хуки, кроме useExodeInitData, работают только внутри <ExodeMiniAppProvider>. Вызов за его пределами выбросит ошибку.

Полный пример


Обновлено: 2026-10-22 23:06 UTC