For the complete documentation index, see llms.txt. This page is also available as Markdown.

Komponent PIN - PinField

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

Komponent służący do wpisywania kodu PIN. Obecnie wspiera 4- lub 6-cyfrowe kody. Liczba cyfr w komponencie jest zależna od wdrożenia. Wartość komponentu jest wysyłana po uzupełnieniu całego PIN-u; wtedy również następuje walidacja.

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

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.

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.

Więcej informacji o właściwościach komponentu: Wspólne właściwości komponentów

Wygląd komponentu

Ilustracja 1. Wygląd komponentu na formularzu.
Ilustracja 2. Wygląd komponentu dla 4-cyfrowego kodu.
Ilustracja 3. Wygląd komponentu z maskowaniem znaków.

Wniosek demo: demoPin

Ostatnia aktualizacja

Czy to było pomocne?