Data - DatePicker

Komponent wyboru daty

Właściwości komponentu

Właściwość Eximee Designer	Nazwa atrybutu w Źródle	Opis
Prezentacja maski (sekcja Stylizacja)	autoMask	Wyświetlenie maski w polu daty (domyślna wartość "true").
Format daty (sekcja Podstawowe właściwości)	dateFormat	Format daty. Domyślnie ustawiony na dd-MM-yyyy.Wartości, z których można ułożyć format daty: yy - ostatnie dwie cyfry roku yyyy - rok MMMM - pełna nazwa miesiąca MMM - trzyliterowa, skrócona nazwa miesiąca (sty, lut, mar itd.) MM - dwucyfrowa liczba miesiąca (miesiące od 1 do 9 poprzedza zero) M - liczba miesiąca d - liczba dnia miesiąca dd - dwucyfrowa liczba dnia miesiąca (dni od 1 do 9 poprzedza zero) EEEE - pełna nazwa dnia tygodnia EEE lub EE - skrócona nazwa dnia tygodnia (pn, wt itd.) seperatory np. spacja, kropka, myślnik itd. Domyślny format daty dla komponentu jest zgodny z ustawieniami regionalnymi. Uwaga! zmiana formatu daty wpływa na sposób wyświetlania jej w Wartości domyślnej (defaultValue). Każda zmiana formatu wymaga poprawienia domyślnej daty.
Zakres dat (sekcja Jakość danych)	dateRange	Zawężanie przedziału dat możliwych do wyboru. Dostępne opcje: ALL (wszystkie daty) PAST (daty z przeszłości wraz z dzisiejszą) PAST_WITHOUT_TODAY (daty z przeszłości bez dzisiejszej) FUTURE (daty z przyszłości wraz z dzisiejszą) FUTURE_WITHOUT_TODAY (daty z przyszłości bez dzisiejszej)
Komunikat zmiany daty (sekcja Pozostałe)	dateRangeValidationText	Tekst pokazywany po zmianie daty w momencie, gdy wprowadzona została nieprawidłowa wartość. Domyślną wartością jest "Data została zmieniona."
Data ustawiona na dzisiaj (sekcja Pozostałe)	defaultValueOnToday	Wyświetlenie w polu jako domyślnej wartości daty systemowej (domyślna wartość "false").
Lista rozwijana dla wyboru miesiąca/roku (sekcja Pozostałe)	useDropDownSelector	Włączona lista rozwijana dla wyboru miesiąca/roku (domyślna wartość "false").
Ze wskazaniem czasu (sekcja Pozostałe)	withTime	Ustawione na "true" oznacza, że po dacie pojawi się czas w formacie: 00:00
Niedostępne daty	disabledDates	Lista dni (jako timestampy) oddzielonych przecinkiem, których wybór ma zostać zablokowany.

Więcej informacji o właściwościach komponentu: Wspólne właściwości komponentów

Źródło danych zewnętrznych

Kontrolkę możemy zasilić używając skryptu, do tego możemy użyć źródła danych zewnętrznych. Źródło danych zewnętrznych możemy skonfigurować w sekcji Interakcje, a parametry jakie możemy ustawić to:

• serwis - serwis, który dostarczy dane do wyświetlenia kontrolki

• parametry wejściowe - lista parametrów serwisu, które możemy zasilić zmiennymi lub wartościami z wniosku

• parametry wyjściowe - lista parametrów wyjściowych serwisu, które możemy mapować na atrybuty komponentu, lista dostępnych atrybutów to:

  • value - wartość początkowa kontrolki przedstawiona przez znacznik czasowy. Przykład: 1739577600000

  • disabledDates - lista dni, których użytkownik nie będzie mógł wybrać. Wartością jest lista znaczników czasowych oddzielonych przecinkiem. Przykład: 1739145600000,1739577600000

  • dateRange - zakres możliwych dat do wyboru. Zakres zapisujemy w formie dwóch znaczników czasowych oddzielonych przecinkiem. Przykład: 1738800000000,1740009600000

  • disabledInputTyping - czy będzie możliwe wpisanie daty? Możliwe wartości: true, false.

Przykładowe ustawienia komponentu

Ustawiony Format daty (dateFormat) decyduje jaki wygląd komponentu daty zostanie zaprezentowany na wniosku, przykładowo:

Ustawienie w Eximee Designer	Wygląd na wniosku

Ilustracja 1. Inne konfiguracje przykładowego wyglądu komponentu na wniosku

Ilustracja 2. i 3. Przykładowy wygląd popupów z kalendarzami

Wniosek demo: demoDatePicker

Dodatkowe właściwości komponentu

Właściwość Eximee Designer	Nazwa atrybutu w Źródle	Opis
Prezentacja roku w nagłówku kalendarza (sekcja Pozostałe)	showYearInHeadline	W kalendarzu obok miesiąca wyświetlany jest rok (domyślna wartość "true").
Wybór tylko z kalendarza (sekcja Pozostałe)	disabledInputTyping	Ustawione na "true" oznacza, że możliwy będzie wybór daty wyłącznie z popupa. Nie będzie można wpisać daty ręcznie do pola. Wyłącznie dla kanału DESKTOP.
Placeholder (sekcja Jakość danych)	placeholderText	Tekst wyświetlany jako Placeholder pola, domyślnie jest to wartość pusta.
Widok startowy (sekcja Pozostałe)	startViewMode	Wybór "ekranu", który pojawi się jako pierwszy po kliknięciu w kalendarz. Możliwe wartości DEFAULT - zachowanie jak do tej pory, MULTI_YEAR - wyświetlenie jako pierwszego ekranu z wyborem roku.
Format daty dla pola bez focusa (sekcja Podstawowe właściwości)	unfocusedFormat	Niestandardowy format daty dla pola, na którym nie ma focusa. Dopuszczalne formaty są takie same jak w polu z Formatem daty. Jeśli pole jest niewypełnione, to Format daty dla pola bez focusa jest taki sam jak na polu z Formatem daty. Jeśli pole jest wypełnione innym formatem niż Format daty, wówczas ta wartość będzie widoczna po wyjściu z pola, a Format daty po kliknięciu w pole.

♿WCAG: Dobre praktyki WCAG dla low-code dev