Components

Radio Group

Radio button groups for single-choice selections with clear visual hierarchy, accessibility support, and bilingual labels for government applications.

Basic Usage

A simple radio group with multiple options. Only one option can be selected at a time.

Layout Options

Radio groups can be arranged horizontally or vertically depending on your layout needs.

Government Form Examples

Real-world examples showing radio groups in government forms with bilingual labels and proper accessibility.

Citizenship Application / নাগরিকত্বের আবেদন

Use Cases

Personal Information

Gender selection, marital status, citizenship status, employment type, age groups

Form Preferences

Language preferences, service types, communication methods, document formats

Service Categories

Department selection, service priorities, appointment types, application categories

Verification & Security

Authentication methods, security questions, verification types, access levels

Best Practices

Option Organization

  • • Limit radio groups to 2-7 options for optimal usability
  • • Order options logically (alphabetical, frequency, or importance)
  • • Use consistent spacing between radio buttons and labels
  • • Group related options together with clear section headers

User Experience

  • • Provide clear, descriptive labels for each option
  • • Set appropriate default selections when applicable
  • • Use horizontal layout for yes/no or few options
  • • Ensure adequate clickable area for touch interfaces

Accessibility & Internationalization

  • • Associate labels properly with radio buttons using htmlFor
  • • Support keyboard navigation with arrow keys
  • • Provide bilingual labels for government applications
  • • Ensure high contrast between selected and unselected states

Usage Guidelines

Do

  • Use for mutually exclusive single selections
  • Provide clear, descriptive labels for each option
  • Group related options logically
  • Set sensible default selections when appropriate
  • Use bilingual labels for government forms
  • Ensure proper keyboard navigation support

Don't

  • Use for multiple selections (use checkboxes instead)
  • Include too many options (consider dropdown for 8+ items)
  • Use vague or ambiguous option labels
  • Forget to provide a "None" or "Other" option when needed
  • Mix radio buttons with other selection types in one group
  • Make radio buttons too small for easy selection

Component Specifications

Detailed specifications and characteristics of the Radio Group component for implementation guidance.

SpecificationDetailsPurpose & Usage
Component TypeSingle Selection ControlAllows users to select one option from a mutually exclusive list
Complexity LevelLowSimple to implement with basic state management requirements
Selection PatternMutually exclusive, Single choice, Required validationEnsures only one option can be selected at a time
State ManagementSelected, Unselected, Disabled, Error, FocusClear visual feedback for selection states and user interactions
Layout OptionsVertical stack, Horizontal row, Compact grid, Card layoutFlexible arrangements to suit different form contexts and space
Accessibility FeaturesKeyboard navigation, Screen reader support, ARIA attributes, Focus managementEnsures usability for all citizens including those with disabilities
Language SupportEnglish, Bengali (বাংলা)Bilingual option labels and descriptions for government applications
Design SystemColor tokens, Typography scale, Spacing units, Border stylesConsistent with CivixUI design principles and government branding
Validation FeaturesRequired selection, Custom validation rules, Error displayEnsures proper selection validation for government form requirements
Use CasesSingle-choice forms, Preference selection, Options selection, ConfigurationEssential for single-choice selections in government service applications

Accessibility

  • • Full keyboard navigation with arrow keys, Tab, and Space
  • • Screen reader support with proper role and state announcements
  • • Labels are properly associated with radio buttons using htmlFor
  • • Focus indicators are clearly visible and meet WCAG standards
  • • Radio group has proper ARIA attributes for structure
  • • Selected state is announced to assistive technologies
  • • High contrast mode support for all visual states
  • • Touch targets meet minimum size requirements (44px)