RadioGroup

shadow

RadioGroup serves as a container for a group of radio buttons. Allows users to select one option from a set of options, ensuring that only one radio button within a group is selected at any given time. The component supports the inline attribute, which, when set, arranges the radio buttons in a horizontal layout. In addition, it programmatically manages the value attribute, which reflects the value of the currently selected radio button.

When to use

Use wje-radio-group when users need to enter values, choose options, or trigger form-related actions.

When not to use

Do not use it as a decorative element without interaction. Prefer presentational components in that case.

Accessibility

Always provide a label (label/aria-label), keep keyboard support, and surface clear validation feedback.

Best Practices

• Keep validation rules and error behavior consistent across the entire form.
• Show loading or disabled states during async operations.
• Split complex forms into smaller sections with immediate feedback.

Attributes and Properties

required

Description	Getter for the name attribute.
Attribute	required
Type	boolean
Default	-

value

Description	Getter for the value attribute.
Attribute	value
Type	string
Default	-

disabled

Description	Disables user interaction with the component.
Attribute	disabled
Type	any
Default	-

invalid

Description	Controls validation or status messaging for invalid.
Attribute	invalid
Type	boolean
Default	false

label

Description	Getter for the label attribute.
Attribute	label
Type	string｜null
Default	-

Events

Name	Description
wje-radio-group:change	Emitted when the component value changes.

Methods

getRadioByValue

Description	Returns the radio button with the given value.
Signature	(value: string) => Radio

removeCheck

Description	Removes the check from all radio buttons.
Signature	() => void

checkRadio

Description	Sets the given radio button to checked.
Signature	(radio: any) => void

getAllElements

Description	Retrieves all direct child elements of the current element.
Signature	() => HTMLElement[]

CSS Shadow Parts

No CSS shadow parts available for this component.

CSS Custom Properties

No CSS custom properties available for this component.

Slots

Name	Description
default	The default slot for the radio group.