Функции редактирования
Функция редактирования — функция JavaScript, которая отвечает в веб-клиенте за редактирование значения в пользовательском представлении, как функция отображения — за его отображение. Её имя указывается в опции CUSTOM свойства, после ключевого слова CHANGE, и в блоке CUSTOM оператора INPUT — для значения, которое этот оператор запрашивает у пользователя. В десктоп-клиенте значение редактируется штатным механизмом.
Функция редактирования
По умолчанию значение редактируется штатным механизмом свойства — например, текстовым полем ввода. Ключевое слово CHANGE представления значения CUSTOM позволяет заменить или дополнить этот механизм собственным редактором на JavaScript:
PROPERTIES(o) address CUSTOM CHANGE 'googleAutocomplete'
Функция редактора, как и функция отображения, регистрируется оберткой и возвращает объект из нескольких функций. Вид редактора определяется тем, какая функция отрисовки есть в этом объекте:
| функция | редактор |
|---|---|
renderInput(element, controller, value) | дополняет штатное текстовое поле ввода; element — само это поле |
renderDialog(element, controller, value) | редактор-окно. При потере фокуса значение автоматически не фиксируется |
render(element, controller, value) | редактор, замещающий содержимое ячейки |
value — текущее значение свойства, преобразованное в значение JS. Кроме функции отрисовки, объект может содержать:
getValue(element)— возвращает значение для фиксации. Строка'canceled'отменяет правку. Для редактора поля ввода при отсутствии этой функции берется текст самого поля.clear(element, cancel)— очистка при завершении правки.cancelистинен при отмене.onBrowserEvent(event, element)— обработка событий браузера во время правки.
Контроллер редактора
Контроллер редактора предоставляет:
| метод | что делает |
|---|---|
commit([value]) | фиксирует правку: переданное значение либо, без аргумента, текущее (из getValue или поля ввода) |
cancel() | отменяет правку |
setDeferredCommitOnBlur(true) | откладывает фиксацию при потере фокуса — для выбора из списка подсказок, отрисованного вне element |
setDeferredCommitOnBlur(false) | если редактор фиксирует значение при потере фокуса, фиксация снова выполняется сразу (поведение по умолчанию) |
getColorThemeName() | имя текущей цветовой темы |
form | контроллер формы |
Зафиксированное значение проходит обычный канал изменения свойства — так же, как значение, введенное штатным редактором.
Для вызова commit() у редактора-окна или редактора, замещающего ячейку, требуется getValue(element). Вызов commit(value) пропускает getValue и преобразует переданное значение к типу ввода. Строка 'canceled' означает отмену только как результат getValue.
Например, встроенный редактор googleAutocomplete дополняет поле ввода адреса подсказками Google Maps:
function googleAutocomplete() {
return {
renderInput: (element, controller) => {
// список подсказок отрисовывается вне element, и выбор из него завершается потерей фокуса,
// поэтому фиксация по потере фокуса откладывается до установки значения
controller.setDeferredCommitOnBlur(true);
new google.maps.places.Autocomplete(element, { types: ['address'] });
},
clear: (element, cancel) => {
// удаляем элементы списка подсказок, добавленные в <body>
$(".pac-container").remove();
}
};
}