UnityUI와 연출

UI Toolkit 기본: Visual Tree, UXML, USS

UI Toolkit의 핵심 구조인 `VisualElement`, visual tree, UXML, USS, UI Builder 관계를 한 카드로 정리합니다.

마지막 수정 2026년 3월 22일

기본 패턴

text
UXML -> 구조
USS -> 스타일
C# -> 로직과 이벤트 연결

설명

  • UI Toolkit은 Unity의 최신 보류형(retained mode) UI 시스템입니다. 핵심 감각은 웹과 비슷합니다. 구조는 UXML, 스타일은 USS, 동작은 C#으로 나누어 관리합니다.
  • VisualElement는 모든 UI 요소의 기반이고, 이 요소들이 부모-자식 관계로 묶인 계층이 visual tree입니다. 즉 UI Toolkit에서는 화면을 "오브젝트 배치"보다 "트리 구조"로 보는 감각이 중요합니다.
  • UXML은 어떤 요소가 어떤 계층으로 놓이는지를 정의하고, USS는 그 요소가 어떻게 보이는지를 정의합니다. C#은 버튼 클릭, 데이터 바인딩, 동적 생성 같은 동작을 연결합니다.
  • UI Builder는 이 구조를 시각적으로 만들고 편집하는 툴입니다. 하지만 Builder는 편집 도구일 뿐이고, 실제 모델은 여전히 visual tree와 stylesheet에 있습니다.
  • 그래서 UI Toolkit을 잘 쓰려면 "좌표로 찍는 UI"에서 "트리와 스타일로 조합하는 UI"로 사고를 바꾸는 것이 중요합니다.

빠른 정리

요소역할
VisualElement모든 UI 요소의 기반 클래스
visual treeUI 계층 구조
UXML구조 정의
USS스타일 정의
UI BuilderUXML/USS를 시각적으로 편집하는 도구

주의할 점

UI Toolkit을 uGUI처럼 좌표 중심으로 다루기 시작하면 장점이 줄어듭니다. 구조, 스타일, 로직을 분리하는 사고방식으로 접근해야 유지보수성이 살아납니다.

참고 링크

3 sources