# 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

![](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/j1m4NGDLpv7zrm5B8WVw/5s_files/image2025-5-16_13-50-40.png)

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

> Więcej informacji o właściwościach komponentu: [Wspólne właściwości komponentów](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow)

## Wartość komponentu

Jako wartość komponentu ustalana jest wartość zaznaczonego przez użytkownika pola **Kafel** ([Kafel - Tile](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/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](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/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ę).                                                                                                                                                                             |
| **additionalContent** | Dodatkowa zawartość kafelka zapisana w języku HTML (skrypty wewnątrz tego HTMLa nie są obsługiwane przez platformę). Funkcjonalnie zachowywać się może różnie w zależności od wybranego wdrożenia, przykładowo treść, która ma być dodatkowo wyświetlona, gdy dany kafel jest wybrany. |
| **title**             | Tytuł kafelka.                                                                                                                                                                                                                                                                         |
| **columns**           | Liczba kolumn, na której mają ułożyć się kafelki (pole opcjonalne). Wartość zwrócona z usługi nadpisuje wartość ustawioną w parametrze Liczba kolumn.                                                                                                                                  |
| **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.                                                                           |
| **popupTriggerLabel** | Tekst etykiety, której kliknięcie spowoduje pokazanie popupa (Funkcjonalność opcjonalna. Nie jest dostępna we wszystkich wdrożeniach.)                                                                                                                                                 |
| **popupTextContent**  | Nazwa i wersja tekst contentu (w formacie nazwa-wersja), który zostanie pokazany w popupie (Funkcjonalność opcjonalna. Nie jest dostępna we wszystkich wdrożeniami.)                                                                                                                   |

## 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="https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/AOfS0MRMgyVUW3cT0CyC/5s_files/Zaznaczenie_333.png" alt=""><figcaption><p><em><strong>Ilustracja 1.</strong> Przykładowy wygląd komponentu na wniosku.</em></p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/sprf82XuoASPR7FK0OPP/5s_files/Zaznaczenie_332.png" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Przykładowy wygląd komponentu z kaflami zawierającymi tytuł.</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/blob/main/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/proces-biznesowy/tworzenie-procesu-biznesowego-w-bpmn-2.0/dobre-praktyki.md)
{% endhint %}