What is @material/radio?
@material/radio is a Material Design radio button component for the web. It provides a set of customizable radio buttons that adhere to the Material Design guidelines, ensuring a consistent and visually appealing user interface.
What are @material/radio's main functionalities?
Basic Radio Button
This code sample demonstrates a basic radio button using the @material/radio package. It includes the necessary HTML structure and CSS classes to create a Material Design radio button.
<div class="mdc-form-field">
<div class="mdc-radio">
<input class="mdc-radio__native-control" type="radio" id="radio-1" name="radios" checked>
<div class="mdc-radio__background">
<div class="mdc-radio__outer-circle"></div>
<div class="mdc-radio__inner-circle"></div>
</div>
</div>
<label for="radio-1">Radio 1</label>
</div>
Disabled Radio Button
This code sample shows how to create a disabled radio button using the @material/radio package. The 'disabled' attribute is added to the input element to make the radio button non-interactive.
<div class="mdc-form-field">
<div class="mdc-radio">
<input class="mdc-radio__native-control" type="radio" id="radio-2" name="radios" disabled>
<div class="mdc-radio__background">
<div class="mdc-radio__outer-circle"></div>
<div class="mdc-radio__inner-circle"></div>
</div>
</div>
<label for="radio-2">Radio 2 (Disabled)</label>
</div>
Custom Styling
This code sample demonstrates how to apply custom styling to a radio button using the @material/radio package. Custom CSS is used to change the color of the radio button's outer circle and inner circle.
<style>
.custom-radio .mdc-radio__background {
border-color: #ff5722;
}
.custom-radio .mdc-radio__inner-circle {
background-color: #ff5722;
}
</style>
<div class="mdc-form-field custom-radio">
<div class="mdc-radio">
<input class="mdc-radio__native-control" type="radio" id="radio-3" name="radios">
<div class="mdc-radio__background">
<div class="mdc-radio__outer-circle"></div>
<div class="mdc-radio__inner-circle"></div>
</div>
</div>
<label for="radio-3">Custom Styled Radio</label>
</div>
Other packages similar to @material/radio
react-radio-group
react-radio-group is a React component for creating radio button groups. It provides a simple API for managing radio button states and is highly customizable. Unlike @material/radio, which is based on Material Design guidelines, react-radio-group is more flexible in terms of styling and can be used in various design systems.
antd
Ant Design (antd) is a comprehensive UI library for React that includes a set of high-quality components, including radio buttons. The radio buttons in antd are highly customizable and come with built-in support for themes and internationalization. Compared to @material/radio, antd offers a broader range of components and is designed for enterprise-level applications.
semantic-ui-react
semantic-ui-react is the official React integration for Semantic UI. It provides a set of components, including radio buttons, that follow the Semantic UI design principles. The radio buttons in semantic-ui-react are easy to use and integrate well with other Semantic UI components. Unlike @material/radio, which follows Material Design guidelines, semantic-ui-react follows the Semantic UI design language.
Selection controls: radio buttons
Selection controls allow the user to select options.
Use radio buttons to:
- Select a single option from a list
- Expose all available options
- If available options can be collapsed, consider using a dropdown menu instead to use less space.

Contents
Using radio buttons
Radio buttons allow the user to select one option from a set. Use radio buttons when the user needs to see all available options. If available options can be collapsed, consider using a dropdown menu because it uses less space.
Installing radio buttons
npm install @material/radio
Styles
@use "@material/radio/styles";
@use "@material/form-field";
@include form-field.core-styles;
Note: The form field styles are only required when the radio button is used with the form field.
JavaScript instantiation
The radio button will work without JavaScript, but you can enhance it with a ripple interaction effect by instantiating MDCRadio
on the mdc-radio
element. To activate the ripple effect upon interacting with the label, you must also instantiate MDCFormField
on the mdc-form-field
element and set the MDCRadio
instance as its input
.
import {MDCFormField} from '@material/form-field';
import {MDCRadio} from '@material/radio';
const radio = new MDCRadio(document.querySelector('.mdc-radio'));
const formField = new MDCFormField(document.querySelector('.mdc-form-field'));
formField.input = radio;
Note: See Importing the JS component for more information on how to import JavaScript.
Making radio buttons accessible
Material Design spec advises that touch targets should be at least 48px x 48px.
To meet this requirement, add the mdc-radio--touch
class to your radio as follows:
<div class="mdc-touch-target-wrapper">
<div class="mdc-radio mdc-radio--touch">
<input class="mdc-radio__native-control" type="radio" id="radio-1" name="radios" checked>
<div class="mdc-radio__background">
<div class="mdc-radio__outer-circle"></div>
<div class="mdc-radio__inner-circle"></div>
</div>
<div class="mdc-radio__ripple"></div>
<div class="mdc-radio__focus-ring"></div>
</div>
</div>
Note that the outer mdc-touch-target-wrapper
element is only necessary if you want to avoid potentially overlapping touch targets on adjacent elements (due to collapsing margins).
The mdc-radio__focus-ring
element ensures that a focus indicator is displayed in high contrast mode around the active/focused radio button.
Radio buttons
We recommend using MDC Radio with MDC Form Field for enhancements such as label alignment, label activation of the ripple interaction effect, and RTL-awareness.
Radio button example
<div class="mdc-form-field">
<div class="mdc-radio">
<input class="mdc-radio__native-control" type="radio" id="radio-1" name="radios" checked>
<div class="mdc-radio__background">
<div class="mdc-radio__outer-circle"></div>
<div class="mdc-radio__inner-circle"></div>
</div>
<div class="mdc-radio__ripple"></div>
<div class="mdc-radio__focus-ring"></div>
</div>
<label for="radio-1">Radio 1</label>
</div>
Radio button states
Radio buttons can be selected or unselected. Radio buttons have enabled, disabled, hover, focused, and pressed states.

