Дата/время
Элемент управления Дата/время предназначен для ввода и отображения даты или даты и времени из связанного поля карточки.
Интерфейс элемента управления зависит от свойства Режим редактирования:
-
Редактирование, В данном режиме ЭУ представляет собой поле для ввода значения, которое также можно выбрать из календаря (открывается кнопкой
). -
В режиме По месту новое значение автоматически сохраняется в карточку.
Рисунок 1. Элемент управления "Дата/время" в режиме редактирования "По месту"
Рисунок 2. Пример календаря для выбора значения -
Без редактирования. В данном режиме ЭУ представляет собой строку, в которой отображается значение даты и времени из поля карточки.
Рисунок 3. Элемент управления "Дата/время" в режиме без редактирования
Свойства
Внешний вид
Отображать диалог выбора времени
Флаг позволяет отключить или включить отображение диалога выбора времени для элемента управления. По умолчанию флаг активен, то есть диалог выбора времени отображается.
Когда флаг неактивен, пользователю доступен только календарь для выбора даты, время можно указать вручную с клавиатуры.
| Диалог выбора времени доступен в разметках редактирования или редактирования по месту, только если в свойстве Тип выбран пункт Дата и время. |
Отображать метку без значения
Определяет вариант отображения метки.
-
Когда флаг установлен, текст метки отображается всегда.
-
Когда флаг не установлен, текст метки отображается, только если задано значение ЭУ.
Подсвечивать просроченность
Дата и время в ЭУ будут подсвечены красным цветом (значение по умолчанию), если установленный срок превышен.
-
Флаг установлен. ЭУ будет подсвечен, если текущаие дата и/или время превышают значения ЭУ.
-
Флаг не установлен. Сроки не проверяются, ЭУ не будет подсвечен.
ЭУ предоставляет возможность изменить цвет сигнализирования о просрочке. К примеру, чтобы установить зеленый цвет сигнализирования, создайте в папке C:\Program Files (x86)Docsvision\WebClient\Site\Content\Solutions\SampleSolution\Styles\ файл sample.css с содержимым:
.system-datetimepicker.highlight-overdue.overdue:not(.edit-mode) .labeled-text-helper .text-cell .labeled-text { (1)
font-weight: bold;
color: green;
}| 1 | not(.edit-mode) — Данный стиль будет использован только при просмотре карточки. |
Данные
Расширенный источник данных
Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.
Операция редактирования
Выбор операции редактирования значения элемента управления. Если операция недоступна пользователю, изменение значения элемента управления также недоступно. Если операция не выбрана, возможность редактирования значения элемента управления не проверяется.
Если значение Операции редактирования наследуется от родительского Блока, название свойства меняется на Операция редактирования (наследовано).
Значение по умолчанию
| Свойства из категории "Значение по умолчанию" доступны только в режиме редактирования и недоступны в режимах просмотра и редактирования по месту. |
Время по умолчанию
Свойство недоступно в режиме редактирования по месту, доступно только в режиме редактирования.
Время, которое будет установлено по умолчанию в ЭУ:
-
Текущее время. Будет установлено текущее время.
-
Начало дня. Будет установлено время
00:00. -
Начало рабочего дня. Будет установлено время начала рабочего дня из бизнес-календаря.
-
Конец дня. Будет установлено время
23:59. -
Конец рабочего дня. Будет установлено время конца рабочего дня из бизнес-календаря.
Если выбрано значение Начало рабочего дня или Конец рабочего дня, то при расчете времени будет использован бизнес-календарь:
-
Календарь по умолчанию, который выбран в справочнике Системные настройки ().
-
Если не выбран календарь по умолчанию, будет использован системный бизнес-календарь (рабочий день с 9 до 18 часов, суббота и воскресенье — выходной).
Значение по умолчанию
Свойство недоступно в режиме редактирования по месту, доступно только в режиме редактирования.
Дата и время, которые будут установлены по умолчанию в ЭУ. Флаг Текущая дата должен быть снят. Если в свойствах ЭУ установлено смещение значения по умолчанию, то значение ЭУ будет скорректировано с учетом этого параметра.
Если время не указано (время 00:00), то в значении ЭУ время будет получено из бизнес-календаря — время начала рабочего дня.[1].
Аналогичное поведение будет при работе с ЭУ в карточке: если стереть время, после выбора даты будет установлено время, полученное из бизнес-календаря.
Смещение значения по умолчанию (в часах)
Количество часов (целое число), которое будет прибавлено к предварительному значению ЭУ, вычисленому из значения свойств Значение по умолчанию или Время по умолчанию. Можно указывать отрицательное значение. Например, чтобы сдвинуть время по умолчанию на день вперед, в поле Смещение значения по умолчанию нужно ввести значение "24" (часа).
Поведение
Видимость
Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.
Адаптивный
Дополнительные css классы
Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.
Операция редактирования для видимости
Определяет операцию, которая должна быть доступна, чтобы ЭУ отображался для пользователя. Работа свойства зависит от значения свойства Видимость:
-
Когда флаг
Видимостьустановлен и выбрана операция редактирования для видимости, видимость элемента определяется исходя из доступности пользователю выбранной операции редактирования. -
Когда флаг
Видимостьустановлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда. -
Когда флаг
ВидимостьНЕ установлен, ЭУ всегда скрыт.
Отключен
Когда флаг установлен, отключается возможность изменить значения элемента управления. Работает совместно со свойством `Операция редактирования. Редактирование будет запрещено, если одно из свойств запрещает редактирование.
Адаптивный
Запретить выбор будущих дат
При установленном флаге пользователю будет запрещено устанавливать и выбирать из календаря даты, позже текущей. Если введена запрещённая дата, будет выдана ошибка.
Запретить выбор прошедшей даты
При установленном флаге пользователю будет запрещено устанавливать и выбирать из календаря даты, раньше текущей. Если введена запрещённая дата, будет выдана ошибка.
Переходить по TAB
Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.
Показывать иконку
Свойство регулирует отображение иконки элемента управления. Когда флаг установлен (по умолчанию) иконка ЭУ отображается. Когда флаг снят, иконка не отображается.
Режим редактирования
Определяет вариант отображения элемента управления и возможность изменения его значения:
-
По месту. Значение изменяется нажатием на элемент управления.
Данный вариант подходит как для разметки режима редактирования, так и для разметки режима просмотра карточки.
-
Редактирование. Значение изменяется непосредственно в элементе управления.
Данный вариант может быть выбран в разметке режима редактирования и просмотра.
Если элемент с режимом Редактирование добавлен в разметку просмотра, необходимо самостоятельно обеспечить сохранение его значения. Например, с использованием скриптов карточек.
-
Без редактирования. Значение изменить нельзя.
НАШЛИ ОШИБКУ?