setOrientation – Изменить ориентацию содержимого формы
Синтаксис:
setOrientation(orientation)
Параметры:
Имя
|
Тип
|
Описание
|
orientation
|
string
|
Ориентация HTML-разметки. Возможные значения: "vertical" – поля располагаются под названием поля; "horizontal" – поле и его название располагаются в одной строке. Значение по умолчанию - "horizontal"
|
Описание:
Поддерживается вертикальная и горизонтальная ориентация.
Метод используется до вызова одной из функций добавления поля, например addText или addReferenceSelect, сразу после вызова конструктора либо после вызова метода render.
Возвращаемое значение:
Oбъект класса FormBuilder.
|
getValue – Получить значение поля
Синтаксис:
getValue(name, opt_byId)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
opt_byId
|
boolean
|
Признак, отключено ли внутреннее преобразование идентификатора. Если отключено, указанный идентификатор используется в неизменном виде
|
Возвращаемое значение:
Значение поля.
|
setValue – Устанавливает значение указанного поля
Синтаксис:
setValue(name, value, displayValue, opt_byId)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
value
|
string
|
Значение поля
|
displayValue
|
string
|
Отображаемое значение поля
|
opt_byId
|
boolean
|
Отключить внутренние преобразования идентификатора, и использовать указанный.
|
Описание:
Метод можно использовать, только когда поле уже отображаетсяна странице.
Например, если форма используется в модальном окне, то метод необходимо использовать только после события open модального окна:
dialog.bind('open', function() {
form.setValue(.....)
...
})
Возвращаемое значение:
Объект типа FormBuilder.
|
getDisplayValue – Получить отображаемое значение поля
Синтаксис:
getDisplayValue(name)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Имя поля
|
Возвращаемое значение:
Отображаемое значение поля.
|
setValue – Устанавливает значение указанного поля
Синтаксис:
setValue(name, value, displayValue, opt_byId)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
value
|
string
|
Значение поля
|
displayValue
|
string
|
Отображаемое значение поля
|
opt_byId
|
boolean
|
Отключить внутренние преобразования идентификатора, и использовать указанный.
|
Описание:
Метод можно использовать, только когда поле уже отображаетсяна странице.
Например, если форма используется в модальном окне, то метод необходимо использовать только после события open модального окна:
dialog.bind('open', function() {
form.setValue(.....)
...
})
Возвращаемое значение:
Объект типа FormBuilder.
|
getDisplayValue – Получить отображаемое значение поля
Синтаксис:
getDisplayValue(name)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Имя поля
|
Возвращаемое значение:
Отображаемое значение поля.
|
getHeight – Получить высоту формы
Синтаксис:
getHeight()
Описание:
Устаревший метод, оставлен для совместимости с предыдущими версиями. Не рекомендуется его использовать.
Возвращаемое значение:
Высота формы.
|
getHeigth – Получить высоту формы
addText – Добавить текст на форму
Синтаксис:
addText(name)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addText – Добавить текст на форму
Синтаксис:
addText(name)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addInput – Добавить поле типа «Текст»
Синтаксис:
addInput(name, opt_maxlength, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
opt_maxlength
|
number
|
Допустимое количество символов в поле
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addFileField – Добавить поле типа «File»
Синтаксис:
addFileField(name, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору поля
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addHiddenField – Добавить скрытое поле
Синтаксис:
addHiddenField(name, value)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору поля
|
value
|
string
|
Значение поля
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addDate – Добавить поле для выбора даты
Синтаксис:
addDate(name, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору поля
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addTextarea – Добавить многострочное поле
Синтаксис:
addTextarea(name, opt_defaultvalue, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
opt_defaultvalue
|
string
|
Значение по умолчанию
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addTextFrame – Добавить многострочное поле фиксированной высоты
Синтаксис:
addTextFrame(name, defaultvalue, opt_maxHeigth, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору поля
|
defaultvalue
|
string
|
Значение по умолчанию
|
opt_maxHeigth
|
integer
|
Высота, в рамках которой ограничивается поле
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила коррктности заполнения формы
|
Возвращаемое значение:
Объект класса FormBuilder.
|
addTextarea – Добавить многострочное поле
addSelect – Добавить поле выбора из списка
Синтаксис:
addSelect(name, options, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
options
|
dictionary
|
Список элементов выбора
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addRadioButtons – Добавить группу переключателей
Синтаксис:
addRadioButtons(name, options, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации, равная идентификатору этого поля
|
options
|
dictionary
|
Список элементов выбора
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addReferenceSelect – Добавить поле типа «Справочник»
Синтаксис:
addReferenceSelect(name, referenceCode, opt_toolTip, opt_searchReqName, opt_filter, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
referenceCode
|
string
|
Код справочника
|
opt_toolTip
|
string
|
Текст всплывающей подсказки для кнопки выбора из справочника
|
opt_searchReqName
|
string
|
Отображаемый реквизит. По умолчанию реквизит «Наименование»
|
opt_filter
|
string
|
Выражение фильтрации. Для выбора будут доступны только отфильтрованные записи указанного справочника
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addObjectList – Добавить поле типа «Список объектов»
Синтаксис:
addObjectList(name, type, opt_liks, opt_isList, referenceCode, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля.
|
type
|
string
|
Возможные значения: EDOCUMENT, JOB, FOLDER, TASK, REFERENCE_RECORD, ANY
|
opt_liks
|
WebAccess.components.forms.FormBuilder.objectLink
|
Ссылки объектов по умолчанию. Подробнее см. WebAccess.components.forms.FormBuilder.objectLink
|
opt_isList
|
boolean
|
Значение True, если можно вставить несколько объектов в поле, иначе False
|
referenceCode
|
string
|
Код справочника.
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
Пример
var form = new WA.CMP.forms.FormBuilder("1")
form.addObjectList("YEsdscSd", OBJECT_TYPE.REFERENCE_RECORD,[{"id": "103619", "type": OBJECT_TYPE.REFERENCE_RECORD, "referenceCode": "ПРС"}], true,'ПРС')
var dialog = new WA.CMP.dialogs.BaseDialog("as")
dialog.setHtml(form.render())
dialog.width = 700
dialog.show()
|
|
addMultiSelect – Добавить поле множественного выбора из справочника
Синтаксис:
addMultiSelect(name, referenceNames, opt_toolTip, opt_searchReqName, opt_filter, opt_isMultiSelect, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
referenceNames
|
string
|
Коды справочников, разделенные ";"
|
opt_toolTip
|
string
|
Текст всплывающей подсказки
|
opt_searchReqName
|
string
|
Отображаемый реквизит
|
opt_filter
|
string
|
Выражение фильрации. В поле будут доступны только отфильтрованные записи выбранного справочника
|
opt_isMultiSelect
|
boolean
|
Признак множественного выбора
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addPick – Добавить поле типа «Признак»
Синтаксис:
addPick(name, values, opt_displayValues, opt_disabledValues, opt_editable, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
values
|
dict
|
Ассоциативный массив, содержащий пары: ИД пункта выпадающего списка – отображаемое значение пункта
|
opt_displayValues
|
dict
|
Отображаемые значения для выпадающего списка
|
opt_disabledValues
|
array
|
Пункты недоступные для выбора
|
opt_editable
|
boolean
|
Если значение true, то поле ввода становится доступным для изменения. В случае, если значение было введено вручную, метод getValue вернет пустую строку. Такое значение необходимо получать методом getDisplayValue
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Текущий конструктор форм.
|
addCustomField – Добавить поле с произвольным содержимым
Синтаксис:
addCustomField(name, html, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
html
|
string
|
HTML-разметка. Должна содержать указанный параметр name
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addCheckbox – Добавить переключатель
Синтаксис:
addCheckbox(name, opt_isChecked, opt_validateRules)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Строка локализации равная идентификатору этого поля
|
opt_isChecked
|
bool
|
Проверяет, установлен переключатель или нет
|
opt_validateRules
|
WebAccess.components.forms.FormBuilder.validatorRules
|
Правила корректности заполнения формы
|
Возвращаемое значение:
Oбъект класса FormBuilder.
|
addValidationRule – Добавить правила корректности ввода данных
Синтаксис:
addValidationRule(name, handler, opt_error_message)
Параметры:
Имя
|
Тип
|
Описание
|
name
|
string
|
Название правила
|
handler
|
function
|
Функция проверки правила
|
opt_error_message
|
string
|
Сообщение об ошибке, возникающей при невыполнении правила
|
Пример
// К правилам корректности ввода данных добавляется новое «MoreThanTen».
// Правило означает, что форма заполнена правильно, если значение поля больше 10.
var form = new WA.CMP.forms.FormBuilder('buldy');
form.addValidationRule('moreThanTen', function(value, display) {
console.log(arguments);
if (value < 10) return false;
return true;
}, L('ERROR'));
var dialog = new WA.CMP.dialogs.BaseDialog();
//Применяем правило к полю «YES».
form.addInput("YES", 100, {'isRequired': true, 'moreThanTen': true});
dialog.setHtml(form.render());
dialog.show();
dialog.ok = function() {
if (form.isValid() !== true) return false;
}
|
|
isValid – Проверить корректность значений
Синтаксис:
isValid()
Возвращаемое значение:
True, если значения полей формы корректны, иначе False.
|
setAction – Установить адрес для отправки формы
Синтаксис:
setAction(url)
Параметры:
Имя
|
Тип
|
Описание
|
url
|
string
|
Адрес для отправки формы
|
Возвращаемое значение:
Текущий конструктор форм.
|
setMethod –
Метод для отправки формы
Синтаксис:
setMethod(form_method)
Параметры:
Имя
|
Тип
|
Описание
|
form_method
|
FORM_METHOD
|
Метод для отправки формы
|
Возвращаемое значение:
Текущий конструктор форм.
|
|