Potwierdzenie danych - ConfirmationSection

Sekcja potwierdzania danych służy do definiowania podsumowania z wartościami wybranych pól wniosku przed jego wysłaniem. Dodatkowo umożliwia aktualizację wskazanych pól wniosku, z którymi powiązane są komponenty umieszczone w sekcji.

Opis działania

• Aby powiązać pole umieszczone w sekcji z konkretnym polem wniosku, należy wskazać to pole wniosku jako Źródło danych z innego pola (valueSourceId) komponentu w sekcji.

• Po zatwierdzeniu wpisanych w sekcji danych, zostaną one przepisane do pola wskazanego jako valueSourceId.

• Jeśli dodatkowo chcemy, by zmiana wartości pola na wniosku pociągała za sobą aktualizację powiązanego pola w sekcji, należy dla komponentu w sekcji zdefiniować zależność na pole wniosku.

Komponent potwierdzenia danych działa w dwóch trybach: edycji oraz podglądu.

1

Tryb podglądu

W trybie podglądu sekcja prezentuje pole Etykieta, Treść oraz link służący do przejścia w tryb edycji. Po kliknięciu linku, komponent przechodzi w tryb edycji.

2

Tryb edycji

W trybie edycji sekcja prezentuje wszystkie umieszczone na niej komponenty, zgodnie z layoutem sekcji oraz dodatkowo po prawej stronie umieszcza link służący do zatwierdzenia wprowadzonych zmian.

Pola w sekcji podlegają walidacji analogicznie do wszystkich innych pól wniosku. Po zatwierdzeniu zmian i pomyślnej walidacji, dane są przesyłane do komponentu na wniosku powiązanego przez Źródło danych z innego pola.

Zatwierdzenie danych nie jest możliwe w przypadku jakichkolwiek błędów walidacji pól w sekcji. Po pozytywnym zatwierdzeniu zmian sekcja wraca w tryb podglądu.

Po ponownym otwarciu strony zawierającej sekcję, komponent wraca do stanu początkowego (czyli przyjmuje wartości z powiązanych pól wniosku).

W przypadku odrzucania zmian opcją Anuluj decydująca jest konfiguracja sekcji w Eximee Designerze - zaznaczona opcja Zachowanie wartości po anulowaniu (preserveValuesOnCancel) zachowa poprzednie wartości wpisane w komponentach sekcji, odznaczona wyczyści je.

Zależności komponentów

Zmiana wartości komponentu, od którego zależy sekcja, powoduje przeliczenie jej stanu oraz stanu wszystkich zawartych w niej komponentów.

Dla zmiany dowolnego komponentu w sekcji przeliczane są wartości wszystkich komponentów od niej zależnych.

Układanie komponentów (layout)

W sekcji można zdefiniować layout analogicznie do layoutu dla strony wniosku.

Błędy walidacji

Błędy walidacji na ConfirmationSection nie powodują ukrycia przycisku Wyślij wniosek.

Ilustracja 1. Wygląd komponentu na wniosku

Właściwości komponentu

Właściwość Eximee Designer	Nazwa atrybutu w Źródle	Opis
Opis ARIA dla przycisku Edytuj (sekcja WCAG)	editLinkAriaDescriptionKey	Opis aria (aria-description) dla przycisku Edytuj
Opis ARIA dla przycisku Zatwierdź (sekcja WCAG)	submitLinkAriaDescriptionKey	Opis aria (aria-description) dla przycisku Zatwierdź

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

Wniosek demo: demoConfirmationSection

♿WCAG: Dobre praktyki WCAG dla low-code dev