API виджетов

Виджет – это небольшое приложение, содержащее серверную и клиентскую логику. Виджет отправляет, получает и обрабатывает события через клиентский и серверный контроллеры. Помимо этого, виджеты обрабатывают и отображают полученные от пользователей данные. Они могут располагаться на любых формах и страницах портала.

Схема обработки данных

---

Данная схема показывает процесс передачи данных между серверным и клиентским скриптами посредством использования глобальных объектов.

Серверный скрипт использует объект input для доступа к данным, полученным из клиентского контроллера, и объекту data для обработки данных и их отправки назад.

Клиентский скрипт использует объект data для доступа к данным сервера. После обработки данных клиентским скриптом необходимо вызывать метод s_widget.serverUpdate() для передачи данных в серверный контроллер. При вызове этого метода объект серверного скрипта data автоматически перезаписывает объект data клиентского контроллера.

примечание

Клиентский контроллер использует объект s_widget для вызова методов API виджетов.

Взаимодействия между виджетами

---

При необходимости взаимодействия между виджетами используйте в клиентском скрипте методы s_widgets:

• Для получения и изменения данных виджета используйте методы s_widgets.getFieldValue(widgetID, key) и s_widgets.setFieldValue(widgetID, key, value):

  window.s_widgets.getFieldValue('157555401214600424', 'name');
  window.s_widgets.getFieldValue('157555401214600424', 'name', 'Иван');

• Для получения ID всех виджетов на текущей странице используйте метод s_widgets.getWidgets():

  window.s_widgets.getWidgets();

• Используйте метод s_widget.getElements() для просмотра составляющих элементов виджета:

  window.s_widget.getElements();

Simple-теги

---

Узнайте о доступных тегах виджетов и их атрибутах, а также об их использовании в агентском интерфейсе и на портале.

Директивы API

---

Для оптимизации вашей работы и эффективности виджетов используйте директивы API simple-if, simple-class, simple-show и simple-style.