Методы

Состав расширений задаётся при создании экземпляра. Заранее зарегистрируйте модули, которые будете включать через set() или update(). Эти методы по-прежнему меняют существующие опции, но не добавляют и не удаляют модули. Один объект настроек или массив расширений можно использовать для нескольких календарей: состояние каждого экземпляра независимо. Включение функции без модуля вызывает понятную ошибку в init(), set() или update(); неактивные настройки и обработчики модуля не требуют.

init()

Метод init() является основным методом экземпляра, который запускает процесс инициализации календаря.

const calendar = new Calendar(element, params);
calendar.init();

update()

Метод update() позволяет применить к календарю новые настройки и выполнять сброс. Этот метод принимает объект с необязательными аргументами для управления сбросом, по умолчанию сбрасывая выбранную пользователем дату, месяц и год после обновления.

Все aгрументы, по умолчанию true:

{
  year: boolean;
  month: boolean;
  dates: boolean | 'only-first';
  holidays: boolean;
  time: boolean;
}

• true - сбросится до параметров, указанных в настройках;
• false - не выполнит сброс, оставит параметры выбранные пользователем;
• 'only-first' - сбрасывает все выбранные даты, оставляя самую раннюю. Если тип выбора даты указан как 'multiple-ranged', добавляется обработчик 'mousemove' и 'keydown' для наведения.

Пример использования:

calendar.locale = 'de-AT';
calendar.firstWeekday = 0;
 
calendar.update({
  dates: true,
});

set()

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

Пример использования:

calendar.set({
  locale: 'de-AT',
  firstWeekday: 0,
}, {
  dates: true,
});

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

const calendar = new Calendar(element);
calendar.set({ locale: 'de-AT', firstWeekday: 0 });
calendar.init();

destroy()

Eсли вам нужно полностью удалить экземпляр календаря, вы можете использовать метод destroy().

calendar.destroy();

show()

Метод show() позволяет показать календарь, если он был скрыт.

calendar.show();

hide()

Метод hide() позволяет скрыть календарь, если он был показан.

calendar.hide();