Load UXML and USS C# scripts

Unity represents UXML files as VisualTreeAsset objects in C# and represents USS files as StyleSheet objects in C#. Since VisualTreeAsset and StyleSheet are regular Unity assets, you can use Unity’s standard workflows to load them.

직렬화 레퍼런스 사용

Unity automatically detects fields from your C# scripts that are of type VisualTreeAsset or StyleSheet. You can use the Inspector to set references to specific UXML or USS files imported into your project. Such references remain valid even when the location of your assets changes in your project.

스크립트에서 이를 사용하는 세 가지 방법이 있습니다.

Note: The default references work for all scripts that derive from MonoBehaviour or ScriptableObject. It provides a way to populate default values for serialized fields of scripts.

다음 예시 MonoBehaviour 클래스는 인스펙터에서 UXML 파일과 USS 파일 리스트를 수신합니다.

using UnityEngine;
using UnityEngine.UIElements;

public class MyBehaviour : MonoBehaviour
{
  // Note that public fields are automatically exposed in the Inspector
  public VisualTreeAsset mainUI;
  [Reorderable]
  public StyleSheet[] seasonalThemes;
}

다음 예시 EditorWindow 클래스는 인스펙터에서 기본 레퍼런스를 수신합니다.

using UnityEditor;
using UnityEngine.UIElements;

public class MyWindow : EditorWindow
{
  [SerializeField]
  private VisualTreeAsset uxml;
  [SerializeField]
  private StyleSheet uss;
}

에셋 데이터베이스 사용(에디터 전용)

AssetDatabase 클래스를 사용하여 경로 또는 GUID별로 UI 에셋을 로드할 수 있습니다.

다음 예시는 경로로 에셋을 찾는 방법을 나타냅니다.

VisualTreeAsset uxml = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("Assets/Editor/main_window.uxml");
StyleSheet uss = AssetDatabase.LoadAssetAtPath<StyleSheet>("Assets/Editor/main_styles.uss");

The following example shows how to locate an asset by path from a package:

VisualTreeAsset uxml = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("Packages/<name-of-the-package>/main_window.uxml");
StyleSheet uss = AssetDatabase.LoadAssetAtPath<StyleSheet>("Packages/<name-of-the-package>/main_styles.uss");

Use Addressables (Runtime only)

어드레서블 시스템은 애플리케이션의 콘텐츠를 구성하고 패키징하기 위한 툴과 스크립트를 제공하며 런타임 시 에셋을 로드하고 해제하는 API를 제공합니다.

어드레서블 시스템에서 UXML과 USS 에셋을 사용할 수 있습니다.

Unity에서 에셋에 대해 어드레서블을 설정하는 방법에 대한 자세한 내용은 어드레서블 시작하기를 참조하십시오.

리소스 폴더 사용

If you add a Resources folder in your project and place your UI assets in it, you can use the Resources.Load method to load your assets.

The following example shows how to load an asset in the Resources folder:

VisualTreeAsset uxml = Resources.Load<VisualTreeAsset>("main_window");
StyleSheet uss = Resources.Load<StyleSheet>("main_styles");

Note: This method increases the final build size significantly. If you are concerned with the build size, use Addressables instead.

추가 리소스

• The Resources folder
• Assets, Resources and AssetBundles