Описание. Сообщает редактору, что плагин начал длительную операцию. В информационном режиме редактор показывает текст описания в строке состояния. В блокирующем режиме редактор запрещает ввод в документ, пока плагин не вызовет EndAction.
Редакторы: документы, таблицы, презентации.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
type | строка | "Block" — блокирующий режим: пользователь не может вводить текст в документ. Любое другое значение, например «Information», — информационный режим: текст описания появляется в строке состояния, работа с документом не блокируется |
description | строка | Текст операции, например «Загрузка данных…» |
Числа 0 и 1 в параметре type не работают как типы: с любым из них редактор включает информационный режим.
Возвращаемое значение
Метод ничего не возвращает.
Пример
window.Asc.plugin.executeMethod("StartAction", ["Block", "Загрузка данных..."]);
fetch("https://example.com/data.json")
.then(function (response) { return response.json(); })
.then(function (data) {
// работа с данными
})
.finally(function () {
window.Asc.plugin.executeMethod("EndAction", ["Block", "Загрузка данных..."]);
});Всегда вызывайте EndAction, в том числе при ошибке: иначе блокировка останется и пользователь не сможет работать с документом.
Пока действует блокировка "Block", редактор не выполняет код из callCommand: функция обратного вызова сработает, но документ не изменится и ошибки не будет. Сначала вызовите EndAction, а уже потом изменяйте документ. Пример — в статье «Пример плагина: индикатор долгой операции» ↗.













