State of Compose 2023 results are in! Click here to learn more

← Back to Material 3 Compose

RadioButton

Component
in
Material 3
. Since 1.0.0

Overview

Code Examples

Video

<a href="https://m3.material.io/components/radio-button/overview" class="external" target="_blank">Material Design radio button</a>.

Radio buttons allow users to select one option from a set.

!Radio button image(https://developer.android.com/images/reference/androidx/compose/material3/radio-button.png)

Overloads

RadioButton

@Composable
fun RadioButton(
    selected: Boolean,
    onClick: (() -> Unit)?,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    colors: RadioButtonColors = RadioButtonDefaults.colors(),
    interactionSource: MutableInteractionSource = remember { MutableInteractionSource() }
)

Parameters

NameDescription
selectedwhether this radio button is selected or not
onClickcalled when this radio button is clicked. If null, then this radio button will not be interactable, unless something else handles its input events and updates its state.
modifierthe Modifier to be applied to this radio button
enabledcontrols the enabled state of this radio button. When false, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
colorsRadioButtonColors that will be used to resolve the color used for this radio button in different states. See RadioButtonDefaults.colors.
interactionSourcethe MutableInteractionSource representing the stream of Interactions for this radio button. You can create and pass in your own remembered instance to observe Interactions and customize the appearance / behavior of this radio button in different states