Other variants
Disabled radio buttons
To disable a radio button, add the mdc-radio--disabled
class to the root element and set the disabled
attribute on the <input>
element.
Disabled radio buttons cannot be interacted with and have no visual interaction effect.
<div class="mdc-form-field">
<div class="mdc-radio mdc-radio--disabled">
<input class="mdc-radio__native-control" type="radio" id="radio-1" name="radios" disabled>
<div class="mdc-radio__background">
<div class="mdc-radio__outer-circle"></div>
<div class="mdc-radio__inner-circle"></div>
</div>
<div class="mdc-radio__ripple"></div>
<div class="mdc-radio__focus-ring"></div>
</div>
<label for="radio-1">Radio 1</label>
</div>
API
Sass mixins
MDC Radio uses MDC Theme's secondary
color by default. Use the following mixins to customize it.
unchecked-stroke-color($color) | Sets the stroke color of an unchecked, enabled radio button |
checked-stroke-color($color) | Sets the stroke color of a checked, enabled radio button |
ink-color($color) | Sets the ink color of an enabled radio button |
disabled-unchecked-stroke-color($color) | Sets the stroke color of an unchecked, disabled radio button |
disabled-checked-stroke-color($color) | Sets the stroke color of a checked, disabled radio button |
disabled-ink-color($color) | Sets the ink color of a disabled radio button |
focus-indicator-color($color) | Sets the color of the focus indicator |
touch-target($size, $ripple-size) | Sets radio touch target size which can be more than the ripple size. Param $ripple-size is required for custom ripple size, defaults to $ripple-size . |
ripple-size($size) | Sets custom ripple size of radio. |
density($density-scale) | Sets density scale for radio. Supported density scale values are -3 , -2 , -1 and 0 (default). |
MDCRadio
properties and methods
checked | Boolean | Setter/getter for the radio's checked state |
disabled | Boolean | Setter/getter for the radio's disabled state. Setter proxies to foundation's setDisabled method |
value | String | Setter/getter for the radio's value |
Usage within web frameworks
If you are using a JavaScript framework, such as React or Angular, you can create a Radio button for your framework. Depending on your needs, you can use the Simple Approach: Wrapping MDC Web Vanilla Components, or the Advanced Approach: Using Foundations and Adapters. Please follow the instructions here.
MDCRadioAdapter
setNativeControlDisabled(disabled: boolean) => void | Sets the input's disabled property to the given value |
addClass(className: string) => void | Adds a class to the root element |
removeClass(className: string) => void | Removes a class from the root element |
MDCRadioFoundation
setDisabled(disabled: boolean) => void | Sets the disabled value of the native control |
14.0.0 (2022-04-27)
Bug Fixes
- button: update HCM shim to use the existing focus-ring (a657abb)
- checkbox: Add explicit system color for checkmark in HCM. (8c4da22)
- checkbox: move forced-colors theme out of static styles (bbd1126)
- checkbox: Update checkbox theme styles mixin to accept css vars (c14e977)
- chips: Fix typography selector in GMDC-Wiz chips theming (43c7d87)
- datatable: Adjust data table last row border-radius to support setting row background-color. (ba78e87)
- dialog: Render dividers in Firefox 94 on Windows HCM (fae6c65)
- dialog: Set default z-index for close button in FloatingSheet dialog. (3366a71)
- fab: Add focus ring in HCM. (d57ec74)
- focus-ring: add 2d padding customizability, RTL bugfix (f81fb1d)
- focus-ring: box-sizing bugfix to content-box. If box-sizing border-box is inherited the ring spacing will collapse. (e58552c)
- focus-ring: ignore pointer events (3ef470e)
- focus-ring: RTL bugfix (e00181e)
- iconbutton: Fixed max width and height for high contrast mode focus ring on icon buttons. Display only in forced colors mode. (cf42927)
- iconbutton: Set icon button ripple z-index to -1. (586e740)
- list: Improve a11y for multi-select lists (9736ddc)
- list: Remove conflicting validation for checkbox list in setEnabled (353ca7e)
- list: Update lastSelectedIndex when toggling a checkbox range (dcba26f)
- menusurface: Add a getOwnerDocument() method to MDCMenuSurfaceAdapter to provide a reference to the document that owns the menu surface DOM element. (3486659)
- radio: Fix disabled state in Firefox Windows high contrast mode (23043ac)
- radio: Modify theme styles Sass mixin validation to validate only keys (390220e)
- select: Add border to select menu in HCM. (5d80969)
- select: revert down/up arrow on anchor changing selected index (43d08ba)
- slider: Fix bug where secondary click moves slider thumb. (3ab9565)
- slider: Fix IE11 bug -
unset
is unsupported in IE. (f460e23)
- slider: In updateUI, fix behavior to match jsdoc claim that when thumb param is undefined it updates both thumbs. Input attributes were not being updated at all. (cc4ed13)
- slider: Make the slider errors easier to debug by providing all relevant values in the error message. (8687937)
- snackbar: address Trusted Types violation (cbd9358)
- tooltip: Adjusts logic in
validateTooltipWithCaretDistances
method. (3e30054)
- typography: Fixes typography
theme-styles
mixin... the value being retreived from the $theme
map and css property name was swapped. The mixin would request font-size
/font-weight
/letter-spacing
from the $theme
map (which expects size
/weight
/tracking
)... so these values would always be null
. (32b3913)
- Remove /** @override */ tags from TypeScript code. (c3cdff0)
- Simplify MDCAttachable interface to be any object (Function) that has
attachTo
. (05db65e)
- Snackbar action button ripple color is applied to the ripple element. (4e66fb2)
- Work around bug in Sass (037285f), closes sass/sass#3259
- switch: Restore Firefox 94 HCM outlines (39cf14b)
- textfield: Fix breaking tests due to no valid pointerId being associated with pointer events. (15db4f1)
- tooltip: Only sends notification of a tooltip being hidden if
showTimeout
is not set (indicating that this tooltip is about to be re-shown). (6ca8b8f)
Features
- banner: Add disableAutoClose params for both banner actions to prevent the banner buttons from automatically closing the banner. Add adapter #notifyActionClicked method. (b094eaa)
- chips: add focus ring styles (783f6fd)
- chips: Added elevation tint layer color support in chips (c78ff04)
- data-table: separate table structure into its own mixin (9f9d928)
- dialog: Add styling for floating sheets (78305b6)
- dialog: Add styling for floating sheets with content padding (3e20c1d)
- Dialog: Adds an API to hide the header for GMDC Fullscreen Dialog in non-fullscreen mode (ab4aba1)
- Dialog: Adds an API to set custom position for GMDC Dialog (ea9b5b4)
- Dialog: Adds an API to set custom z-index for GMDC Dialog (96ea061)
- focus-ring: added a new mixin so we can override just the focus-ring color (641ed08)
- focus-ring: added a new mixin so we can override just the focus-ring radius (7321d62)
- iconbutton: Add link icon button Sass. (9803d2d)
- mdc-list: introduce selection change event (7d8ea46)
- menu: allow preferentially opening surface below anchor (261f2db)
- MenuSurface: Add opening event for menus. (53b3cad)
- select: Add theming mixin boilerplate code to select (ae8a6a3)
- select: Add validation getter methods. (bdf1d37)
- select: Added theme mixins to MDC select (dcfe49c)
- slider: Add
minRange
param to range sliders to request a minimum gap between the two thumbs. (8fffcb5)
- slider: Add an option to hide focus styles after pointer interaction. (ec54d90)
- slider: Keep the slider value indicator within the bounds of the slider if possible. (c047f7c)
- state: make context aware (b2fe352)
- switch: Add high contrast mode focus ring to switch (f31a833)
- text-field: Add theming mixin boilerplate code to text-field (eb382f3)
- text-field: Added theme mixins to MDC text field (344d528)
- textfield: adding input-font-size mixin (207230e)
- theme: allow custom property strings in theme.validate-theme() (4e372fb)
- add new class and mixin for open state of a menu item (9a02b6e)
- Indicate which thumb
valueToAriaValueTextFn
and valueToValueIndicatorTextFn
functions are called for. (b6510c8)
- textfield: adding input-font-family mixin (991fb99)
- Describe how to add child lists into a list item. (758ce31)
BREAKING CHANGES
- MenuSurface: Adds #notifyOpening method to menu surface adapter.
PiperOrigin-RevId: 444830518
- slider: Adds #getValueIndicatorContainerWidth method to slider adapter.
PiperOrigin-RevId: 419837612