이 페이지는 Cloud Translation API를 통해 번역되었습니다.

라디오 버튼

라디오 버튼을 사용하면 사용자가 여러 옵션 중 하나를 선택할 수 있습니다. 목록에서 하나의 항목만 선택할 수 있는 경우 라디오 버튼을 사용합니다. 사용자가 두 개 이상의 항목을 선택해야 하는 경우 대신 스위치를 사용하세요.

API 노출 영역

RadioButton 컴포저블을 사용하여 사용 가능한 옵션을 나열합니다. 각 RadioButton 옵션과 라벨을 Row 구성요소 내에 래핑하여 함께 그룹화합니다.

RadioButton에는 다음과 같은 주요 매개변수가 포함됩니다.

selected: 라디오 버튼이 선택되었는지 여부를 나타냅니다.
onClick: 라디오 버튼을 클릭할 때 실행되는 람다 함수입니다. null인 경우 사용자는 라디오 버튼과 직접 상호작용할 수 없습니다.
enabled: 라디오 버튼의 사용 설정 여부를 제어합니다. 사용자는 사용 중지된 라디오 버튼과 상호작용할 수 없습니다.
interactionSource: 버튼의 상호작용 상태(예: 눌림, 마우스 오버, 포커스 여부)를 관찰할 수 있습니다.

기본 라디오 버튼 만들기

다음 코드 스니펫은 Column 내에서 라디오 버튼 목록을 렌더링합니다.

@Composable
fun RadioButtonSingleSelection(modifier: Modifier = Modifier) {
    val radioOptions = listOf("Calls", "Missed", "Friends")
    val (selectedOption, onOptionSelected) = remember { mutableStateOf(radioOptions[0]) }
    // Note that Modifier.selectableGroup() is essential to ensure correct accessibility behavior
    Column(modifier.selectableGroup()) {
        radioOptions.forEach { text ->
            Row(
                Modifier
                    .fillMaxWidth()
                    .height(56.dp)
                    .selectable(
                        selected = (text == selectedOption),
                        onClick = { onOptionSelected(text) },
                        role = Role.RadioButton
                    )
                    .padding(horizontal = 16.dp),
                verticalAlignment = Alignment.CenterVertically
            ) {
                RadioButton(
                    selected = (text == selectedOption),
                    onClick = null // null recommended for accessibility with screen readers
                )
                Text(
                    text = text,
                    style = MaterialTheme.typography.bodyLarge,
                    modifier = Modifier.padding(start = 16.dp)
                )
            }
        }
    }
}RadioButton.kt

코드 관련 핵심 사항

radioOptions은 라디오 버튼의 라벨을 나타냅니다.
구성 가능한 remember 함수는 상태 변수 selectedOption와 이 상태를 업데이트하는 함수 onOptionSelected를 만듭니다. 이 상태는 현재 선택된 라디오 버튼 옵션을 보유합니다.
- mutableStateOf(radioOptions[0])는 상태를 목록의 첫 번째 항목으로 초기화합니다. '통화'가 첫 번째 항목이므로 기본적으로 선택된 라디오 버튼입니다.
Modifier.selectableGroup(): 스크린 리더의 적절한 접근성 동작을 보장합니다. 이 Column 내의 요소가 선택 가능한 그룹의 일부임을 시스템에 알리므로 적절한 스크린 리더 지원이 가능합니다.
Modifier.selectable(): 전체 Row가 선택 가능한 단일 항목으로 작동합니다.
- selected는 selectedOption 상태에 따라 현재 Row가 선택되었는지 여부를 나타냅니다.
- onClick 람다 함수는 Row를 클릭할 때 selectedOption 상태를 클릭된 옵션으로 업데이트합니다.
- role = Role.RadioButton은 접근성 서비스에 Row가 라디오 버튼으로 작동한다고 알립니다.
RadioButton(...)는 RadioButton 컴포저블을 만듭니다.
- RadioButton의 onClick = null는 접근성을 개선합니다. 이렇게 하면 라디오 버튼이 클릭 이벤트를 직접 처리하지 못하고 Row의 selectable 수정자가 선택 상태와 접근성 동작을 관리할 수 있습니다.

결과

통화, 부재중, 친구라는 라벨이 지정된 라디오 버튼 3개 목록 친구 라디오 버튼이 선택되어 있습니다. — **그림 2.** '친구' 옵션이 선택된 라디오 버튼 3개

추가 리소스

Material Design: 버튼