Форма сценария
Форма — это простая страница для запуска сценария. Без конструктора, без модулей: только нужные поля и кнопка «Отправить».
Конструктор удобен авторам сценария. Тем, кто просто хочет запустить — намного приятнее видеть короткую форму. Поэтому у каждого сценария есть «форма»: автоматически собирается из входных модулей и вынесенных полей.
Открыть форму своего сценария можно из конструктора — кнопка «Форма» в правой части верхней панели, она появляется, когда сценарий сохранён. Ещё одна точка входа — список сценариев на /s: у каждой карточки в строке действий тоже есть кнопка «Форма». При желании форму можно открыть и напрямую по адресу /s/<код>/app.
Что попадает в форму автоматически. В форму попадают все входные модули активной схемы: текст, файлы, выбор, переключатель, число. Каждый становится одним полем — с тем названием, описанием и ограничениями, которые вы задали в настройках модуля.
Как вынести в форму обычное поле модуля
Иногда хочется показать пользователю не только входные модули, но и какое-то поле обычного модуля — например, соотношение сторон или модель.
В настройках модуля у подходящих полей есть действие «Добавить в форму» — небольшая кнопка справа от подписи поля. Нажмите её, и поле появится в форме рядом с входными модулями.
После выноса у поля появляются собственные настройки для формы — они никак не влияют на сам модуль и существуют только для удобства пользователя:
- Подпись и описание для формы. Можно задать свой текст, который не зависит от названия параметра в нейросети. Например, поле
aspect_ratioв форме станет «Соотношение сторон», а длинное «Cycles» — «Сколько раз перерисовать». - Подсказка под полем. Маленький текст серым под инпутом — он же появляется на иконке «?» рядом с подписью.
- Обязательность. По умолчанию обязательность наследуется от модуля, но её можно переопределить — сделать поле необязательным даже там, где сама нейросеть требует значение (если у параметра есть разумное значение по умолчанию).
- Расширенные настройки. Поле можно отметить как «дополнительное» — оно уйдёт в раскрывающийся блок «Расширенные настройки» в нижней части формы, чтобы основная часть оставалась короче.
- Получатели. Одно поле формы можно связать сразу с несколькими модулями — тогда значение, которое ввёл пользователь, попадёт во все указанные поля одновременно. Подробнее — ниже, в разделе «Одно поле формы — несколько модулей сразу».
Чтобы убрать поле из формы, нажмите ту же кнопку «Добавить в форму» ещё раз — она работает как переключатель. Сами значения модуля от этого не теряются: поле просто перестаёт быть видимым для пользователя формы.
Одно поле формы — несколько модулей сразу
Одно значение можно записывать сразу в несколько мест одновременно.
Иногда один и тот же параметр нужен сразу нескольким модулям. Чтобы пользователь не заполнял его несколько раз, в настройках поля можно указать дополнительные получатели. Тогда одно поле формы будет передавать значение сразу в несколько модулей.
Это особенно полезно для общего соотношения сторон, общей длительности, общего стиля.
Range-control для «отрезков»
Если из одного поля заполняются «начало» и «конец» (например, две числовых настройки start_seconds и end_seconds), форма автоматически покажет компактный двойной слайдер вместо двух отдельных полей и проверит правило «конец > начало».