> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile/grupa-kafli-tilegroup.md).

# Grupa kafli - TileGroup

{% hint style="info" %}
Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
{% endhint %}

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

![](/files/48e07d85e986bfc7f9bebd1932830680531b2f1b)

## Właściwości komponentu

| Właściwość Eximee Designer                                               | Nazwa atrybutu w Źródle | Opis                                                                                                                                                                |
| ------------------------------------------------------------------------ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Etykieta<br>(sekcja <strong>Podstawowe właściwości</strong>)</p>      | label                   | Etykieta dla komponentu.                                                                                                                                            |
| <p><strong>Liczba kolumn</strong><br>(sekcja <strong>Układ</strong>)</p> | 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](/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow.md)

## Wartość komponentu

Jako wartość komponentu ustalana jest wartość zaznaczonego przez użytkownika pola **Kafel** ([Kafel - Tile](/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile.md)). 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](/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile.md)). 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.

<figure><img src="/files/owYf23Cwg2tVK163LGW4" alt=""><figcaption><p><em><strong>Ilustracja 1.</strong> Przykładowy wygląd komponentu na wniosku</em></p></figcaption></figure>

<figure><img src="/files/bpzq3r6arJNaWu2WA2KQ" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Przykładowy wygląd komponentu z kaflami zawierającymi etykietę i pomoc kontekstową</em></p></figcaption></figure>

## 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.

```js
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.

<figure><img src="/files/eDqCLiw5tVJNzTub6oWb" alt=""><figcaption><p><em><strong>Ilustracja 3.</strong> Przykład Grupy kafli zasilonej skryptem</em></p></figcaption></figure>

{% hint style="info" %}
Wnioski demo: demoTileGroup
{% endhint %}

{% hint style="info" %}
♿WCAG: [Dobre praktyki WCAG dla low-code dev](https://github.com/Consdata/eximee-docs/tree/main/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/proces-biznesowy/tworzenie-procesu-biznesowego-w-bpmn-2.0/dobre-praktyki.md)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile/grupa-kafli-tilegroup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.