RadioGroup

shadow

RadioGroup slúži ako kontajner pre skupinu radio tlačidiel. Umožňuje používateľom vybrať jednu možnosť zo súboru možností, pričom sa zabezpečí, že v danom okamihu bude vybrané iba jedno rádiové tlačidlo v rámci skupiny. Komponent podporuje atribút inline, ktorý po nastavení usporiada rádiové tlačidlá v horizontálnom rozložení. Okrem toho programovo spravuje atribút value, ktorý reflektuje hodnotu práve vybraného rádiového tlačidla.

Kedy použiť

Použite wje-radio-group, keď používateľ zadáva hodnotu, vyberá možnosti alebo vykonáva akciu vo formulári.

Kedy nepoužiť

Nepoužívajte ho len ako vizuálny dekoratívny prvok bez interakcie. V takom prípade uprednostnite prezentačné komponenty.

Prístupnosť

Vždy prepojte komponent s popisom (label/aria-label), zachovajte ovládanie klávesnicou a pri validačných chybách zobrazte zrozumiteľnú správu.

Odporúčané postupy

• Majte jednotné validačné pravidlá a error stavy naprieč celým formulárom.
• Pri asynchrónnych operáciách zobrazte stav načítania alebo disabled stav.
• Pri zložitých formulároch preferujte menšie sekcie a okamžitú spätnú väzbu.

Atribúty a vlastnosti

disabled

Popis	Vypína používateľskú interakciu s komponentom.
Atribút	disabled
Typ	boolean
Predvolené	-

invalid

Popis	Riadi validáciu alebo stavové hlášky pre voľbu invalid.
Atribút	invalid
Typ	boolean
Predvolené	false

label

Popis	Nastavuje zobrazený alebo prístupný textový štítok.
Atribút	label
Typ	string
Predvolené	-

required

Popis	Označí komponent ako povinný pre validáciu formulára.
Atribút	required
Typ	string
Predvolené	false

value

Popis	Nastavuje aktuálnu hodnotu komponentu.
Atribút	value
Typ	string
Predvolené	-

Udalosti

Názov	Popis
wje-radio-group:change	Vyvolá sa pri zmene hodnoty komponentu.

Metódy

getRadioByValue

Popis	Vráti radio by hodnotu z aktuálneho stavu komponentu.
Signatúra	(value: string) => Radio

removeCheck

Popis	Odstráni check z aktuálneho stavu komponentu.
Signatúra	() => void

checkRadio

Popis	Spustí metódu checkRadio na vykonanie logiky komponentu a aktualizáciu jeho stavu.
Signatúra	(radio: any) => void

getAllElements

Popis	Vráti všetky elements z aktuálneho stavu komponentu.
Signatúra	() => HTMLElement[]

CSS tieňové časti

Pre tento komponent nie sú dostupné žiadne CSS časti tieňa.

CSS vlastné premenné

Pre tento komponent nie sú dostupné žiadne vlastné CSS vlastnosti.

Sloty

Názov	Popis
default	Predvolený slot pre hlavný obsah komponentu.