Page History

Данные классы описывают методы настройки структуры и функциональности виджетов:

• Используйте методы объекта

• s_widget

• класса SimpleWidget

• для добавления необходимой функциональности. Объект доступен при инициализации виджета.
• Используйте методы объекта

• s_widgets

• класса SimpleWidgets

• для добавления необходимой функциональности. Объект инициализируется при добавлении виджета на форму или на страницу портала

API виджетов описывает методы настройки структуры и функциональности виджетов:

• Используйте методы s_widget и s_widgets в клиентских скриптах для добавления необходимой функциональности виджетов.

• Для создания пользовательских методов используйте s_widget_custom

  method functionality

  .

  Info
  Эти методы могут быть использованы только на стороне клиента.

  
  

SimpleWidget

s_widget

Используйте нижеописанные методы глобальный объект s_widget для того, чтобы выполнить пользовательскую настройку текущего виджета.

s_widget.getFieldValue(key); 

s_widget.getFieldValue(widgetId, key);

s_widget.addTemplate(id, template, script, type)

Этот метод добавляет дочерний шаблон Используйте метод для добавления дочернего шаблона (template) к существующему по его ID id с одним из следующих типов: inner, before, after.

Параметры:

Возвращаемое значениеВозврат:

Пример:

<div id="steps"></div>

s_widget.addTemplate('steps', '<div class="main">', '', 'inner');

s_widget.getElements()

Данный метод возвращает элемент виджета structure.

Используйте метод, чтобы вернуть массив элементов структуры виджета. Элементы в массиве имеют тот же порядок, что и на странице.

Возвращаемое значениеВозврат:

Пример:

window.s_widget.getElements();

s_widget.getFieldValue(key)

Используйте этот метод для получения значения поля данных виджета, определенного опцией определенных ключом (key). 

Параметр:

Возвращаемое значениеВозврат:

Пример:

s_widget.getFieldValue('element');

s_widget.getForm()

Данный метод возвращает объект формы, размещенный при помощи тэга <Form> или <remform>.

Параметр:

Возврат:

Пример:

const builtInForm = s_widgets.getForm('custom');
await builtInForm.save();

s_widget.getId()

Данный Используйте метод возвращает для возращения ID экземпляра виджета как значение строки.

ВозвратВозвращаемое значение:

Пример:

s_widget.getId();

s_widget.getOptionValue(key)

Используйте данный метод для возврата опции виджета получения значения value, определенной опцией keyзаданного в опции ключа (key) из Опций схемы виджета.

Параметр:

Возвращаемое значениеВозврат:

Пример:

s_widget.getOptionValue('label');

s_widget.removeTemplate(id)

Используйте данный метод, чтобы удалить все дочерние узлы и содержимое указанных элементов. Сами элементы и аттрибуты указанного элемента. Сам элемент и его атрибуты при этом сохраняются.

Параметр:

Возвращаемое значениеВозврат:

Пример:

<div id="element1">
  Remove meУбрать
</div>
<button buttonType="approve" event-click="window.s_widget_custom.remove();">
  Click meДобавить
</button>

#element1 {
  background-color: yellow;
  height: 20px;
}

;
(() => {
    window.s_widget_custom = window.s_widget_custom || {};
    window.s_widget_custom.remove = function () {
        s_widget.removeTemplate('element1');
    } 
})();

s_widget.setFieldValue(key, value)

Используйте этот метод, чтобы задать значение (value) при помощи для ключа (key).

Параметры:

Возвращаемое значениеВозврат:

Пример:

;
(async () => {
    const tableName = s_form.getTableName();
    const recordId = s_form.getUniqueValue();
    const serviceId = s_form.getValue('service');
    const serviceDisplayValue = s_form.getDisplayValue('service');

    s_widget.setFieldValue('table_name', tableName);
    s_widget.setFieldValue('record_id', recordId);
    s_widget.setFieldValue('service', { database_value: serviceId, display_value: serviceDisplayValue });
    await s_widget.serverUpdate();
})();

s_widget.serverUpdate()

Данный метод предназначен для переноса данных виджета на серверный скрипт и обновления данных виджета после ответа сервера.

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

Возвращаемое значениеВозврат:

Пример:

;
(async () => {
    const tableName = s_form.getTableName();
    const recordId = s_form.getUniqueValue();
    s_widget.setFieldValue('table_name', tableName);
    s_widget.setFieldValue('record_id', recordId);
    const response = await s_widget.serverUpdate();
    console.log(response.getData().data);
})();

s_widget.setOptionValue(key, value)

Используйте этот метод, чтобы настроить задать значение (value) опции виджета при помощи для ключа (key) опций виджета.

Параметры:

Возвращаемое значениеВозврат:

Пример:

s_widget.setOptionValue('label', 'nameНаименование');

s_widget.showData()

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

ВозвратВозвращаемое значение:

Пример:

s_widget.showData();

SimpleWidgets

s_widgets

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

s_widgets.getFieldValue(widgetInstanceID, key)

Данный метод Метод возвращает значение объекта при помощи из данных виджета для ключа (key) и ID экземпляра виджета (widget instance IDwidgetinstanceID).

Параметры:

Возвращаемое значениеВозврат:

Пример:

s_widgets.getFieldValue('157555401214600424', 'name');

s_widgets.getForm()

Метод возвращает объект формы, размещенный при помощи тега <Form> или <remform>.

Параметр:

Возвращаемое значение:

Пример:

const builtInForm = s_widgets.getForm('custom');
await builtInForm.save();

s_widgets.getWidgets()

Этот метод возвращает список ID всех экземпляров виджетов на странице. ID включаются в ответ в том же порядке, в котором виджеты расположены на странице. 

ВозвратВозвращаемое значение:

Пример:

s_widgets.getWidgets();

['160767740511016793', '160767742115787725', '160767742915897037', '160767743612372124', '158965632914393037', '158965975317960937', '161062077113210360']

s_widgets.setFieldValue(widgetInstanceID, key, value)

Используйте данный метод для настройки значения метод, чтобы задать значение (value) поля при помощи ключадля ключа (key) в данных виджета и ID экземпляра виджета (widget instance IDwidgetinstanceID).

Параметры:

Возвращаемое значениеВозврат:

Пример:

s_widgets.getFieldValuesetFieldValue('157555401214600424', 'name', 'AlexАлександр');

Within the client-side scripts, you can configure your own widget methods by using the window.s_widget_custom variable:

window.s_widget_custom.updateFullname = function() {
  //
}