> 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/1-wprowadzanie-danych-inputs/komponent-pin-pinfield.md).

# Komponent PIN - PinField

{% hint style="info" %}
**Wymagania licencyjne:**

* **Dostęp do komponentu PIN:** wymaga posiadania dedykowanej licencji na komponent (brak w instalacji standardowej).
* **Właściwość „Liczba komórek” (4–8):** wymaga **dodatkowej licencji rozszerzającej**. W ramach samej licencji bazowej liczba komórek jest stała i zdefiniowana odgórnie dla danego wdrożenia (np. 4 lub 6 cyfr).
  {% endhint %}

Komponent służący do wpisywania kodu PIN o określonej długości. Wartość komponentu jest wysyłana po uzupełnieniu całego PIN-u; wtedy również następuje walidacja.

Sposób ustalania długości PIN-u zależy od wdrożonego pakietu licencyjnego:

* **Wersja bazowa komponentu:** liczba cyfr jest stała i zdefiniowana w konfiguracji wdrożenia (zazwyczaj 4 lub 6) – twórca formularza nie ma możliwości jej edycji.
* **Wersja z dodatkową licencją:** liczbę cyfr można swobodnie konfigurować we właściwości **Liczba komórek** (w zakresie od 4 do 8).

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-7632cb46436a46105ac73266ceeadd84812cbff7%2FpinInput1.png?alt=media" alt=""><figcaption></figcaption></figure>

✅ **Kiedy stosować:**

* Gdy wymagane jest wprowadzenie danych o ściśle określonej liczbie znaków (np. 4-cyfrowy kod PIN logowania lub 6-cyfrowy kod SMS do autoryzacji).
* Gdy ze względów bezpieczeństwa chcesz wprowadzić maskowanie wprowadzanych znaków (komponent pozwala na maskowanie cyfr kropkami).

:x: Kiedy nie stosować:

Gdy długość wprowadzanego ciągu znaków jest zmienna (np. hasło do konta o długości od 8 do 20 znaków). **Stosuj**: [TextField](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/1-wprowadzanie-danych-inputs/pole-tekstowe-textfield.md).

## Właściwości komponentu

| Właściwość                                                                                                            | Opis                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Etykieta ARIA** (sekcja **WCAG**)                                                                                   | Właściwość odpowiadająca oddzielonym przecinkami atrybutom `aria-label` poszczególnych inputów składających się na komponent PIN. Domyślnie "1,2,3,4,5,6". Aby dać użytkownikowi korzystającemu z czytnika ekranowego świadomość bycia w kontrolce PIN, może być potrzebne zmodyfikowanie tej wartości, np. na "kontrolka pin 1,kontrolka pin 2,...". |
| **Maskowanie znaków w polu** (sekcja **Bezpieczeństwo**)                                                              | Zaznaczenie opcji "Maskowanie znaków w polu" we właściwościach komponentu (sekcja Bezpieczeństwo) powoduje zastąpienie wpisywanych znaków kropkami w widoku pola.                                                                                                                                                                                     |
| <p><strong>Liczba komórek</strong> (sekcja <strong>Jakość danych</strong>)<br><em>Wymaga dodatkowej licencji</em></p> | Liczba komórek kodu, od 4 do 8. Domyślnie 4. Szczegóły: [Liczba komórek](#liczba-komorek). Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.                                                                                                                                                           |

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

## Liczba komórek

{% hint style="info" %}
Poniższa konfiguracja dotyczy wyłącznie środowisk z aktywną **dodatkową licencją na parametryzację liczby komórek**. Jeśli Twoje wdrożenie obejmuje jedynie bazowy komponent PIN, liczba pól jest narzucona odgórnie (4 lub 6 cyfr) i nie podlega edycji na poziomie formularza.
{% endhint %}

Komponent ma tyle komórek, ile ustawisz we właściwości **Liczba komórek**, i przekazuje wartość dopiero po wypełnieniu wszystkich. Wymagany komponent zgłasza błąd, dopóki kod nie ma dokładnie tylu cyfr. Wyczyszczone pole wraca do wartości 4.

Aby komponent przyjmował 6-cyfrowy kod:

1. Zaznacz komponent PIN na stronie formularza.
2. We właściwościach komponentu rozwiń sekcję **Jakość danych**.
3. W polu **Liczba komórek** wprowadź `6`.

Podgląd strony od razu pokazuje 6 komórek.

Gdy komórki nie mieszczą się w jednym wierszu dostępnej szerokości, komponent układa je w dwóch wierszach: w pierwszym jest połowa komórek zaokrąglona w górę, a w drugim pozostałe, wyśrodkowane pod pierwszym. Na przykład 7 komórek na wąskim ekranie telefonu układa się w 4 + 3.

Czytnik ekranu na pierwszej komórce odczytuje liczbę znaków kodu.

## Wygląd komponentu

<figure><img src="https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/2ekT7kiL20Ev1ZlYe0Ja/17k_files/image2024-10-8_16-17-45.png" alt=""><figcaption><p><em><strong>Ilustracja 1.</strong> Wygląd komponentu na formularzu.</em></p></figcaption></figure>

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FgFcAtgJqsTVVeDdrEn0p%2Fobraz.png?alt=media&amp;token=7c5803cd-1db2-4d77-8012-7235ca080946" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Wygląd komponentu dla 4-cyfrowego kodu.</em></p></figcaption></figure>

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-c3fa080053257ec43ae064551fdfd2c60cbbf4a7%2FpinInput2.png?alt=media" alt=""><figcaption><p><em><strong>Ilustracja 3.</strong> Wygląd komponentu z maskowaniem znaków.</em></p></figcaption></figure>

{% hint style="info" %}
Wniosek demo: demoPin
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/1-wprowadzanie-danych-inputs/komponent-pin-pinfield.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
