Метод changeYear

В календаре Flatpickr управление годом является частью системы навигации по датам и напрямую влияет на отображаемый диапазон календарной сетки. Изменение года используется для программного переключения текущего контекста календаря без необходимости ручного выбора пользователем через интерфейс.

Метод изменения года применяется для синхронизации состояния календаря с внешними данными, реализации кастомной логики навигации, а также для принудительного перехода к конкретному временному диапазону.

Основная задача такого метода — обновление внутреннего состояния инстанса календаря и перерисовка UI с учётом нового значения года.

Внутреннее поведение при смене года

При вызове изменения года Flatpickr выполняет несколько последовательных операций:

  • обновление внутреннего состояния даты (viewDate)
  • пересчёт отображаемого диапазона месяцев
  • проверка ограничений minDate и maxDate
  • синхронизация выделенной даты (если она существует)
  • перерисовка календарной сетки
  • вызов соответствующих hook-событий

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

Общий формат вызова

В контексте экземпляра Flatpickr изменение года обычно выполняется через методы управления датой или через внутреннюю навигацию:

fp.changeYear(year);

В некоторых реализациях логика может быть встроена в общий метод установки даты:

fp.setDate(new Date(year, month, day), true);

Однако логически изменение года рассматривается как отдельная операция навигации по временной шкале.

Параметры и их смысл

Обычно при работе с годом используются следующие входные значения:

year Целое число, определяющее целевой год отображения календаря.

Дополнительно в расширенных реализациях может учитываться:

  • флаг триггера обновления событий (triggerChange)
  • сохранение текущего месяца при смене года
  • принудительная нормализация даты при выходе за границы диапазона

При передаче некорректного значения (например, строки или NaN) поведение зависит от внутренней валидации, но чаще всего происходит игнорирование вызова или приведение к текущему состоянию.

Взаимодействие с ограничениями диапазона

Flatpickr строго учитывает ограничения:

  • minDate
  • maxDate

При изменении года возможны следующие сценарии:

  • если новый год полностью ниже minDate — календарь будет скорректирован к минимально допустимому значению
  • если новый год превышает maxDate — произойдёт ограничение верхней границей
  • если год частично пересекается с допустимым диапазоном — корректируется только отображение месяцев

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

Связь с текущей выбранной датой

Если в календаре уже установлена дата, изменение года влияет на неё следующим образом:

  • если дата остаётся валидной — она сохраняется
  • если дата становится невалидной — происходит автоматическая корректировка
  • если дата не установлена — изменяется только отображаемый контекст

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

Влияние на интерфейс календаря

После изменения года происходит полная переработка отображения:

  • обновляется заголовок календаря (если он включает год)
  • пересчитывается сетка дней
  • обновляются кнопки навигации (disabled/enabled состояния)
  • перерисовываются выделенные диапазоны

Если используется альтернативный UI (например, кастомные заголовки), они должны быть синхронизированы через hook-и.

Событие изменения года

Flatpickr предоставляет hook для отслеживания смены года:

onYearChange: function(selectedDates, dateStr, instance) {
    // логика обработки
}

Событие вызывается после того, как год уже применён и календарь обновлён. Это позволяет безопасно считывать актуальное состояние инстанса.

Типичные сценарии использования:

  • синхронизация внешнего селектора года
  • загрузка данных для конкретного года
  • аналитика навигации пользователя по календарю

Сочетание с изменением месяца

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

  • сначала применяется год
  • затем корректируется месяц (если требуется)
  • затем пересчитывается дата

При неправильной последовательности может возникнуть скачкообразное изменение UI, особенно при переходе через границы диапазона.

Ограничения и особенности реализации

Существуют важные нюансы:

  • год может изменяться без изменения месяца
  • переход между годами не всегда вызывает изменение выбранной даты
  • при включённом режиме inline календарь обновляется мгновенно
  • при использовании appendTo/positionElement может происходить перерасчёт позиции UI

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

Практические сценарии использования

Изменение года применяется в следующих архитектурных задачах:

  • реализация кастомных dropdown-списков годов вместо стандартной навигации
  • синхронизация календаря с внешними фильтрами (например, отчётность по годам)
  • построение аналитических интерфейсов, где дата служит ключевым параметром выборки
  • автоматическая установка периода при загрузке данных из API
  • создание ограниченных календарей (например, только текущий и предыдущий год)

Поведение при быстром переключении

При частом вызове смены года Flatpickr:

  • оптимизирует перерисовку UI
  • агрегирует изменения состояния
  • пересчитывает диапазоны один раз на цикл обновления

Однако при кастомных обёртках без debounce может наблюдаться избыточная нагрузка на DOM.

Работа в связке с пользовательским вводом

Если пользователь вручную вводит дату в input, изменение года программно:

  • может перезаписать визуальное состояние календаря
  • не обязательно изменяет значение input до подтверждения
  • синхронизируется при закрытии календаря или вызове соответствующих событий

Это поведение важно при разработке форм с валидацией на лету.

Типичные ошибки при использовании

На практике часто встречаются следующие проблемы:

  • попытка передать строковый год без преобразования в число
  • игнорирование minDate/maxDate при внешней логике
  • конфликт между setDate и изменением года
  • отсутствие синхронизации UI при кастомной теме календаря

Корректная работа требует учёта внутреннего состояния Flatpickr, а не только визуального результата.

Оглавление