Изображение

Элемент управления Изображение предназначен для показа изображений из данных карточки и загрузки изображений.

Пример элемента управления "Изображение"
Рисунок 1. Пример элемента управления "Изображение"

Элемент управления поддерживает добавление только файлов формата JPEG (.jpeg, .jpg).

Для элемента управления можно разработать функцию, которая будет устанавливать изображение по умолчанию, если изображение не выбрано. См. пример в пункте Настройка разметки диалога профиля пользователя.

Свойства

Общие

Название ЭУ

Название типа элемента управления.

Название

Уникальное название элемента управления.

Тег

Простое текстовое свойство, позволяющее добавить для ЭУ скрипт (например, JSON).

Внешний вид

Высота

Определяет вертикальный размер элемента управления в пикселях.

В зависимости от размеров оригинального изображения при отображении оно будет увеличено или уменьшено с сохранением соотношения сторон. Часть изображения может быть обрезана по ширине.

Заполнитель

Текст, отображаемый в элементе управления, если значение не выбрано.

Локализуемый

Заполнитель при перетаскивании

Текст, отображаемый в элементе управления при перетаскивании файла изображения с файловой системы в элемент управления.

Локализуемый

Подсказка

Содержимое всплывающей подсказки.

Локализуемый

Скругление

Устанавливает процент скругления углов изображения в процентах:

  • 0 — скругление отсутствует,

  • 50% — максимальное скругление (значение по умолчанию).

Данные

Расширенный источник данных

Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.

Источник данных

Секция карточки, содержащая данные элемента управления.

Может быть выбрана простая или коллекционная (табличная) секция. При выборе коллекционной секции элемент управления будет получать и изменять данные в первой строке секции.

Для полноценной работы с коллекционной секцией элемент управления Изображение нужно встроить в элемент управления "Таблица".

Поле данных

Поле карточки с данными элемента управления. Тип поля — image.

Операция редактирования

Выбор операции редактирования значения элемента управления. Если операция недоступна пользователю, изменение значения элемента управления также недоступно. Если операция не выбрана, возможность редактирования значения элемента управления не проверяется.

Если значение Операции редактирования наследуется от родительского Блока, название свойства меняется на Операция редактирования (наследовано).

Поведение

Видимость

Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.

Адаптивный

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

Загрузка разрешена

Включает/отключает возможность загрузки изображений в карточку с помощью элемента управления.

Обязательное

Определяет требование к заполнению значения ЭУ до сохранения карточки:

  • Когда флаг установлен, значение ЭУ должно быть присвоено, иначе карточка не будет сохранена. При этом ЭУ помечается предупреждающим сообщением.

  • Когда флаг не установлен, присваивать значение необязательно.

Операция редактирования для видимости

Определяет операцию, которая должна быть доступна, чтобы ЭУ отображался для пользователя. Работа свойства зависит от значения свойства Видимость:

  • Когда флаг Видимость установлен и выбрана операция редактирования для видимости, видимость элемента определяется исходя из доступности пользователю выбранной операции редактирования.

  • Когда флаг Видимость установлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда.

  • Когда флаг Видимость НЕ установлен, ЭУ всегда скрыт.

Режим редактирования

Определяет вариант отображения элемента управления и возможность изменения его значения:

  • По месту. Значение изменяется нажатием на элемент управления.

    Данный вариант подходит как для разметки режима редактирования, так и для разметки режима просмотра карточки.

  • Редактирование. Значение изменяется непосредственно в элементе управления.

    Данный вариант может быть выбран в разметке режима редактирования и просмотра.

    Если элемент с режимом Редактирование добавлен в разметку просмотра, необходимо самостоятельно обеспечить сохранение его значения. Например, с использованием скриптов карточек.

  • Без редактирования. Значение изменить нельзя.

Стандартный css класс

Название CSS класса, в котором определён стандартный стиль элемента управления.

События

Перед сбросом изображения

Вызывается при нажатии кнопки удаления изображения.

Получение изображения по умолчанию

Обработчик для получения изображения по умолчанию. Может быть указана собственная функция, возвращающая изображение по умолчанию для элемента управления.

После сброса изображения

Вызывается после нажатия кнопки удаления изображения.

При наведении курсора

Вызывается при входе курсора мыши в область элемента управления.

При отведении курсора

Вызывается, когда курсор мыши покидает область элемента управления.

При щелчке

Вызывается при щелчке мыши по любой области элемента управления.