Файл замечаний

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

ЭУ представляет собой поле со ссылкой на файл замечаний и кнопкой три вертикальные точки для открытия меню.

Элемент управления "Файл замечаний"
Рисунок 1. Элемент управления "Файл замечаний"

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

Данный ЭУ может быть добавлен только в разметку, предназначенную для просмотра карточек.

Свойства

Общие

Название ЭУ

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

Название

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

Тег

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

Внешний вид

Заполнитель

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

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

Отображать метку без значения

Определяет вариант отображения метки.

  • Когда флаг установлен, текст метки отображается всегда.

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

Подсказка

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

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

Текст метки

Содержимое метки, отображаемой слева от элемента управления.

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

Данные

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

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

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

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

Поле данных

Поле карточки, имеющее тип FileId.

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

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

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

Поведение

Видимость

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

Адаптивный

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

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

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

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

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

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

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

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

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

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

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

Отключен

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

Адаптивный

Переходить по TAB

Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.

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

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

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

  • Редактирование. Значение изменяется непосредственно в элементе управления. Данный вариант может быть выбран в разметке режима редактирования и просмотра.

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

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

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

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

События

Перед открытием диалога выбора файла

Вызывается перед открытием диалога выбора файла замечаний.

Перед открытием превью

Вызывается перед открытием предварительного просмотра файла.

Перед открытием файла через WebDAV

Вызывается перед открытием файла с использование WebDAV.

При сохранении файла в WebDAV

Вызывается при сохранении файла с использованием WebDAV.

Перед скачиванием файла

Вызывается перед скачиванием файла.

Перед удалением файла

Вызывается перед удалением файла.

После закрытия диалога выбора файла

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

После открытия превью

Вызывается после открытия предварительного просмотра файла.

После удаления файла

Вызывается после удаления файла.

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

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

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

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

При получении фокуса

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

При потере фокуса

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

После смены данных

Вызывается после изменения содержимого элемента управления.

При щелчке

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