postURL

отправки POST запросов

Функция postURL позволяет отправлять два запроса на сервер при нажатии HTML-элемента, у которого указан класс postURL.

Разберем на примере:

            <a class="postURL"
                data-toggle="modal"
                data-form="formMain"
                data-message="Загрузка завершена" 
                data-loader='<center class="g-pa-20--md"><img src="{{$.Value.Prefix}}/assets/img/typing.gif"></center>'
                data-url="/myproject/ru/block/welcome" 
                data-target="" 
                data-url2="/myproject/ru/block/welcome2" 
                data-target2=".placeExtFields" 
                data-method2="post" 
                href="#">Создать</a>

Основные параметры

• data-url - наверное самый важный параметр, который задает адрес, на который будет сделан 1-го запрос;
• data-target - место вывода результатов первого запроса (используется синтаксис работы с селекторами CSS);
  data-target может принимать также следующие значения:
      _blank - результат запроса будет возвращен в новое открытое окно;
      this - результат запроса будет возвращен в текущее окно (не элемент).
• data-url2 - адрес, на который будет сделан второй запрос (по-умолчанию тип 2-го запроса GET, см. data-method2);
• data-target2 - место вывода результатов 2-го запроса (используется синтаксис работы с селекторами CSS);
• data-method2 - тип 2-го запроса (для отправки 2-го POST-запроса, укажите значение "post", иначе 2-м запросом будет отправлен GET-запрос)*;
• data-form - указываем id-элемента form, данные внутри которого будут отправлены в первом post-запросе. Если значение не задано, то будет искать значение по-умолчанию #mForm;

Параметры модального окна

• data-toggle - параметр для передачи результата запроса в модальную форму (значение: modal / нет значения);
• data-close - параметр, который указывает на необходимость закрыть модальное окно, после отправки запросов;

Параметры вывода результатов

• data-message - сообщение, которое будет выведено в месте вывода результатов (указанных через data-target) после завершения 1-го запроса;
• data-message2 - сообщение, которое будет выведено в месте вывода результатов (указанных через data-target2) после завершения 2-го запроса;
• data-alert - текст оповещения в правом углу (для сервиса UI) после завершения работы всех запросов;
• data-alert-type - тип оповещения в правом углу (для сервиса UI);

Системные параметры

• data-param - указывает последовательность запросов (последовательно (по-умолчанию) / параллельно (значение: parallel);
• data-delay - задержка между первым и вторым последовательными запросами. Бывает необходимо сделать паузу между запросом на создание объекта и получением списка созданных объектов;
• data-loader - вставка, которая будет показываться в месте вывода результатов (указанных через data-target и data-target2);
• data-targetloader - бывают случаи, когда необходимо также указать процесс загрузки в отдельном контейнере (когда обработки идет фоном) для этого можно явно указать селектор элемента, куда будет загружен data-loader. (дополнительно к месту, указанному в data-target.

* При отправки двух POST-запросов, тело 2-го запроса будет содержать тело 1-го, а также результат выполнения 1-го запроса будет передан в виде строки через параметр prevResponse.

Для получения доступа к элементу первого запроса вы можете воспользоваться конструкцией как на примере:

{{$s := index .Value.Form.prevResponse 0 | unmarshal}}
{{$sd := index $s.data 0}}
<input type="hidden" id="uid" name="uid" value="{{$sd.uid}}">

В данном случае мы получаем содержимое параметра prevResponse, переводим его в объект и по индексу обращаемся к значения для вставки в скрытое поле (в блоке UI)

Модальные окна выбора

Модалные окна выбора реализованы средствами js-компонента и встроенны в Buildbox Studio.

Их задача - предоставить возможность выбора действия пользователя с дальнейшим переходом по указанным ссылкам.

Пример модального окна:

Вызов окна осуществляется через назначение класса postModal к элементу (ссылки, кнопки).

Для управление формой (заголовками, кнопками, описанием, действиями) существует ряд аттрибутов, которые необходимо указать, а именно:

Функция postURL позволяет отправлять несколько запросов на сервер при нажатии HTML-элемента, у которого указан класс postURL.

Разберем на примере:

            <a class="postURL"
                data-toggle="modal"
                data-param=""
                data-title=""
                data-icon=""
                data-button-ok=""
                data-text=""
                data-close=""
                data-alert="" 
                data-point="" 
                data-value="" 
                data-source="" 
                data-uid="" 
                data-token="" 
                data-alert-type="" 
                data-target=""
                data-url=""
                data-target2=""
                data-url2=""
             >

• data-form - указываем id-элемента form, данные внутри которого будут отправлены в первом post-запросе
• data-toggle - параметр для передачи результата запроса в модальную форму (значение: modal / нет значения)