Unity 매뉴얼: UI 툴킷 및 UXML 요소에 대한 안내
이 문서는 Unity에서 사용자 인터페이스(UI)를 생성하는 데 필요한 UI 툴킷과 UXML 요소에 대한 내용을 설명합니다. 이 자료는 Unity 개발자가 UI 요소를 생성하고 사용하는 데 도움을 주기 위해 작성되었습니다.
UI 툴킷
UI 구조화
Unity의 UI 툴킷은 UXML(사용자 정의 XML) 파일을 사용하여 UI를 설계하고 구성할 수 있게 합니다. UXML은 UI 요소의 구조를 정의하는 데 사용됩니다.
UXML 요소 레퍼런스
VisualElement
- 설명: UI의 모든 요소의 기본 클래스입니다.
- 네임스페이스:
UnityEngine.UIElements - 기본 클래스:
Focusable
주요 속성
| Name | 타입 | 설명 |
|---|---|---|
| content-container | string | 자식 요소가 추가되는 컨테이너. |
| name | string | 요소의 고유 이름. USS 선택자에서 특정 요소를 타겟팅하는 데 사용됨. |
| picking-mode | UIElements.PickingMode | 마우스 이벤트에서 요소 선택 가능 여부 결정 |
| style | string | 스타일 오브젝트에 대한 참조. |
| tooltip | string | 요소 위에 마우스를 놓으면 표시되는 텍스트. |
| usage-hints | UIElements.UsageHints | 고수준의 사용 패턴 힌트. Panel에 포함되면 읽기 전용으로 변환됨. |
| view-data-key | string | UI 데이터 지속성을 위한 키. |
상속된 UXML 속성
VisualElement는 기본 클래스에서 다음 속성을 상속받습니다.
| Name | 타입 | 설명 |
|---|---|---|
| focusable | boolean | 요소에 포커스를 맞출 수 있으면 true. |
| tabindex | int | 포커스를 맞출 항목의 정렬 순서. 0 이상이어야 함. |
USS 클래스
아래 표는 모든 C# 공용 프로퍼티 이름과 관련된 USS 선택자입니다.
| C# 프로퍼티 | USS 선택자 | 설명 |
|---|---|---|
| disabled | UssClassName.unity-disabled | 비활성화된 요소의 USS 클래스명. |
활용 예시
예제 1: VisualElement 생성 및 속성 설정
using UnityEngine.UIElements;
public class Example : MonoBehaviour
{
void Start()
{
var visualElement = new VisualElement();
visualElement.name = "myElement"; // 이름 설정
visualElement.pickingMode = PickingMode.Ignore; // 선택 모드 설정
visualElement.tooltip = "이 요소에 대한 툴팁입니다."; // 툴팁 설정
}
}
예제 2: 요소에 스타일 추가
using UnityEngine.UIElements;
public class Example : MonoBehaviour
{
void Start()
{
var visualElement = new VisualElement();
visualElement.style.backgroundColor = Color.red; // 배경 색상 설정
visualElement.AddToClassList("my-uss-class"); // USS 클래스 추가
}
}
이 문서를 통해 Unity에서의 UI 요소 생성 및 관리를 이해하는 데 도움이 되기를 바랍니다. UI 툴킷의 다양한 기능을 활용하여 매력적인 사용자 인터페이스를 제작해보세요.