Unity UI Toolkit: UXML 요소 Scroller
이 문서는 Unity의 UI Toolkit에서 제공하는 UXML 요소 중 Scroller에 대한 설명입니다. Scroller는 사용자 인터페이스에 스크롤 가능한 요소를 만들고 관리하는 데 사용됩니다. 아래에 Scroller의 기본 아키텍처와 주요 속성을 정리했습니다.
기본 정보
- 네임스페이스: UnityEngine.UIElements
- 기본 클래스: VisualElement
Scroller의 주요 속성
Scroller 요소는 다음과 같은 속성을 가지고 있습니다:
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| direction | UIElements.SliderDirection | 스크롤바의 방향 (가로 또는 세로) |
| high-value | float | 스크롤의 최대값 |
| low-value | float | 스크롤의 최소값 |
| value | float | 현재 슬라이더의 포지션을 정의하는 값 |
사용자 정의 속성
Scroller는 VisualElement의 일부로서 다음과 같은 속성을 상속합니다:
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| focusable | boolean | 요소에 포커스를 맞출 수 있는지 여부 |
| tabindex | int | 포커스를 맞출 항목의 순서를 지정 |
| content-container | string | 자식 요소가 추가될 요소의 이름 |
| name | string | VisualElement의 고유 이름 |
| picking-mode | UIElements.PickingMode | 요소 선택 가능성을 결정 |
| style | string | 요소의 스타일 오브젝트에 대한 참조 |
| tooltip | string | 마우스 오버 시 표시되는 정보 박스의 텍스트 |
| usage-hints | UIElements.UsageHints | VisualElement에 대한 사용 패턴을 지정 |
| view-data-key | string | 보기 데이터 저장 시 사용하는 키 |
USS 클래스
C# 프로퍼티와 관련된 USS 선택자는 다음과 같습니다:
| C# 프로퍼티 | USS 선택자 | 설명 |
|---|---|---|
| ussClassName | .unity-scroller | Scroller 타입 요소의 USS 클래스명 |
| horizontalVariant | .unity-scroller--horizontal | 가로 모드 스크롤러의 USS 클래스명 |
| verticalVariant | .unity-scroller--vertical | 세로 모드 스크롤러의 USS 클래스명 |
| slider | .unity-scroller__slider | 슬라이더 요소의 USS 클래스명 |
| lowButton | .unity-scroller__low-button | 아래 버튼의 USS 클래스명 |
| highButton | .unity-scroller__high-button | 위 버튼의 USS 클래스명 |
| disabled | .unity-disabled | 비활성화된 요소의 USS 클래스명 |
활용 예제
Scroller 요소 사용 예제
using UnityEngine;
using UnityEngine.UIElements;
public class ScrollerExample : MonoBehaviour
{
private ScrollView scrollView;
void Start()
{
// ScrollView 인스턴스 생성
scrollView = new ScrollView();
scrollView.direction = ScrollView.Direction.Vertical;
scrollView.highValue = 100;
scrollView.lowValue = 0;
scrollView.value = 50;
// ScrollView 추가
var uiDocument = GetComponent<UIDocument>();
uiDocument.rootVisualElement.Add(scrollView);
}
}
Scroller와 다른 UI 요소 결합
Scroller는 다양한 UI 요소와 결합하여 복잡한 사용자 인터페이스를 만드는 데 도움을 줍니다. 예를 들어, 스크롤 가능한 목록을 만들거나 이미지 갤러리를 구현하는 데 사용할 수 있습니다.
마무리
Unity의 UI Toolkit 내 Scroller 요소는 사용자 인터페이스에서 스크롤 가능한 인터랙션을 가능하게 하는 강력한 툴입니다. 이 문서를 통해 기본적인 사용법과 구성 요소들을 이해하고, 자신만의 UI를 구축하는 데 도움이 되길 바랍니다.