Page History

API виджетов описывает методы  и  custom method declarations for widget structure and functionality customization:методы настройки структуры и функциональности виджетов:

• Используйте методы Use s_widget and и s_widgets methods in client-side scripts to implement the widget functionality you need. в клиентских скриптах для добавления необходимой функциональности виджетов.
• Для создания пользовательских методов используйте If you need to create your own widget methods, use the custom method functionality.

s_widget

To perform the current widget customization you created, use the methods belowИспользуйте нижеописанные методы для того, чтобы выполнить пользовательскую настройку текущего виджета.

s_widget.getFieldValue(key); 

s_widget.getFieldValue(widgetId, key);

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

This method adds a child template to the existing template by its ID with one of the following typesЭтот метод добавляет дочерний шаблон к существующему по его 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)

Use this method to return the widget field value defined by the key option.Используйте этот метод для получения значения поля виджета, определенного опцией 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.

Параметр:

Возврат:

Пример:

s_widget.getOptionValue('label');

s_widget.removeTemplate(id)

The method removes all child nodes and content from the specified elements. It does not remove the element itself or its attributesИспользуйте данный метод, чтобы удалить все дочерние узлы и содержимое указанных элементов. Сами элементы и аттрибуты при этом сохраняются.

Параметр:

Возврат:

Пример:

<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)

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

Parameter(s):

Параметры:

Возврат:

Пример:

;
(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()

This method transfers widget data to a server script and updates widget data according to the server reply.

Return:

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

Возврат:

Пример

:

;
(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)

This method sets a widget option value using the key option.

Parameter(s):

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

Параметры:

Возврат:

Пример:

s_widget.setOptionValue('label', 'name');

s_widget.showData()

The method displays the field data of a widget in the console. 

Return:

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

Возврат:

Пример

:

s_widget.showData();

s_widgets

Invoke the s_widgets methods within your scripts, when adding a widget to a form or a page for widget interactionВызывайте метод s_widgets в своих скриптах при добавлении виджета на форму или страницу для взаимодействия с виджетом.

s_widgets.getFieldValue(widgetInstanceID, key)

This method returns the objectvalue using the key and Данный метод возвращает значение объекта при помощи ключа (key) и ID экземпляра виджета (widget instance ID).

Параметры:

Возврат:

Пример:

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

s_widgets.getWidgets()

This method returns all the widget instance IDs of the page.

Return:

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

Возврат:

Пример

:

s_widgets.getWidgets();

s_widgets.setFieldValue(widgetInstanceID, key, value)

This method sets the value using the key and the Используйте данный метод для настройки значения (value) поля при помощи ключа(key)и ID экземпляра виджета (widget instance ID).

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

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