Выбор папки

Элемент управления Выбор папки предназначен для выбора папки.

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

В зависимости от значения свойства Отображать дерево папок в элементе управления может отображаться ссылка. При нажатии на ссылку будет открыто дерево папок для выбора папки, или сразу определённая папка.

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

Свойства

Общие

Название ЭУ

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

Название

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

Тег

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

Внешний вид

Заполнитель

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

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

Подсказка

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

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

Текст метки

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

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

Поведение

Видимость

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

Адаптивный

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

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

Значение по умолчанию

Определяет папку, выбранную по умолчанию:

  • Не указано. По умолчанию не выбирается никакая папка.

  • Текущая папка. По умолчанию выбирается активная папка.

    Если в текущей папке создание карточек запрещено (например, папка является виртуальной, или установлено ограничение на создание карточек), то к предложению выбрать папку будет добавлено сообщение: "(в текущей запрещено)".

Использовать список папок

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

Список настраивается с помощью формы, открываемой по нажатию кнопки Три точки.

Настройка списка папок
Рисунок 2. Настройка списка папок
Чтобы добавить папку:

  1. Нажмите кнопку Добавить папку.

  2. В поле Идентификатор введите идентификатор (GUID) папки.

  3. Если для выбора должны быть также доступны подпапки указанной папки, установите флаг Дочерние папки.

Чтобы изменить порядок отображения папок у пользователя, используйте кнопки Вниз/Вверх.

Если требуется, некоторые папки могут быть временно исключены из списка доступных для выбора. Для этого снимите с них флаг Выбрано — на панели инструментов должен быть включён режим Только выбранные папки. В режиме Все папки пользователям будут доступны все папки из списка независимо от значения флага Выбрано.

Если в Значение по умолчанию установлена Текущая папка и данная папка есть в списке, у пользователя она будет отображаться первой в списке. Если Текущая папка отсутствует в списке, она также будет добавлена в список папок, доступных пользователю. Если нужно полностью ограничить возможность выбора папок установленным списком, выберите Не указано в Значение по умолчанию.

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

Когда флаг установлен, папка должна быть выбрана перед сохранением карточки. Когда флаг не установлен, выбирать папку не требуется.

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

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

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

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

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

Отображать дерево папок

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

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

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

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

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

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

События

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

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

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

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

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

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

При щелчке

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