Unity RadioButtonGroup 소개 및 활용
Unity의 RadioButtonGroup 요소는 논리적인 라디오 버튼 그룹에서 단일 선택을 제공하는 UI 요소입니다. 이 문서에서는 RadioButtonGroup의 기능, 사용 방법, 그리고 활용 예제를 설명합니다.
RadioButtonGroup 개요
- 기능: RadioButtonGroup은 사용자가 여러 옵션 중에서 하나를 선택할 수 있도록 하며, 선택한 옵션을 변경하면 이전 선택은 자동으로 해제됩니다. 이는 DropdownField와 유사하지만, 모든 선택 사항이 화면에 표시된다는 점에서 차별화됩니다.
- 사용자 반응: RadioButtonGroup은 변경 이벤트에 반응하여, 사용자의 선택에 따라 동작할 수 있습니다. 사용자는 변수에 값을 바인딩하거나 수동으로 값을 평가할 수 있습니다.
RadioButtonGroup 구성 요소
| 구성 요소 | 설명 |
|---|---|
| Choices | 선택할 수 있는 항목 리스트 (문자열 배열) |
| Value | 선택된 항목의 번호 |
| binding-path | 바인드될 타겟 프로퍼티의 경로 |
| focusable | 요소의 포커스 가능 여부 |
| label | 필드 옆에 표시될 레이블 |
| tabindex | 포커스 링에서의 정렬을 위한 정수 |
| content-container | 자식 요소가 추가될 위치 |
| style | 요소의 스타일 오브젝트에 대한 레퍼런스 |
| tooltip | 마우스를 요소 위에 올릴 때 표시될 텍스트 |
RadioButtonGroup 사용 방법
1. UI 빌더에서 옵션 추가
RadioButtonGroup의 옵션을 추가하려면 인스펙터에서 Choices에 쉼표로 구분된 옵션을 입력합니다. 기본값을 설정하려면 Value에 번호를 입력합니다. 번호는 0부터 시작합니다.
2. C# 스크립트에서 RadioButtonGroup 생성
다음은 C# 코드로 4개의 옵션을 가진 RadioButtonGroup을 생성하고, 변경된 값을 로그로 출력하는 예입니다.
var radiogroup = new RadioButtonGroup("Options", new List<string> { "Option 1", "Option 2", "Option 3", "Option 4" });
radiogroup.RegisterValueChangedCallback(evt => Debug.Log(evt.newValue));
window.rootVisualElement.Add(radiogroup);
3. 예제 확인
RadioButton 사용 방법을 배우는 가장 좋은 방법은 예시를 직접 확인하는 것입니다. Unity 메뉴에서 Window > UI Toolkit > Samples > RadioButtonGroup을 선택하여 샘플을 확인할 수 있습니다.
C# 클래스 및 네임스페이스
- C# 클래스: RadioButtonGroup
- 네임스페이스: UnityEngine.UIElements
USS 클래스 매핑
다음은 C# 공용 프로퍼티 이름과 관련된 USS 선택자의 리스트입니다.
| C# 프로퍼티 | USS 선택자 | 설명 |
|---|---|---|
| ussClassName | .unity-radio-button-group | RadioButtonGroup 요소의 USS 클래스명 |
| containerUssClassName | .unity-radio-button-group__container | 컨테이너 요소의 USS 클래스명 |
| ussClassName | .unity-base-field | 기본 필드의 USS 클래스명 |
| labelUssClassName | .unity-base-field__label | 레이블의 USS 클래스명 |
| inputUssClassName | .unity-base-field__input | 입력 요소의 USS 클래스명 |
| noLabelVariantUssClassName | .unity-base-field--no-label | 레이블이 없는 요소의 USS 클래스명 |
| disabledUssClassName | .unity-disabled | 비활성화된 요소의 USS 클래스명 |
추가 리소스 링크
Unity의 RadioButtonGroup을 활용하여 다양한 사용자 인터페이스를 구성하고, 사용자 경험을 향상시킬 수 있습니다. 문서의 다른 부분에서 더 많은 정보를 탐색하여 더 나은 UI를 구축해보세요!