Version: 2023.1
언어: 한국어
요소를 사용한 작업
UI 빌더로 UI 스타일링

UXML 인스턴스를 템플릿으로 사용

Unity에서 프리팹이 작동하는 방식과 유사하게 기존 UXML 문서를 템플릿으로 인스턴스화하여 템플릿 인스턴스로 사용할 수 있습니다.

UXML 문서를 템플릿으로 사용

프로젝트에서 기존 UXML 문서를 템플릿으로 사용하려면 다음 단계를 따르십시오.

  1. LibraryProject 탭 아래에서 인스턴스화할 UXML 에셋(.uxml)을 찾습니다.
  2. UXML 에셋을 Library의 요소처럼 Hierarchy로 드래그합니다.

템플릿 인스턴스TemplateContainer 유형의 일반 요소처럼 Hierarchy에 나타납니다..uxml` 파일 이름은 이름 오른쪽에 회색 글꼴로 표시됩니다.템플릿 인스턴스를 확장하면 인스턴스의 내부 계층 구조를 확인할 수 있습니다.이 내부 계층 구조는 요소를 사용한 작업에 설명된 대로 읽기 전용이며 참조용으로만 사용할 수 있습니다.

하위 문서를 템플릿으로 만들기

UXML 문서 내의 하위 문서를 템플릿 인스턴스로 만들어 재사용할 수 있습니다.

  1. 해당 하위 문서를 오른쪽 클릭합니다.
  2. Create Template을 선택합니다.
  3. 파일을 저장할 위치를 선택합니다.

이렇게 하면 기존 문서에서 하위 문서가 템플릿 인스턴스로 인스턴스화됩니다.

UXML 문서 템플릿 인스턴스 편집

템플릿 인스턴스로 사용되는 원본 UXML 문서를 편집하려면 템플릿 인스턴스를 오른쪽 클릭하고 다음 옵션 중 하나를 선택합니다.

  • Open in UI Builder:현재 UXML 문서를 언로드하고 Template Instance를 로드합니다.

    UI 빌더 예제에서 열기
    UI 빌더 예제에서 열기
  • Open Instance in Isolation:Template Instance를 로드하는 동안 배경에서 현재 UXML 문서가 로드된 상태를 유지합니다.HierarchyCanvas에는 해당 템플릿 인스턴스의 콘텐츠만 표시되며, StyleSheets 창에는 읽기 전용 상태로 배경 부모 UXML 문서의 스타일시트가 포함됩니다.이것은 다음과 같이 스타일시트가 여전히 템플릿 인스턴스에 적용되고 있기 때문입니다.

    격리된 상태로 인스턴스 열기 예제
    격리된 상태로 인스턴스 열기 예제
  • Open Instance in Context:모든 요소를 읽기 전용으로 설정하고 HierarchyCanvas에서 흐리게 표시하면서 현재 UXML 문서를 로드한 상태로 유지합니다.템플릿 인스턴스의 콘텐츠는 부모 UXML 문서의 컨텍스트 내에서 편집할 수 있습니다.이 옵션을 사용하면 호스트 문서의 컨텍스트를 잃지 않고 템플릿 인스턴스 콘텐츠를 업데이트할 수 있습니다.

    컨텍스트에서 인스턴스 열기 예제
    컨텍스트에서 인스턴스 열기 예제
  • Show in Project:프로젝트(Project) 창에 Template Instance 파일의 위치를 표시합니다.

두 번째 및 세 번째 옵션의 경우 Viewport 위에 이동 경로가 표시됩니다.이 이동 경로를 사용하여 부모 UXML 문서로 돌아갈 수 있습니다.

하위 문서 이동 경로 예제
하위 문서 이동 경로 예제

UXML 문서 템플릿 인스턴스 압축 풀기

하나의 템플릿 인스턴스의 압축을 풀려면 템플릿 인스턴스를 오른쪽 클릭하고 Unpack Instance를 선택합니다.이렇게 하면 템플릿 인스턴스가 일반 UXML 문서로 변경됩니다.

모든 템플릿 인스턴스의 압축을 풀려면 템플릿 인스턴스를 오른쪽 클릭하고 Unpack Instance Completely를 선택합니다.이렇게 하면 모든 템플릿 인스턴스가 일반 UXML 문서로 변경됩니다.

추가 리소스

요소를 사용한 작업
UI 빌더로 UI 스타일링