Unity 사용자 매뉴얼 2022.3 (LTS)
이 문서는 Unity의 매뉴얼 스크립팅 API에 대한 설명입니다. 이 부분에서는 사용자 인터페이스(UI) 생성과 관련된 다양한 요소와 속성을 다룹니다.
UI 툴킷
UXML 요소 레퍼런스
UXML은 Unity UI를 정의하는 마크업 언어입니다. 이번 섹션에서는 UnsignedIntegerField 요소에 대해 상세히 설명합니다.
UXML 요소: UnsignedIntegerField
- C# 클래스:
UnsignedIntegerField - 네임스페이스:
UnityEngine.UIElements - 기본 클래스:
TextValueField_1
속성
- binding-path: 바인드될 타겟 프로퍼티의 경로입니다.
- focusable: 요소에 포커스를 맞출 수 있는지를 정의하며, true이면 포커스 가능하다는 의미입니다.
- is-delayed: true로 설정하면 Enter 키를 누르거나 텍스트 필드가 포커스를 벗어날 때까지 값 프로퍼티가 업데이트되지 않습니다.
- label: 필드 옆에 표시될 레이블을 정의하는 문자열입니다.
- tabindex: 포커스 링에서 포커스를 맞출 수 있는 항목을 정렬하는 데 사용되는 값입니다. 0보다 크거나 같아야 합니다.
- value: 필드와 연결된 값입니다.
VisualElement 속성
다음은 UnsignedIntegerField가 상속하는 VisualElement의 속성입니다:
- content-container: 자식 요소가 추가되며, 일반적으로 요소 자체와 동일합니다.
- name: VisualElement의 이름으로 특정 요소를 타겟팅하는 USS 선택자를 작성하는 데 사용됩니다.
- picking-mode: 요소를 선택할 수 있는지를 결정합니다.
- style: 요소의 스타일 오브젝트에 대한 참조입니다.
- tooltip: 사용자에게 정보를 제공할 텍스트입니다.
- usage-hints: VisualElement에 대한 고수준의 의도된 사용 패턴을 정의합니다.
USS 클래스
UnsignedIntegerField와 관련된 C# 프로퍼티 이름과 USS 선택자는 다음과 같습니다:
| C# 프로퍼티 | USS 선택자 | 설명 |
|---|---|---|
| ussClassName | .unity-unsigned-integer-field | 이 타입 요소의 USS 클래스명입니다. |
| label | .unity-unsigned-integer-field__label | 이 타입의 요소에 있는 레이블의 USS 클래스명입니다. |
| input | .unity-unsigned-integer-field__input | 이 타입의 요소에 있는 입력 요소의 USS 클래스명입니다. |
활용 예제
- UI 폼 구성:
UnsignedIntegerField를 통해 사용자가 정수 값을 입력할 수 있는 UI 폼을 구성합니다. - 데이터 바인딩:
binding-path속성을 활용하여 입력 필드를 데이터 모델에 쉽게 바인딩 할 수 있습니다. - 사용자 피드백 제공:
tooltip속성을 사용하여 사용자에게 입력 필드의 목적을 설명하는 툴팁을 제공합니다.
Unity의 UI 툴킷을 활용하면 직관적이고 효율적인 사용자 인터페이스를 설계할 수 있습니다. 각 요소와 속성을 적절히 조합하면 더욱 나은 사용자 경험을 제공할 수 있습니다.