подсвечивает или блокирует определённые дату(ы), применяя либо стиль по умолчанию, либо кастомный стиль. Подсветка снимается сразу после любого внутреннего обновления в приложении. Это может быть полезно для выделения определённых дат.
config | object | подробности конфигурации для выделяемого или блокируемого диапазона времени |
array | возвращается массив HTML-элементов |
//подсветить определённые даты
scheduler.markTimespan({
days: 5, // подсвечивает каждую пятницу
zones: "fullday", // подсвечивает весь день
css: "gray_section" // применяемый CSS класс
});
//подсветить и заблокировать определённые даты
scheduler.markTimespan({
days: 5,
zones: "fullday",
css: "gray_section",
type: "dhx_time_block" // фиксированное значение для блокировки диапазона времени
});
Этот метод доступен начиная с версии 3.5.
Этот метод требует включения плагина limit.
Объект конфигурации поддерживает следующие свойства:
Свойство | Описание |
---|---|
start_date | объект Date, указывающий начало ограничения |
|
|
end_date | объект Date, указывающий конец ограничения |
|
|
days | дни, к которым применяется ограничение |
|
|
zones | временные интервалы в минутах, к которым применяется ограничение |
|
|
css | имя CSS класса для применения |
|
|
html | HTML содержимое для отображения внутри выделенного диапазона |
|
|
type | задаёт тип диапазона времени. Установка в 'dhx_time_block' блокирует диапазон. Любое другое значение лишь подсвечивает диапазон без блокировки |
|
|
invert_zones | определяет, следует ли инвертировать временные зоны (установленные в 'zones'), по умолчанию false |
|
|
sections | ограничивает блокировку конкретными элементами в определённых представлениях. Блокировка применяется только в этих связанных представлениях |
|
Имейте в виду, что days, zones и start_date, end_date образуют пары для определения интервала блокировки и не должны смешиваться иначе. Например, нельзя использовать zones вместе с start_date или одновременно сочетать days с обоими start_date и end_date.
Существует два валидных набора свойств, которые можно использовать:
Набор свойств | Пример |
---|---|
|
|
|
addMarkedTimespan | markTimespan |
требует вызова метода updateView для отрисовки DIV для диапазона времени | автоматически отрисовывает DIV для диапазона времени |
диапазон(ы) времени остаются видимыми постоянно | диапазон(ы) времени скрываются сразу после любого внутреннего обновления в приложении |
возвращает ID созданного(ых) диапазона(ов) времени | возвращает DIV или массив DIV-элементов |