为应用添加单选按钮

试用 Compose 方式
Jetpack Compose 是推荐用于 Android 的界面工具包。了解如何在 Compose 中添加组件。

单选按钮可让用户从一组互斥选项中选择一个选项。如果用户需要查看列出的所有可用选项,请使用单选按钮。如果无需显示所有选项,请改用旋转图标

Material.io 中的单选按钮示例
图 1.Material Design 中的单选按钮示例。

如需创建每个单选按钮选项,请在布局中创建一个 RadioButton。由于单选按钮是互斥的,因此将它们分组到 RadioGroup 中。 系统会确保一次只能选择组中的一个单选按钮。

响应点击事件

当用户选择单选按钮时,相应的 RadioButton 对象会收到点击事件。

以下示例展示了对用户点按组中 RadioButton 对象的反应:

<?xml version="1.0" encoding="utf-8"?>
<RadioGroup
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">
    <RadioButton android:id="@+id/radio_pirates"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Pirates"/>
    <RadioButton android:id="@+id/radio_ninjas"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Ninjas"/>
</RadioGroup>

在托管此布局的 ActivityFragment 内,找到单选按钮并为每个按钮设置更改监听器,如下所示:

Kotlin

findViewById<RadioButton>(R.id.radio_pirates).setOnCheckedChangeListener { buttonView, isChecked ->
    Log.d("RADIO", "Pirates is checked: $isChecked")
}

findViewById<RadioButton>(R.id.radio_ninjas).setOnCheckedChangeListener { buttonView, isChecked ->
    Log.d("RADIO", "Ninjas is checked: $isChecked")
}

Java

findViewById<RadioButton>(R.id.radio_pirates).setOnCheckedChangeListener { buttonView, isChecked ->
    Log.d("RADIO", "Pirates is checked: $isChecked");
}

findViewById<RadioButton>(R.id.radio_ninjas).setOnCheckedChangeListener { buttonView, isChecked ->
    Log.d("RADIO", "Ninjas is checked: $isChecked");
}

在此示例中,当用户点按其中一个单选按钮时,Logcat 中会显示一条消息。