Grupa kafli - TileGroup

Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.

Grupa jednokrotnego wyboru, której reprezentacją graficzną opcji jest kafel

Właściwości komponentu

Właściwość Eximee Designer	Nazwa atrybutu w Źródle	Opis
Etykieta (sekcja Podstawowe właściwości)	label	Etykieta dla komponentu.
Liczba kolumn (sekcja Układ)	columns	Liczba kolumn w komponencie - wartość brana pod uwagę tylko w przypadku zasilania dziedziny komponentu przez Źródło danych zewnętrznych (External Data Source).
Opis pola (sekcja Podstawowe właściwości)	description	Dodatkowy opis dla grupy kafli (wyświetlany pod kaflami)

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

Wartość komponentu

Jako wartość komponentu ustalana jest wartość zaznaczonego przez użytkownika pola Kafel (Kafel - Tile). Brak zaznaczenia oznacza, że właściwość value komponentu jest pustym tekstem.

Komponenty wewnętrzne

Wewnątrz komponentu Grupa kafli można osadzać jeden rodzaj komponentu — Kafel (opis komponentu w Kafel - Tile). Sposób układania komponentów wewnątrz Grupy kafli można określić za pomocą pola Liczba kolumn dostępnego w sekcji Układ.

Parametry wejściowe komponentu

Parametr	Opis
id	Wartość jaką przyjmuje wybrany kafelek (pole obowiązkowe). Pusta wartość zwrócona z usługi będzie powodować błąd systemu.
content	Zawartość kafelka zapisana w języku HTML (skrypty wewnątrz tego HTMLa nie są obsługiwane przez platformę).
title	Tytuł kafelka.
value	Wartość jaką przyjmie grupa po zasileniu dziedziny (pole opcjonalne). W przypadku zwrócenia wartości spoza dziedziny zostanie ustawiona wartość domyślna (jeżeli znajduje się w nowej dziedzinie) lub pusta.

Czyszczenie wyboru

W celu wyczyszczenia aktualnego wyboru, należy ustawić komponentowi pustą wartość (value), przy czym pusta wartość oznacza pusty tekst: "". Należy również zaznaczyć, że resetowanie wyboru nie oznacza przywrócenia wartości domyślnej, a odznaczenie aktualnie wybranego Kafla.

Ilustracja 1. Przykładowy wygląd komponentu na wniosku

Ilustracja 2. Przykładowy wygląd komponentu z kaflami zawierającymi etykietę i pomoc kontekstową

Przykład zasilenia Grupy kafli ze skryptu

Aby dynamicznie wygenerować opcje do wyboru (kafle), komponent Grupa kafli może zostać zasilony skryptem za pomocą Źródła danych zewnętrznych.

Poniższy przykład zwraca tablicę trzech kafli z wyborem metody kontaktu z bankiem.

function callService(context) {
  const videoContent = "Wideorozmowa";
  const phoneContent = "Telefon";
  const branchContent = "Spotkanie w oddziale";

  return [
    { id: "wideorozmowa", content: videoContent, columns: 2 },
    { id: "telefon", content: phoneContent, columns: 2 },
    { id: "spotkanie", content: branchContent, columns: 2 },
  ];
}

Po wskazaniu powyższego skryptu jako źródła danych dla komponentu, należy przejść do konfiguracji mapowania w zakładce Parametry wyjściowe. Następnie przypisać pola zwracane przez skrypt do wewnętrznych parametrów Grupy kafli:

• id - mapowanie na id ze skryptu; jest to unikalny identyfikator wybranej opcji (wartość, która zostanie zapisana na wniosku po kliknięciu kafla),
• content - mapowanie na content ze skryptu; wartość ta pozwala na wstrzyknięcie kodu HTML, który sformatuje opis na kaflu,
• columns - mapowanie na columns ze skryptu; określa liczbę kolumn w komponencie.

Ilustracja 3. Przykład Grupy kafli zasilonej skryptem

Wnioski demo: demoTileGroup

♿WCAG: Dobre praktyki WCAG dla low-code dev