Unity 사용자 매뉴얼 요약 (2022.3 LTS)
개요
이 문서는 Unity의 사용자 인터페이스(UI) 생성 및 데이터 지속성 관련 기능을 소개합니다. 특히, 에디터 UI에서 활성화되는 보기 데이터 지속성에 대해 설명합니다.
보기 데이터 지속성
보기 데이터 지속성은 UI의 시각적 요소와 연결된 데이터를 보존하는 기능입니다. 이는 UI의 기본 데이터 모델에 포함되지 않은 상태를 참조합니다. 예를 들어, 스크롤 바의 위치나 리스트에서 선택된 항목이 이에 해당합니다.
언제 발생하나요?
보기 데이터 지속성은 다음과 같은 상황에서 데이터 문제를 해결합니다. - 플레이 모드 전환 - 스크립트 변경 시 - 에디터 레이아웃 변경 (창 닫기/열기) - 에디터 재시작
주의 사항
- 보기 데이터 지속성은 오직 에디터 UI에서만 작동합니다.
- 보기 데이터를 활성화하기 위해서는 요소 내에 고유한 보기 데이터 키를 설정해야 합니다.
보기 데이터 키 설정 방법
UI 빌더
- 요소의 인스펙터 패널의 Attributes 섹션 내 View Data Key 필드에 설정
UXML
view-data-key
속성을 통해 설정
C
viewDataKey
프로퍼티를 통해 설정
지원되는 UI 요소
다음 요소는 현재 보기 데이터 지속성을 지원합니다: - ScrollView
: 스크롤 위치 기억 - ListView
: 선택 항목 기억 - Foldout
: 확장 상태 기억 - TreeView
: 선택 항목 기억
읽기 전용 요소
읽기 전용 요소에 대한 보기 데이터 지속성을 활성화하려면 부모 요소에서 보기 데이터 키를 설정해야 합니다. 예를 들어, ScrollView의 자식 Scroller에게 고유한 보기 데이터 키를 주더라도, 부모 ScrollView에 키를 설정하지 않으면 데이터는 지속되지 않습니다.
제한 사항
현재 API는 커스텀 컨트롤의 보기 데이터 지속성을 지원하지 않습니다. 이는 내부 기능으로만 사용할 수 있습니다.
추후 참고 자료
추가 활용 예제
- ScrollView 사용 예제
- 스크롤 위치를 저장하고 복원하는 스크립트 작성 예제
- ListView 활용 예제
- 선택된 항목의 상태를 확인하고 업데이트하기 위한 코드 샘플
이 요약을 참고하여 Unity에서 데이터 지속성을 효과적으로 활용하여 사용자 인터페이스를 개발해 보세요!