Radio

The bq-radio component is a radio button form control with label and hint text.

Basic Usage

<bq-radio name="color" value="red" label="Red"></bq-radio>
<bq-radio name="color" value="blue" label="Blue"></bq-radio>
<bq-radio name="color" value="green" label="Green"></bq-radio>

Checked

<bq-radio name="plan" value="pro" label="Pro plan" checked></bq-radio>

With Hint

<bq-radio
  name="plan"
  value="enterprise"
  label="Enterprise"
  hint="For large teams with advanced needs."
></bq-radio>

Disabled

<bq-radio name="plan" value="legacy" label="Legacy" disabled></bq-radio>

Required

<bq-radio name="plan" value="pro" label="Pro plan" required></bq-radio>

Properties

Property	Type	Default	Description
label	string	—	Visible label text
name	string	—	Radio group name
value	string	—	Radio value
checked	boolean	false	Whether the radio is selected
disabled	boolean	false	Disables the radio
required	boolean	false	Marks the radio as required
hint	string	—	Helper text below the label

Events

Event	Detail	Description
bq-change	{ value: string, checked: boolean }	Fired when the selection changes

CSS Parts

Part	Description
wrapper	The outer wrapper
control	The radio control area
input	The native radio input
label	Label text element
hint	Hint text element

Form Participation

The component creates a hidden input proxy for native <form> submission. The proxy carries the name and value when checked.

Accessibility

• Each radio renders a native <input type="radio"> inside the shadow DOM for full keyboard support.
• Radios sharing a name behave as one group. Because each radio lives in its own shadow root, the platform's "one checked per name" rule cannot see the siblings, so the component clears them itself — scoped to the nearest <form> so two unrelated groups on one page do not interfere.
• The label is associated with the input via a wrapping <label> element.
• Use the required prop to mark mandatory radio fields; the required indicator is rendered visually and conveyed through the native required attribute on the internal radio input.