Методы данного класса предназначены для конфигурации списков. Например, для управления действиями UI.
Использование глобальной переменной
Внутри каждого списка можно использовать преднастроенную глобальную переменную.
Переменная | Описание |
---|
currentUiAction | Содержит объект с ID записи UI action. Используйте данную переменную при вызове контекстного меню. Одним из примеров ее использования является получение информации о действиях UI при вызове контекстного меню. 
|
Пример:
Code Block |
---|
title | currentUiAction |
---|
linenumbers | true |
---|
|
window.currentUiAction |
s_list.addErrorMessage(message)
Используйте данный метод для вывода всплывающих сообщений об ошибке в правом нижнем углу.
Параметры:
Name | Type | Mandatory | Дефолтное значение |
---|
message | String | Y | N |
ReturnВозврат:
Type | Description |
---|
Void | This method does not return any valueДанный метод не возвращает значение. |
ExampleПример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | addErrorMessage |
---|
linenumbers | true |
---|
|
s_list.addErrorMessage('Please enter a valid email address using the following format: joe@example.com'); |
s_list.addInfoMessage(message, durationMilliseconds)
This method displays info messages when working with lists. They appear in the bottom right corner. The message disappears after a certain period of time. Specify this period in milliseconds in the second parameter.Используйте данный метод для отображения информационных сообщений при работе со списками. Сообщения появляются в нижнем правом углу и исчезают через некоторое время. Настройте это время во втором парамере в миллисекундах.
Параметры:
NameНазвание | TypeТип | MandatoryОбязательный | Дефолтное значение |
---|
message | String | YД | NН |
durationMilliseconds | Number | NНN | Н |
ReturnВозврат:
TypeТип | DescriptionОписание |
---|
Void | This method does not return any valueДанный метод не возвращает значение. |
ExampleПример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | addInfoMessage |
---|
linenumbers | true |
---|
|
s_list.addInfoMessage('Link copied to clipboard', 2000); |
s_list.addSuccessMessage(message, durationMilliseconds)
This method displays success messages when working with lists. They appear in the bottom right corner. The message disappears after a certain period of time. Specify this period in milliseconds in the second parameter.Данный метод выводит сообщения об успешном действии при работе со списками. Сообщения появляются в нижнем правом углу и исчезают через некоторое время. Настройте это время во втором парамере в миллисекундах.
Параметры:
NameНазвание | TypeТип | MandatoryОбязательный | Дефолтное значение |
---|
message | String | YД | NН |
durationMilliseconds | Number | NНN | Н |
ReturnВозврат:
TypeТип | DescriptionОписание |
---|
Void | This method does not return any valueДанный метод не возвращает значение. |
ExampleПример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | addSuccessMessage |
---|
linenumbers | true |
---|
|
s_list.addSuccessMessage('Record was successfully updated!', 3000); |
s_list.addWarningMessage(message, durationMilliseconds)
This method displays warning messages when working with lists. They appear in the bottom right corner. The messages disappear after a certain period of time. Specify this period in milliseconds in the second parameter.Используйте этот метод для отображения предупреждающих сообщений при работе со списками. Сообщения появляются в нижнем правом углу и исчезают через некоторое время. Настройте это время во втором парамере в миллисекундах.
Параметры:
NameНазвание | TypeТип | MandatoryОбязательный | Дефолтное значение |
---|
message | String | YД | NН |
durationMilliseconds | Number | NНN | Н |
ReturnВозврат:
TypeТип | DescriptionОписание |
---|
Void | This method does not return any valueДанный метод не возвращает значение. |
ExampleПример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | addWarningMessage |
---|
linenumbers | true |
---|
|
s_list.addWarningMessage('This record has been modified by another user', 3000); |
deleteRows(tableName, sysIds)
Use this method to delete one or more selected rows in the tableДанный метод предназначен для удаления одной и более выбранных строк таблицы.
Параметры:
NameНазвание | TypeТип | MandatoryОбязательный | Дефолтное значение |
---|
tableName | String | YД | NН |
sysIds | Array | YД | NН |
ReturnВозврат:
TypeТип | DescriptionОписание |
---|
Object | This object returns a promise contains specific data. | Этот объект возвращает промис, содержащий определенные данные. |
ПримерExample:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | deleteRows |
---|
linenumbers | true |
---|
|
s_i18n.getMessage("Delete the selected record(s)?", async (translationResponse) => {
if (confirm(translationResponse)) {
s_list.deleteRows(table, selectedRows)
.then(() => {
__resolveServerResponse();
s_list.refresh(table);
})
} else {
__resolveServerResponse();
}
}); |
getCheckedRow(tableName)
Use this method to get information about the strings that are checked on the list.
Параметры:
Name | Type | Mandatory | Дефолтное значение |
---|
tableName | String | Y | N |
Return:
Type | Description |
---|
Array | An array containing IDs of the strings checked; if no strings were checked, then the method returns the empty array. |
Example:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getCheckedRow |
---|
linenumbers | true |
---|
|
const table = s_list.getTablesName()[0];
const selectedRows = s_list.getCheckedRow(table);
if (!selectedRows.length) {
s_i18n.getMessage("No selected rows.", (translationResponse) => {
__resolveServerResponse();
alert(translationResponse);
});
} |
getQuery()
This method returns the list condition.
Return:
Type | Description |
---|
String | A condition formatted as an encoded query. |
Example:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getQuery |
---|
linenumbers | true |
---|
|
; (() => {
const url = new URL(`${API_BASE_URL}/list/${s_list.getTablesName()[0]}`);
url.searchParams.set('condition', s_list.getQuery());
window.open(url, '_blank');
})(); |
getTablesName()
This method returns a list of the tables.
Return:
Type | Description |
---|
Array | The tables list. |
Example:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getTablesName |
---|
linenumbers | true |
---|
|
; (() => {
const url = new URL(`${API_BASE_URL}/list/${s_list.getTablesName()[0]}`);
url.searchParams.set('condition', s_list.getQuery());
window.open(url, '_blank');
})(); |
refresh(tableName)
Используйте этот метод, чтобы обновить данные в списке, заданном в параметре tableName.
Параметры:
Название | Тип | Обязательный | Дефолтное значение |
---|
tableName | String | Д | Н |
Возврат:
Тип | Описание |
---|
Void | Данный метод не возвращает значениязначение. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | refresh |
---|
linenumbers | true |
---|
|
if (confirm(translationResponse)) {
s_list.deleteRows(table, selectedRows)
.then(() => {
s_list.refresh(table);
})
} |