바인드 가능 커스텀 컨트롤 만들기

버전: 2023.2+

이 예제는 커스텀 에디터 창에서 바인딩 가능한 커스텀 컨트롤을 만드는 방법을 보여줍니다.

개요 예시

이 예제에서는 이중 데이터 타입을 사용하여 프로퍼티에 바인딩된 커스텀 컨트롤을 만듭니다.이 예제를 문자열이나 정수와 같은 다른 데이터 타입이 있는 프로퍼티에 바인딩하도록 조정할 수 있습니다.

이 예시에서 생성하는 완전한 파일을 GitHub 저장소에서 찾을 수 있습니다.

선행 조건

이 가이드는 Unity 에디터, UI 툴킷, C# 스크립팅에 익숙한 개발자용입니다.시작하기 전에 먼저 다음을 숙지하십시오.

• UI 빌더
• 시각적 트리
• UXML
• SerializedObject 데이터 바인딩

커스텀 컨트롤 클래스 만들기

C# 클래스를 생성하여 커스텀 컨트롤을 정의합니다.

1. 임의의 템플릿을 사용하여 Unity 프로젝트를 생성합니다.
2. ’ExampleField’라는 폴더를 만들어 파일을 저장합니다.
3. ExampleField 폴더에서 ExampleField.cs라는 이름의 C# 스크립트를 만들고 해당 콘텐츠를 다음과 같이 바꿉니다.

[!code-cs]

UXML 파일에서 커스텀 컨트롤 사용

1. ExampleField 폴더에 ExampleField.uxml이라는 이름의 UI 문서를 생성합니다.
2. 텍스트 에디터에서 ExampleField.uxml을 열고 해당 콘텐츠를 다음과 같이 바꿉니다.

[!code-xml]

바인딩 타겟에 대한 클래스 생성

1. Unity에서 ’ExampleField.uxml’을 더블 클릭하여 UI 빌더에서 엽니다.ExampleField가 Hierarchy(계층) 창에 표시되며 뷰포트에 시각화됩니다.계층 창에서 해당 ExampleField를 선택하면 인스펙터(Inspector) 창에 Binding Path 및 Label 상자에 할당된 값이 표시됩니다.
2. ExampleField 폴더에서 ExampleFieldComponent.cs라는 이름의 C# 스크립트를 만들고 해당 콘텐츠를 다음과 같이 바꿉니다.

[!code-cs]

바인딩 타겟에 대한 커스텀 에디터 생성

1. ExampleField 폴더에서 Editor라는 이름의 폴더를 만듭니다.
2. Editor 폴더에서 ExampleFieldCustomEditor.cs라는 이름의 C# 스크립트를 만들고 해당 콘텐츠를 다음과 같이 바꿉니다.

[!code-cs]

예제 테스트

1. Unity의 프로젝트 창에서 ExampleFieldCustomEditor.cs를 선택합니다.
2. ExampleField.uxml을 인스펙터 창의 Uxml 상자로 드래그합니다.
3. 씬에 빈 게임 오브젝트를 추가합니다.
4. ExampleFieldComponent 컴포넌트를 게임 오브젝트에 추가합니다.커스텀 컨트롤은 인스펙터에서 바인딩 타겟에 대한 기본값이 ’0’으로 나타납니다.기본 이중 프로퍼티의 값을 변경하면 UI에 해당 변경 사항이 반영됩니다.

추가 리소스

• 커스텀 컨트롤