CustomImage

CustomImage - контрол, позволяющий пользователю загрузить изображение в систему.

Свойства

bind

тип	значение по умолчанию	допустимые значения
string	-

Свойство, к которому биндится (привязывается) контрол.

caption

тип	значение по умолчанию	допустимые значения
string	-

Заголовок контрола

captionWidth

Ширина заголовка в колонках (для Bootstrap-верстки).

Отнаследовано от Control

denyRoles

Список ролей без прав на данный элемент.

Отнаследовано от Control.

editorWidth

Ширина контрола в колонках (для Bootstrap-верстки).

отнаследовано от Control. По умолчанию значение 3

height

тип	знач. по умолч.	допустимые значения
string	-

Высота контрола.

hint

Всплывающая подсказка, которая появляется при наведении на контрол.

Отнаследовано от Control.

id

Идентификатор контрола.

Отнаследовано от Control.

imageId

тип	значение по умолчанию	допустимые значения
string	-

Уникальный идентификатор, использующийся для составления url, по которому будет загружена отображаемая картинка

readOnly

тип	значение по умолчанию	допустимые значения
bool	false	true/false

Режим "только для чтения"

readRoles

Список ролей на чтение данных.

отнаследовано от Control.

tags

Позволяет объединять контролы в группы, возвращает массив имен.

Отнаследовано от Control.

visible

Видимость контрола.

Отнаследовано от Control.

width

Ширина контрола.

Отнаследовано от Control.

writeRoles

Список ролей на изменение данных.

отнаследовано от Control.

События

valueChanged

Срабатываем при изменении значения.

таблицаобъект

параметр	тип	описание
s	CustomImage	экземпляр класса контрола
e	string	строка imageId

s = CustomImage {
    ... // экземпляр класса CustomImage
},
e = 'Строка imageId'

Пример

myForm.xmlmyForm.js

<CustomImage ... valueChanged="CustomImageExample_valueChanged" />

CustomImageExample_valueChanged (s, e) {
    console.log('s', s)
    console.log('e', e)
}

Поведение

До загрузки изображения в контроле отображается стандартная картинка, означающая отсутствие пользовательского изображения.

Осуществить загрузку можно с помощью кнопки "Загрузить", по нажатию которой открывается диалог выбора файла. Сразу после выбора начинается отправка файла на сервер. После окончания загрузки изображение отображается в контроле.

Удаление изображения производится с помощью кнопки "Удалить".

Сохранение картинки

Предполагается, что при загрузке пользователем изображения оно сохраняется в БД с уникальным идентификатором (GUID) в качестве имени, передающемся затем в свойство imageId контрола.

Для привязки контрола к модели данных используется кастомный биндинг imageId. Типом свойства модели должен быть тип File.

Примеры

Пример

<Group caption="myCustomImage">
    <CustomImage id="customImageContent" caption="Загрузка изображения" bind="Content" editorWidth="4"/>
</Group>

---