RadioGroup

Usage

import { RadioGroup } from "@devvy-ui/react";

<RadioGroup label="Plan" name="plan" defaultValue="team" items={[{value:"solo",label:"Solo"},{value:"team",label:"Team",description:"For shared projects"}]} />

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
label / items	ReactNode / readonly RadioItem[]	required	Legend and unique value/label options.
value / defaultValue / onValueChange	string / string / callback	—	Controlled or initial native selection.
name / required / disabled	native form attributes	—	Form submission, validation and availability.
orientation	vertical \| horizontal	vertical	Visual arrangement.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add radio-group

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

RadioGroup.tsxREACT / TSX

import { forwardRef, useId, type FieldsetHTMLAttributes, type ReactNode } from 'react';
import { cx } from '../lib/cx';
export interface RadioItem {
  value: string;
  label: ReactNode;
  description?: ReactNode;
  disabled?: boolean;
}
export interface RadioGroupProps
  extends Omit<FieldsetHTMLAttributes<HTMLFieldSetElement>, 'defaultValue'> {
  label: ReactNode;
  items: readonly RadioItem[];
  value?: string;
  defaultValue?: string;
  onValueChange?: (value: string) => void;
  orientation?: 'horizontal' | 'vertical';
  required?: boolean;
}
export const RadioGroup = forwardRef<HTMLFieldSetElement, RadioGroupProps>(function RadioGroup(
  {
    label,
    items,
    value,
    defaultValue,
    onValueChange,
    name,
    orientation = 'vertical',
    required,
    disabled,
    form,
    className,
    ...props
  },
  ref,
) {
  const id = useId();
  if (new Set(items.map((item) => item.value)).size !== items.length)
    throw new Error('RadioGroup item values must be unique.');
  return (
    <fieldset
      {...props}
      ref={ref}
      name={name}
      form={form}
      disabled={disabled}
      className={cx('dvy-radio-group', className)}
      data-orientation={orientation}
    >
      <legend>{label}</legend>
      <div className="dvy-radio-items">
        {items.map((item, index) => (
          <label key={item.value} className="dvy-radio-option">
            <input
              type="radio"
              name={name ?? id}
              form={form}
              value={item.value}
              required={required}
              disabled={disabled || item.disabled}
              checked={value === undefined ? undefined : value === item.value}
              defaultChecked={value === undefined ? defaultValue === item.value : undefined}
              onChange={(event) => {
                if (event.target.checked) onValueChange?.(item.value);
              }}
              aria-describedby={item.description ? id + '-description-' + index : undefined}
            />
            <span>
              <span className="dvy-radio-label">{item.label}</span>
              {item.description && (
                <span className="dvy-radio-description" id={id + '-description-' + index}>
                  {item.description}
                </span>
              )}
            </span>
          </label>
        ))}
      </div>
    </fieldset>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.