Интерактивные HTML-блоки
Во многих местах приложения вы можете вставлять собственные HTML-блоки: на главном экране, в описании товара, в историях, в статьях и на статических страницах. Раньше такой блок умел только показывать текст и картинки. Теперь он умеет ещё и управлять приложением: открывать раздел каталога, добавлять товар в корзину, показывать всплывающую шторку, открывать PDF — и всё это без выхода из приложения.
Управление подключается одним атрибутом — data-mobius. Вы пишете обычную ссылку или кнопку и добавляете к ней команду:
<a data-mobius="catalog.openProduct('15')">Перейти к товару</a>При нажатии приложение само откроет карточку товара с нужным ID. Никакого программирования не требуется.
Что умеют блоки
- Переходы — открыть раздел каталога, карточку товара, главную каталога, карту лояльности, запустить поиск.
- Корзина — добавить, изменить количество, удалить товар, очистить корзину.
- Избранное и сравнение — добавить или убрать товар.
- Шторки и модальные окна — показать дополнительный блок поверх экрана, не уводя пользователя со страницы.
- Документы — открыть PDF (договор, инструкцию, сертификат) внутри приложения.
- Прочее — показать всплывающее уведомление, поделиться ссылкой, открыть внешний сайт, сменить регион, запустить сканер штрихкодов.
Полный список — в справочнике команд.
Где работает
Возможности зависят от того, где показывается блок.
| Где вставлен блок | Переходы и действия по ссылке/кнопке | Встроенные шторки, живые обновления, программный доступ |
|---|---|---|
| Главный экран, карточка товара, истории | Да | Да |
| Статьи, новости, статические страницы | Да | Нет |
Проще говоря: ссылки и кнопки с командами работают везде, а более сложные сценарии — встроенные шторки <bottomsheet> и автоматическое обновление содержимого — только в блоках на главном экране, в карточке товара и в историях. Это связано с тем, как приложение отображает текст статей.
Два способа подключения
- Атрибут
data-mobius— основной и самый простой. Подходит для ссылок, кнопок и любых элементов. Описан в статье С чего начать. - Программный доступ
Mobius— для сложных сценариев: получить ответ от приложения, читать данные о пользователе, реагировать на изменения корзины. Описан в статье Программный доступ.
С чего начать
- Прочитайте С чего начать — как вставить блок и как устроен атрибут
data-mobius. - Загляните в справочник команд — что именно можно вызвать.
- Возьмите готовый блок из раздела Примеры и замените в нём ID товаров и разделов на свои.
Связанные разделы
- Записи — где вставляется HTML статей и новостей
- Статические страницы — постоянные страницы приложения
- Главный экран — блоки на главной