Справочник команд

Здесь перечислены все команды, которые можно вызвать из HTML-блока через атрибут data-mobius (см. С чего начать). Названия параметров указаны в том порядке, в котором их можно передавать «в скобках».

Переходы по приложению

Удобные команды для перехода на нужный экран. Их стоит предпочитать «ручной» навигации.

Команда	Что делает	Параметры
`catalog.openHome`	Открывает главную каталога	—
`catalog.openSection`	Открывает раздел каталога	`id`, `title`
`catalog.openSectionFiltered`	Открывает раздел с заранее заданным фильтром и своим заголовком	`id`, `title`, `filter`
`catalog.openProduct`	Открывает карточку товара	`id`
`catalog.search`	Открывает список товаров по поисковому запросу	`phrase`
`loyalty.openCard`	Открывает карту лояльности	—
`scanBarcode`	Открывает сканер штрихкодов	—

                                HTML                            

                            
<a data-mobius="catalog.openSection('320', 'Новинки')">Новинки</a>
<a data-mobius="catalog.openProduct('15')">Товар недели</a>
<a data-mobius="catalog.search('кофе')">Найти кофе</a>
<a data-mobius="loyalty.openCard">Моя карта</a>
                        

Параметр filter — это набор условий отбора. Передавайте его через data-params:

                                HTML                            

                            
<a data-mobius="catalog.openSectionFiltered"
   data-params='{"id":"320","title":"Со скидкой","filter":{"sale":"Y"}}'>
    Товары со скидкой
</a>
                        

Корзина

Команда	Что делает	Параметры
`basket.add`	Добавляет товар в корзину	`id`, `qty`
`basket.update`	Меняет количество товара	`id`, `qty`
`basket.remove`	Убирает товар из корзины	`id`, `qty`
`basket.clear`	Полностью очищает корзину	—

Если количество не указано, по умолчанию берётся 1.

                                HTML                            

<button data-mobius="basket.add" data-id="15">В корзину</button>
<button data-mobius="basket.add" data-id="15" data-qty="6">Взять упаковку (6 шт.)</button>

Избранное и сравнение

Команда	Что делает	Параметры
`favorites.toggle`	Добавляет товар в избранное или убирает из него	`id`
`compare.toggle`	Добавляет товар в сравнение или убирает из него	`id`

                                HTML                            

<button data-mobius="favorites.toggle" data-id="15">В избранное</button>

Шторки и модальные окна

Команда	Что делает	Параметры
`webview.openSheet`	Показывает шторку снизу с готовым содержимым	`html` или `url`, `snapPoints`
`webview.openModal`	Открывает полноэкранное окно с содержимым	`html` или `url`, `title`
`bottomsheet.open`	Показывает шторку с содержимым, описанным тут же в блоке	`id` встроенного блока
`modal.open`	Открывает окно с содержимым, описанным тут же в блоке	`id` встроенного блока
`document.open`	Открывает PDF-документ внутри приложения	`url`, `title`

Самый удобный способ — описать содержимое шторки прямо в блоке и сослаться на него по id:

                                HTML                            

                            
<a data-mobius="bottomsheet.open('info')">Подробнее об акции</a>

<bottomsheet id="info" height="60%">
    <h3>Условия акции</h3>
    <p>Скидка действует до конца месяца на весь раздел «Новинки».</p>
</bottomsheet>
                        

Тег <bottomsheet> в самом блоке не виден — приложение показывает его содержимым шторки только при нажатии. Атрибут height задаёт высоту шторки. Такой приём работает в блоках на главном экране, в карточке товара и в историях.

Команда document.open корректно показывает PDF и на iPhone, и на Android:

                                HTML                            

                            
<a data-mobius="document.open"
   data-params='{"url":"https://example.com/garantiya.pdf","title":"Гарантия"}'>
    Открыть гарантию
</a>
                        

Уведомления, ссылки, регион

Команда	Что делает	Параметры
`notification.toast`	Показывает всплывающее уведомление	`title`, `message`, `type`
`share`	Открывает системное окно «Поделиться»	`message`, `url`, `title`
`openURL`	Открывает внешний сайт в браузере	`url`
`region.set`	Меняет текущий регион	`id`, `title`

Для notification.toast параметр type принимает значения info, error или warning.

                                HTML                            

                            
<button data-mobius="notification.toast"
        data-params='{"title":"Готово","message":"Промокод скопирован","type":"info"}'>
    Показать уведомление
</button>

<a data-mobius="share"
   data-params='{"title":"Наше приложение","url":"https://example.com"}'>
    Поделиться
</a>
                        

Ручная навигация

Если нужного готового перехода нет, используйте универсальные команды. screen — это имя экрана, params — его параметры.

Команда	Что делает	Параметры
`navigation.navigate`	Открывает указанный экран	`screen`, `params`
`navigation.goBack`	Возвращается на предыдущий экран	—

                                HTML                            

<a href="mobius://navigation.goBack">Назад</a>

В большинстве случаев удобнее использовать готовые переходы из раздела «Переходы по приложению» выше — они проще и не требуют знания имён экранов.

Совместимость со старыми блоками

Блоки, сделанные раньше через MobiusApp.navigation.navigate(...) или через кнопки с data-screen, продолжают работать. Переписывать их не нужно. Для новых блоков используйте data-mobius — это проще и универсальнее.

Что дальше

Примеры — готовые блоки на основе этих команд.
Программный доступ — как получить ответ от команды и читать данные о пользователе.

Обновлено 10.07.2026 09:36

Помогла ли статья?

С чего начать Программный доступ (Mobius)