Version: 2023.2
언어: 한국어
UXML 소개
UXML 파일 재사용

UXML에 스타일 추가

UI 툴킷에서는 USS를 사용하여 시각적 요소의 모양을 커스터마이즈할 수 있습니다.USS에 대한 권장 워크플로는 UI 빌더에서 요소의 스타일을 시각적으로 지정하고, 해당 스타일을 USS 파일로 추출한 다음, UXML에서 참조하는 것입니다.

UI 빌더에서 요소에 스타일을 지정하면 해당 스타일이 UXML 요소의 style 속성에 인라인 스타일로 추가됩니다.

<ui:UXML ...>
    <ui:VisualElement style="width: 200px; height: 200px; background-color: red;" />
</ui:UXML>

스타일시트 파일을 참조하려면 UXML 파일의 루트 요소 아래에 <Style> 요소를 추가합니다.

예를 들어 다음 내용을 포함한 styles.uss라는 이름의 USS 파일이 있다고 가정해 보겠습니다.

# root {
    width: 200px;
    height: 200px;
    background-color: red;
}

다음과 같이 참조할 수 있습니다.

<ui:UXML ...>
    <Style src="<path-to-file>/styles.uss" />
    <ui:VisualElement name="root" />
</ui:UXML>

상대 경로나 절대 경로를 사용할 수 있습니다.

  • 절대 경로는 프로젝트의 Assets 폴더에서 시작하며 / 또는 project://database/로 시작합니다. 예를 들면 /Assets/myFolder/myFile.uss 또는 project://database/Assets/myFolder/myFile.uss입니다.
  • 상대 경로는 현재 파일에서 시작하고 /를 제외합니다. 예를 들면 ../myFolder/myFile.uss입니다.

참고: 패키지에서 파일을 참조하려면 Packages 폴더에서 시작하는 패키지 파일의 절대 경로를 사용합니다. 예를 들어 /Packages/com.unity.package.name/file-name.uss 또는 project://database/Packages/com.unity.package.name/file-name.uss와 같이 패키지 이름에 package name이 아닌 com.unity.package.name 형식을 사용해야 합니다.

추가 리소스

UXML 소개
UXML 파일 재사용