Files
WYGIWYH/frontend/src/js/datepicker.js
T
Herculino Trotta e2981bf1f6 fix(datepicker): keep pickers working after history back and forward
A history restore swaps in htmx's snapshot of the body, which carries a
lifeless copy of AirDatepicker's global container. The previous fix looked
the container up by id, found that copy, and left the library's real
container detached, so pickers opened into nothing.

Track the container through datepicker.$container instead, remove any
snapshot copies after a swap, and reattach the real one when detached.
2026-11-13 15:18:06 -03:00

370 lines
13 KiB
JavaScript

import AirDatepicker from 'air-datepicker';
import { createPopper } from '@popperjs/core';
import '../styles/_datepicker.scss'
// --- Static Locale Imports ---
// We import all locales statically to ensure Vite transforms them correctly.
import localeAr from 'air-datepicker/locale/ar.js';
import localeBg from 'air-datepicker/locale/bg.js';
import localeCa from 'air-datepicker/locale/ca.js';
import localeCs from 'air-datepicker/locale/cs.js';
import localeDa from 'air-datepicker/locale/da.js';
import localeDe from 'air-datepicker/locale/de.js';
import localeEl from 'air-datepicker/locale/el.js';
import localeEn from 'air-datepicker/locale/en.js';
import localeEs from 'air-datepicker/locale/es.js';
import localeEu from 'air-datepicker/locale/eu.js';
import localeFi from 'air-datepicker/locale/fi.js';
import localeFr from 'air-datepicker/locale/fr.js';
import localeHr from 'air-datepicker/locale/hr.js';
import localeHu from 'air-datepicker/locale/hu.js';
import localeId from 'air-datepicker/locale/id.js';
import localeIt from 'air-datepicker/locale/it.js';
import localeJa from 'air-datepicker/locale/ja.js';
import localeKo from 'air-datepicker/locale/ko.js';
import localeNb from 'air-datepicker/locale/nb.js';
import localeNl from 'air-datepicker/locale/nl.js';
import localePl from 'air-datepicker/locale/pl.js';
import localePtBr from 'air-datepicker/locale/pt-BR.js';
import localePt from 'air-datepicker/locale/pt.js';
import localeRo from 'air-datepicker/locale/ro.js';
import localeRu from 'air-datepicker/locale/ru.js';
import localeSi from 'air-datepicker/locale/si.js';
import localeSk from 'air-datepicker/locale/sk.js';
import localeSl from 'air-datepicker/locale/sl.js';
import localeSv from 'air-datepicker/locale/sv.js';
import localeTh from 'air-datepicker/locale/th.js';
import localeTr from 'air-datepicker/locale/tr.js';
import localeUk from 'air-datepicker/locale/uk.js';
import localeZh from 'air-datepicker/locale/zh.js';
// Map language codes to their imported locale objects
const allLocales = {
'ar': localeAr,
'bg': localeBg,
'ca': localeCa,
'cs': localeCs,
'da': localeDa,
'de': localeDe,
'el': localeEl,
'en': localeEn,
'es': localeEs,
'eu': localeEu,
'fi': localeFi,
'fr': localeFr,
'hr': localeHr,
'hu': localeHu,
'id': localeId,
'it': localeIt,
'ja': localeJa,
'ko': localeKo,
'nb': localeNb,
'nl': localeNl,
'pl': localePl,
'pt-BR': localePtBr,
'pt': localePt,
'ro': localeRo,
'ru': localeRu,
'si': localeSi,
'sk': localeSk,
'sl': localeSl,
'sv': localeSv,
'th': localeTh,
'tr': localeTr,
'uk': localeUk,
'zh': localeZh
};
// --- End of Locale Imports ---
/**
* Selects a pre-imported language file from the locale map.
*
* @param {string} langCode - The two-letter language code (e.g., 'en', 'es').
* @returns {Promise<object>} A promise that resolves with the locale object.
*/
export const getLocale = async (langCode) => {
const locale = allLocales[langCode];
if (locale) {
return locale.default ?? locale;
}
console.warn(`Could not find locale for '${langCode}'. Defaulting to English.`);
const fallbackLocale = allLocales['en'];
return fallbackLocale.default ?? fallbackLocale;
};
function isMobileDevice() {
const mobileRegex = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;
return mobileRegex.test(navigator.userAgent);
}
function isTouchDevice() {
return ('ontouchstart' in window) || (navigator.maxTouchPoints > 0) || (navigator.msMaxTouchPoints > 0);
}
function isMobile() {
return isMobileDevice() || isTouchDevice();
}
// AirDatepicker creates a single overlay for all mobile pickers and keeps it in
// its module scope, inside a global container on the body. A boosted navigation
// swaps the body: AirDatepicker then rebuilds the container, but keeps the old
// overlay, which is left detached and can't receive the clicks that close a picker.
let mobileOverlay = null;
// The container AirDatepicker opens every picker into (its own reference, not a lookup by
// id: a history restore brings back lifeless copies of it from htmx's snapshot).
let globalContainer = null;
function createAirDatepicker(element, opts) {
const datepicker = new AirDatepicker(element, opts);
globalContainer = datepicker.$container;
mobileOverlay ??= globalContainer.querySelector('.air-datepicker-overlay');
if (mobileOverlay && !mobileOverlay.isConnected) {
mobileOverlay.classList.remove('-active-'); // its picker was swapped out while open
globalContainer.appendChild(mobileOverlay);
}
return datepicker;
}
// Pickers kept by hx-preserve aren't recreated, so nothing makes AirDatepicker rebuild
// the container the swap removed: put it back, and drop any snapshot copies of it.
// Runs after htmx:load, so pickers created by this swap have already set globalContainer.
document.addEventListener('htmx:afterSwap', () => {
if (!globalContainer) return;
document.querySelectorAll(`#${AirDatepicker.defaultGlobalContainerId}`).forEach(c => {
if (c !== globalContainer) c.remove();
});
if (!globalContainer.isConnected) document.body.appendChild(globalContainer);
});
window.DatePicker = async function createDynamicDatePicker(element) {
let todayButton = {
content: element.dataset.nowButtonTxt,
onClick: (dp) => {
let date = new Date();
dp.selectDate(date, { updateTime: true });
dp.setViewDate(date);
}
};
let isOnMobile = isMobile();
let baseOpts = {
isMobile: isOnMobile,
dateFormat: element.dataset.dateFormat,
timeFormat: element.dataset.timeFormat,
timepicker: element.dataset.timepicker === 'true',
toggleSelected: element.dataset.toggleSelected === 'true',
autoClose: element.dataset.autoClose === 'true',
buttons: element.dataset.clearButton === 'true' ? ['clear', todayButton] : [todayButton],
locale: await getLocale(element.dataset.language),
onSelect: ({ date, formattedDate, datepicker }) => {
const _event = new CustomEvent("change", {
bubbles: true,
});
datepicker.$el.dispatchEvent(_event);
}
};
// Store popper instance for updating on view changes
let popperInstance = null;
const positionConfig = !isOnMobile ? {
position({ $datepicker, $target, $pointer, done }) {
popperInstance = createPopper($target, $datepicker, {
placement: 'bottom',
modifiers: [
{
name: 'flip',
options: {
padding: {
top: 64
}
}
},
{
name: 'offset',
options: {
offset: [0, 20]
}
},
{
name: 'arrow',
options: {
element: $pointer
}
}
]
});
return function completeHide() {
popperInstance.destroy();
popperInstance = null;
done();
};
},
onChangeView() {
// Update popper position when view changes (e.g., clicking year)
// Use setTimeout to allow the DOM to update before recalculating
if (popperInstance) {
setTimeout(() => popperInstance.update(), 0);
}
}
} : {};
let opts = { ...baseOpts, ...positionConfig };
if (element.dataset.value) {
opts["selectedDates"] = [element.dataset.value];
opts["startDate"] = [element.dataset.value];
}
return createAirDatepicker(element, opts);
};
window.MonthYearPicker = async function createDynamicDatePicker(element) {
let todayButton = {
content: element.dataset.nowButtonTxt,
onClick: (dp) => {
let date = new Date();
dp.selectDate(date, { updateTime: true });
dp.setViewDate(date);
}
};
let isOnMobile = isMobile();
let baseOpts = {
isMobile: isOnMobile,
view: 'months',
minView: 'months',
dateFormat: 'MMMM yyyy',
toggleSelected: element.dataset.toggleSelected === 'true',
autoClose: element.dataset.autoClose === 'true',
buttons: element.dataset.clearButton === 'true' ? ['clear', todayButton] : [todayButton],
locale: await getLocale(element.dataset.language),
onSelect: ({ date, formattedDate, datepicker }) => {
const _event = new CustomEvent("change", {
bubbles: true,
});
datepicker.$el.dispatchEvent(_event);
}
};
// Store popper instance for updating on view changes
let popperInstance = null;
const positionConfig = !isOnMobile ? {
position({ $datepicker, $target, $pointer, done }) {
popperInstance = createPopper($target, $datepicker, {
placement: 'bottom',
modifiers: [
{
name: 'flip',
options: {
padding: {
top: 64
}
}
},
{
name: 'offset',
options: {
offset: [0, 20]
}
},
{
name: 'arrow',
options: {
element: $pointer
}
}
]
});
return function completeHide() {
popperInstance.destroy();
popperInstance = null;
done();
};
},
onChangeView() {
// Update popper position when view changes (e.g., clicking year)
if (popperInstance) {
setTimeout(() => popperInstance.update(), 0);
}
}
} : {};
let opts = { ...baseOpts, ...positionConfig };
if (element.dataset.value) {
opts["selectedDates"] = [new Date(element.dataset.value + "T00:00:00")];
opts["startDate"] = [new Date(element.dataset.value + "T00:00:00")];
}
return createAirDatepicker(element, opts);
};
window.YearPicker = async function createDynamicDatePicker(element) {
let todayButton = {
content: element.dataset.nowButtonTxt,
onClick: (dp) => {
let date = new Date();
dp.selectDate(date, { updateTime: true });
dp.setViewDate(date);
}
};
let isOnMobile = isMobile();
let baseOpts = {
isMobile: isOnMobile,
view: 'years',
minView: 'years',
dateFormat: 'yyyy',
toggleSelected: element.dataset.toggleSelected === 'true',
autoClose: element.dataset.autoClose === 'true',
buttons: element.dataset.clearButton === 'true' ? ['clear', todayButton] : [todayButton],
locale: await getLocale(element.dataset.language),
onSelect: ({ date, formattedDate, datepicker }) => {
const _event = new CustomEvent("change", {
bubbles: true,
});
datepicker.$el.dispatchEvent(_event);
}
};
// Store popper instance for updating on view changes
let popperInstance = null;
const positionConfig = !isOnMobile ? {
position({ $datepicker, $target, $pointer, done }) {
popperInstance = createPopper($target, $datepicker, {
placement: 'bottom',
modifiers: [
{
name: 'flip',
options: {
padding: {
top: 64
}
}
},
{
name: 'offset',
options: {
offset: [0, 20]
}
},
{
name: 'arrow',
options: {
element: $pointer
}
}
]
});
return function completeHide() {
popperInstance.destroy();
popperInstance = null;
done();
};
},
onChangeView() {
// Update popper position when view changes (e.g., clicking year)
if (popperInstance) {
setTimeout(() => popperInstance.update(), 0);
}
}
} : {};
let opts = { ...baseOpts, ...positionConfig };
if (element.dataset.value) {
opts["selectedDates"] = [new Date(element.dataset.value + "T00:00:00")];
opts["startDate"] = [new Date(element.dataset.value + "T00:00:00")];
}
return createAirDatepicker(element, opts);
};