# Checkbox Pole wyboru ![](/files/a616522f6291982c99d29707ce932c6c98ed5ab3) ✅ **Kiedy stosować:** * Istnieje możliwość zaznaczenia więcej niż jednej opcji. :x: **Kiedy nie stosować:** * Wybór ma być tylko jeden z kilku wariantów. **Stosuj**: [Radio](/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/radio.md). ## Właściwości komponentu | Właściwość Eximee Designer | Nazwa atrybutu w Źródle | Opis | | --------------------------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Zaznaczenie przycisku** (sekcja **Pozostałe**) | checked | Określa, czy pole domyślnie ma być zaznaczone (początkowo ustawiona na "false"). Odpowiednik wartości domyślnej dla innych pól. | | **Wartość zaznaczonego przycisku** (sekcja **Pozostałe**) | valueYes | Wartość, jaką przyjmuje checkbox kiedy jest zaznaczony - domyślnie, jeśli nie zostanie ustawiona inna wartość zwracana jest wartość "true". | | **Wartość odznaczonego przycisku** (sekcja **Pozostałe**) | valueNo | Wartość, jaką przyjmuje checkbox kiedy jest odznaczony - domyślnie, jeśli nie zostanie ustawiona inna wartość zwracana jest wartość "false". | | **Ustawienie pola wyboru** (sekcja **Pozostałe**) | tickPosition |

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

Domyślnie pusta (ustawiona na DEFAULT), umieszcza pole wyboru na środku komponentu w orientacji pionowej. Ustawiona na TOP umieszcza pole wyboru na górze komponentu w orientacji pionowej.

| | **Treść** (sekcja **Podstawowe właściwości**) | text | Tekst wyświetlany przy komponencie. Jest możliwe odwołanie się do zmiennych lub pól np.: ${sessionVariable1} lub ${GesTextField1} | | **Opis** (sekcja **Pozostałe**) | description |

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

Określa opis biznesowy pola - sposób wyświetlenia zależy od konkretnej implementacji komponentu.

| > 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) ## Zasilenie tekstu checkboxa różnymi treściami Jeśli tekst obok checkboxa należy uzależnić od warunku i wyświetlać różny (lub sformatowany), można zasilić go treścią z komponentu Treść (TextContent). Należy w tym celu podpiąć na checkboxie w polu **Źródło danych zewnętrznych** usługę *TextContentService*, w której jako komponent parametru wejścia podajemy artefakt zawierający tekst do wyświetlenia. W parametrach wyjściowych dla atrybutu **text** i **value** wybieramy parametr wyjścia **artifact**. Przycisk kierujący do szczegółowych informacji można umieścić wewnątrz Treści (TextContentu) umieszczając w niej znacznik `_\
\
._ ` Treść definiowana w **moreInfoLabel** może być definiowana dynamicznie (na przykład zasilana z Pola tekstowego lub innego komponentu umieszczonego na wniosku). ## Informacje o stanie komponentu Informacje o aktualnej wartości danej właściwości komponentu, którą można następnie wykorzystać na wniosku np. do zasilenia innego pola wartością tej właściwości, można uzyskać stosując konstrukcję ID\_COMPONENTU$NAZWA\_WŁAŚCIWOŚCI Dla checkboxa można pobrać następujące właściwości: | Klucz | Opis | | ------------------------- | ------------------------------------------------------------------------------- | | **moreInfoButtonClicked** | true - jeśli chociaż raz kliknięto w link kierujący do szczegółowych informacji | {% hint style="info" %} Przykład: zasilenie właściwości **Źródło danych z innego pola** (valueSourceId) poprzez GesCheckbox1$moreInfoButtonClicked zwraca nam wartość true/false z informacją, czy checkbox został zaznaczony. {% endhint %} ### Dostępne zdarzenia | Nazwa | Opis | | ----------- | ------------------------------------------------- | | **CHECK** | Zdarzenie emitowane podczas zaznaczenia checkboxa | | **UNCHECK** | Zdarzenie emitowane podczas odznaczenia checkboxa | ### Dostępne akcje Dokumentacja akcji: [Akcje](/budowanie-aplikacji/logika-biznesowa/przeplywy/akcje.md) | Nazwa | Opis | | ----------- | -------------------------------------------------------------------------------------- | | **CHECK** | Zaznaczenie checkboxa. **UWAGA**: nie emituje zdarzenia CHECK | | **UNCHECK** | Odznaczenie checkboxa. **UWAGA**: nie emituje zdarzenia UNCHECK | | **TOGGLE** | Zmiana wartości checkboxa na przeciwną. **UWAGA**: nie emituje zdarzeń CHECK i UNCHECK |

Ilustracja 1. Przykład pozycji checkboxa ustawionej na TOP i domyślnie (DEFAULT)

Ilustracja 2. Przykładowy wyglądu komponentu na wniosku.

Ilustracja 3. Przykładowy wygląd komponentu na wniosku w prezentacji switch.

{% hint style="info" %} Wnioski demo: demoCheckbox, demoPopup {% endhint %} {% hint style="info" %} ♿WCAG: [Dobre praktyki WCAG dla low-code dev](/budowanie-aplikacji/proces-biznesowy/tworzenie-procesu-biznesowego-w-bpmn-2.0/dobre-praktyki.md) {% endhint %} --- # 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/2-pola-wyboru/checkbox.md?ask= ``` 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.