# Wiele master checkboxów w komponencie oświadczeń

## Pojedynczy master checkbox

Domyślnie komponent oświadczeń wyświetla się z jednym master checkboxem. Niezależnie od liczby kontrolek taki checkbox zaznacza je wszystkie.

<div align="center"><img src="https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/7iY6LDu5sFqkqCABSevk/10s_files/image2025-9-1_14-19-38.png" alt="Ilustracja 1. Przykładowy wygląd oświadczeń z jednym master checkboxem dla jednej kontrolki 
(w zależności od wdrożenia wygląd może się różnić)" width="563"></div>

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FtMrMUBWkblOTYYAmE61y%2FPrzechwycenie%20obrazu%20ekranu_2017-07-20_10-42-30.png?alt=media&#x26;token=6f81c80b-188e-49d3-a632-200b031f2603" alt="" width="494"><figcaption><p align="center"><em><strong>Ilustracja 2.</strong> Przykładowy wygląd komponentu z jednym master checkboxem dla dwóch kontrolek</em><br><em>(w zależności od wdrożenia wygląd może się różnić)</em></p></figcaption></figure>

## Wiele master checkboxów

Aby wyświetlić dwa lub więcej master checkboxów, należy najpierw zdefiniować je klikając **Dodaj masterCheckbox** w polu **LISTA MASTERCHECKBOXÓW** (masterCheckboxes).

![Ilustracja 3. Okno Lista masterCheckboxów ze zdefiniowaną listą dwóch głównych checkboxów](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/VMZwY9sFjbnwfynsd1dE/10s_files/image2024-8-5_14-18-36.png)

{% stepper %}
{% step %}

#### Zdefiniuj master checkboxy

Dla każdego master checkboxa należy zdefiniować:

* mastercheckboxId — Id, które będzie identyfikowało master checkbox dla kontrolek
* labelKey — Klucz tekstu, który będzie się wyświetlał dla master checkboxa o ustalonym id
* visibleCondition — Warunek widoczności master checkboxa. Wartość domyślna: "true".
  {% endstep %}

{% step %}

#### Powiąż master checkbox z kontrolką

Aby powiązać master checkbox z kontrolką, wpisz id master checkboxa w definicji kontrolki. Należy dodać odpowiednie wpisy w JSONie komponentu (więcej na temat tworzenia oświadczeń w [Edytor oświadczeń](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/7-komponenty-specjalne/oswiadczenia-statements/edytor-oswiadczen)).

Przykład (fragment JSON) pokazujący dodanie master checkboxów "mCh1" i "mCh2" dla oświadczeń:

{% code title="fragment.json" %}

```json
"items": [
    {
        "controls": [
            {
                "mid": "kontolka1",
                "titleKey": "kontrolka1",
                "requiredCondition": "js:false",
                "mastercheckbox": "mCh1",
                "type": "CHECKBOX"
            },
            {
                "mid": "kontolka2",
                "titleKey": "kontrolka2",
                "requiredCondition": "js:false",
                "notSelectedErrorTextKey": "",
                "mastercheckbox": "mCh2",
                "type": "CHECKBOX"
            }
        ]
    }
]
```

{% endcode %}
{% endstep %}
{% endstepper %}

![Ilustracja 4. Przykładowe oświadczenia z trzema master checkboxami&#x20;
(w zależności od wdrożenia wygląd może się różnić).](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/zjkADLJhhGfWloAqBGG8/10s_files/image2018-10-11_9-29-41.png)

Gdy będzie widoczny tylko jeden master checkbox, oświadczenia będą wyglądały jak poniżej. Klucz master checkboxa nie będzie wyświetlany, zamiast tego pojawi się domyślny opis. W tym wypadku zachowanie master checkboxa się nie zmienia i nadal zaznacza on tylko te kontrolki, które posiadają parametr **mastercheckbox** wskazujący na jego id — innymi słowy, ten master checkbox nie zaznacza wszystkich kontrolek.

![Ilustracja 5. Przykładowe oświadczenia z widocznym jednym master checkboxem&#x20;
(w zależności od wdrożenia wygląd może się różnić).](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/PUNFzSBQPdKVcQGRhEpy/10s_files/image2018-10-11_10-15-45.png)


---

# Agent Instructions: 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:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/7-komponenty-specjalne/oswiadczenia-statements/wiele-master-checkboxow-w-komponencie-oswiadczen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.