khi/XRLib
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

UTKPropertyTabListWindow 개발 완료

Browse Source
This commit is contained in:
logonkhi
2026-02-23 14:52:30 +09:00
parent 9d02afd8e8
commit 106e7f51be
9 changed files with 179 additions and 215 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
Assets/Scripts/UVC/UIToolkit/Property/Core/TabPropertyData.cs
View File

@@ -18,7 +18,7 @@ namespace UVC.UIToolkit
/// <summary>
/// 탭별 프로퍼티 설정 데이터 클래스입니다.
/// 탭의 메타데이터(이름, 아이콘, 활성화 상태)와
/// 탭의 메타데이터(이름, 활성화 상태)와
/// 해당 탭에 표시할 프로퍼티 데이터를 보유합니다.
/// </summary>
public class TabPropertyData
@@ -27,9 +27,6 @@ namespace UVC.UIToolkit
/// <summary>탭 이름 (표시 텍스트)</summary>
public string Name { get; set; } = string.Empty;
/// <summary>탭 아이콘 (Material Icon 유니코드, null이면 아이콘 없음)</summary>
public string? Icon { get; set; }
/// <summary>탭 활성화 상태</summary>
public bool IsEnabled { get; set; } = true;
@@ -52,12 +49,6 @@ namespace UVC.UIToolkit
{
Name = name;
}
/// <summary>아이콘 포함 생성자</summary>
public TabPropertyData(string name, string? icon) : this(name)
{
Icon = icon;
}
#endregion
#region Data Setters

248
Assets/Scripts/UVC/UIToolkit/Window/UTKPropertyTabListWindow.cs
View File

@@ -8,14 +8,14 @@ using UnityEngine.UIElements;
namespace UVC.UIToolkit
{
/// <summary>
/// UTKPropertyList와 UTKTabView를 결합한 탭 기반 프로퍼티 윈도우입니다.
/// 헤더(타이틀 + 닫기 버튼), 탭 뷰, 프로퍼티 리스트로 구성되며,
/// UTKPropertyList에 탭 기능을 결합한 프로퍼티 윈도우입니다.
/// 헤더(타이틀 + 닫기 버튼), 탭 버튼 영역, 프로퍼티 리스트로 구성되며,
/// 탭별로 서로 다른 프로퍼티 데이터를 설정할 수 있습니다.
///
/// <para><b>주요 기능:</b></para>
/// <list type="bullet">
/// <item>윈도우 프레임 (헤더, 타이틀, 닫기 버튼)</item>
/// <item>UTKTabView 기반 탭 전환</item>
/// <item>Button 기반 탭 전환 (UTKComponentTabListWindow와 동일 구조)</item>
/// <item>탭별 프로퍼티 데이터 관리 (Flat/Grouped/Mixed 지원)</item>
/// <item>탭별 검색어 저장/복원</item>
/// <item>선택적 "전체(All)" 탭</item>
@@ -28,16 +28,14 @@ namespace UVC.UIToolkit
/// window.ShowCloseButton = true;
/// window.ShowAllTab = false;
///
/// // 탭 데이터 설정
/// var generalTab = new TabPropertyData("일반");
/// generalTab.SetGroupedData(new List&lt;IUTKPropertyGroup&gt; { transformGroup, renderGroup });
///
/// var advancedTab = new TabPropertyData("고급", "\ue8b8");
/// var advancedTab = new TabPropertyData("고급");
/// advancedTab.SetFlatData(new List&lt;IUTKPropertyItem&gt; { debugItem, logItem });
///
/// window.SetTabData(new List&lt;TabPropertyData&gt; { generalTab, advancedTab });
///
/// // 이벤트 구독
/// window.OnTabChanged += (index, data) =&gt; Debug.Log($"탭 변경: {data?.Name}");
/// window.OnPropertyValueChanged += args =&gt; Debug.Log($"{args.PropertyId} = {args.NewValue}");
///
@@ -58,15 +56,18 @@ namespace UVC.UIToolkit
// UI 요소 참조
private VisualElement? _header;
private UTKLabel? _titleLabel;
private Label? _titleLabel;
private UTKButton? _closeButton;
private UTKTabView? _tabView;
private VisualElement? _tabContainer;
private UTKPropertyList? _propertyList;
// 탭 버튼
private readonly List<Button> _tabButtons = new();
// 탭 데이터
private readonly List<TabPropertyData> _tabDataList = new();
private int _selectedTabIndex = ALL_TAB_INDEX;
private bool _showAllTab = true;
private bool _showAllTab = false;
// 탭별 검색어 저장
private readonly Dictionary<int, string> _tabSearchQueries = new();
@@ -78,7 +79,7 @@ namespace UVC.UIToolkit
// 윈도우 속성
private string _title = "Properties";
private bool _showCloseButton = false;
private bool _showCloseButton;
#endregion
#region Properties
@@ -91,9 +92,7 @@ namespace UVC.UIToolkit
{
_title = value;
if (_titleLabel != null)
{
_titleLabel.Text = value;
}
_titleLabel.text = value;
}
}
@@ -106,9 +105,7 @@ namespace UVC.UIToolkit
{
_showCloseButton = value;
if (_closeButton != null)
{
_closeButton.style.display = value ? DisplayStyle.Flex : DisplayStyle.None;
}
}
}
@@ -134,9 +131,6 @@ namespace UVC.UIToolkit
/// <summary>내부 UTKPropertyList 접근</summary>
public UTKPropertyList PropertyList => _propertyList ??= new UTKPropertyList();
/// <summary>내부 UTKTabView 접근</summary>
public UTKTabView? TabView => _tabView;
#endregion
#region Events
@@ -183,9 +177,7 @@ namespace UVC.UIToolkit
var styleSheet = Resources.Load<StyleSheet>(USS_PATH);
if (styleSheet != null)
{
styleSheets.Add(styleSheet);
}
CreateUI();
}
@@ -208,13 +200,9 @@ namespace UVC.UIToolkit
var asset = Resources.Load<VisualTreeAsset>(UXML_PATH);
if (asset != null)
{
CreateUIFromUxml(asset);
}
else
{
CreateUIFallback();
}
// 드래그 이벤트
if (_header != null)
@@ -223,25 +211,17 @@ namespace UVC.UIToolkit
_header.RegisterCallback<PointerMoveEvent>(OnHeaderPointerMove);
_header.RegisterCallback<PointerUpEvent>(OnHeaderPointerUp);
}
// UTKTabView 탭 변경 이벤트 구독
if (_tabView != null)
{
_tabView.OnTabChanged += OnTabViewTabChanged;
}
}
private void CreateUIFromUxml(VisualTreeAsset asset)
{
var root = asset.Instantiate();
var windowRoot = root.Q<VisualElement>("window-root");
var container = root.Q<VisualElement>("container");
if (windowRoot != null)
if (container != null)
{
foreach (var child in windowRoot.Children().ToArray())
{
foreach (var child in container.Children().ToArray())
Add(child);
}
}
else
{
@@ -250,17 +230,14 @@ namespace UVC.UIToolkit
// 요소 참조 가져오기
_header = this.Q<VisualElement>("header");
_titleLabel = this.Q<UTKLabel>("title");
_titleLabel = this.Q<Label>("title");
_closeButton = this.Q<UTKButton>("close-btn");
_tabView = this.Q<UTKTabView>("tab-view");
_propertyList = this.Q<UTKPropertyList>("content");
_tabContainer = this.Q<VisualElement>("tab-container");
_propertyList = this.Q<UTKPropertyList>();
// 타이틀 설정
if (_titleLabel != null)
{
_titleLabel.Text = _title;
_titleLabel.Size = UTKLabel.LabelSize.Label3;
}
_titleLabel.text = _title;
// 닫기 버튼 설정
if (_closeButton != null)
@@ -271,21 +248,31 @@ namespace UVC.UIToolkit
_closeButton.style.display = _showCloseButton ? DisplayStyle.Flex : DisplayStyle.None;
}
// TabView가 없으면 생성
if (_tabView == null)
// tabContainer가 없으면 생성
if (_tabContainer == null)
{
_tabView = new UTKTabView();
_tabView.name = "tab-view";
_tabView.AddToClassList("utk-property-tab-window__tab-view");
var scrollView = new ScrollView(ScrollViewMode.Horizontal);
scrollView.horizontalScrollerVisibility = ScrollerVisibility.Hidden;
scrollView.verticalScrollerVisibility = ScrollerVisibility.Hidden;
scrollView.style.flexShrink = 0;
scrollView.style.marginBottom = 8;
scrollView.style.maxHeight = 28;
_tabContainer = new VisualElement();
_tabContainer.name = "tab-container";
_tabContainer.style.flexDirection = FlexDirection.Row;
_tabContainer.style.flexShrink = 0;
scrollView.Add(_tabContainer);
// PropertyList 앞에 삽입
if (_propertyList != null)
{
int index = IndexOf(_propertyList);
Insert(index, _tabView);
Insert(index, scrollView);
}
else
{
Add(_tabView);
Add(scrollView);
}
}
@@ -293,8 +280,8 @@ namespace UVC.UIToolkit
if (_propertyList == null)
{
_propertyList = new UTKPropertyList();
_propertyList.name = "content";
_propertyList.AddToClassList("utk-property-tab-window__content");
_propertyList.style.flexGrow = 1;
_propertyList.style.width = Length.Percent(100);
Add(_propertyList);
}
}
@@ -306,7 +293,7 @@ namespace UVC.UIToolkit
_header.name = "header";
_header.AddToClassList("utk-property-tab-window__header");
_titleLabel = new UTKLabel(_title, UTKLabel.LabelSize.Label3);
_titleLabel = new Label(_title);
_titleLabel.name = "title";
_titleLabel.AddToClassList("utk-property-tab-window__title");
_header.Add(_titleLabel);
@@ -321,16 +308,26 @@ namespace UVC.UIToolkit
Add(_header);
// 탭 뷰
_tabView = new UTKTabView();
_tabView.name = "tab-view";
_tabView.AddToClassList("utk-property-tab-window__tab-view");
Add(_tabView);
// 탭 스크롤 영역
var scrollView = new ScrollView(ScrollViewMode.Horizontal);
scrollView.horizontalScrollerVisibility = ScrollerVisibility.Hidden;
scrollView.verticalScrollerVisibility = ScrollerVisibility.Hidden;
scrollView.style.flexShrink = 0;
scrollView.style.marginBottom = 8;
scrollView.style.maxHeight = 28;
_tabContainer = new VisualElement();
_tabContainer.name = "tab-container";
_tabContainer.style.flexDirection = FlexDirection.Row;
_tabContainer.style.flexShrink = 0;
scrollView.Add(_tabContainer);
Add(scrollView);
// PropertyList
_propertyList = new UTKPropertyList();
_propertyList.name = "content";
_propertyList.AddToClassList("utk-property-tab-window__content");
_propertyList.style.flexGrow = 1;
_propertyList.style.width = Length.Percent(100);
Add(_propertyList);
}
#endregion
@@ -341,7 +338,6 @@ namespace UVC.UIToolkit
/// 탭 데이터 목록을 설정합니다.
/// 기존 탭을 모두 제거하고 새로운 탭을 생성합니다.
/// </summary>
/// <param name="tabDataList">탭 설정 데이터 목록</param>
public void SetTabData(List<TabPropertyData> tabDataList)
{
_tabDataList.Clear();
@@ -357,20 +353,14 @@ namespace UVC.UIToolkit
SelectTab(0);
}
/// <summary>
/// 탭 데이터를 추가합니다.
/// </summary>
/// <param name="tabData">추가할 탭 데이터</param>
/// <summary>탭 데이터를 추가합니다.</summary>
public void AddTabData(TabPropertyData tabData)
{
_tabDataList.Add(tabData);
RebuildTabs();
}
/// <summary>
/// 특정 인덱스의 탭 데이터를 제거합니다.
/// </summary>
/// <param name="index">제거할 탭 인덱스 (0-based)</param>
/// <summary>특정 인덱스의 탭 데이터를 제거합니다.</summary>
public void RemoveTabData(int index)
{
if (index < 0 || index >= _tabDataList.Count) return;
@@ -379,23 +369,13 @@ namespace UVC.UIToolkit
_tabSearchQueries.Remove(index);
RebuildTabs();
// 현재 선택된 탭이 제거된 경우 기본 탭 선택
if (_selectedTabIndex == index)
{
SelectTab(_showAllTab ? ALL_TAB_INDEX : 0);
}
else if (_selectedTabIndex > index)
{
// 인덱스 보정
_selectedTabIndex--;
}
}
/// <summary>
/// 특정 인덱스의 탭 데이터를 반환합니다.
/// </summary>
/// <param name="index">탭 인덱스 (0-based)</param>
/// <returns>탭 데이터 또는 null</returns>
/// <summary>특정 인덱스의 탭 데이터를 반환합니다.</summary>
public TabPropertyData? GetTabData(int index)
{
if (index >= 0 && index < _tabDataList.Count)
@@ -421,8 +401,8 @@ namespace UVC.UIToolkit
// 2. 탭 인덱스 변경
_selectedTabIndex = tabIndex;
// 3. UTKTabView 선택 동기화
SyncTabViewSelection(tabIndex);
// 3. 탭 선택 스타일 업데이트
UpdateTabStyles();
// 4. 데이터 로드
LoadDataForTab(tabIndex);
@@ -437,9 +417,7 @@ namespace UVC.UIToolkit
OnTabChanged?.Invoke(tabIndex, tabData);
}
/// <summary>
/// 현재 선택된 탭의 데이터를 다시 로드합니다.
/// </summary>
/// <summary>현재 선택된 탭의 데이터를 다시 로드합니다.</summary>
public void RefreshCurrentTab()
{
LoadDataForTab(_selectedTabIndex);
@@ -559,79 +537,68 @@ namespace UVC.UIToolkit
#region Private Methods - Tab Management
/// <summary>
/// UTKTabView에 탭을 재구성합니다.
/// 탭 버튼을 재구성합니다.
/// UTKComponentTabListWindow와 동일한 Button 기반 방식입니다.
/// </summary>
private void RebuildTabs()
{
if (_tabView == null) return;
if (_tabContainer == null) return;
// 이벤트 일시 해제 (재구성 중 탭 변경 이벤트 방지)
_tabView.OnTabChanged -= OnTabViewTabChanged;
_tabView.ClearTabs();
// 기존 탭 버튼 제거
_tabContainer.Clear();
_tabButtons.Clear();
// "All" 탭 생성 (옵션)
if (_showAllTab)
{
_tabView.AddUTKTab("All");
var allTab = CreateTabButton("All", ALL_TAB_INDEX);
_tabButtons.Add(allTab);
_tabContainer.Add(allTab);
}
// 개별 탭 생성
for (int i = 0; i < _tabDataList.Count; i++)
{
var data = _tabDataList[i];
var tabName = data.Name;
// 아이콘이 있으면 탭 이름 앞에 추가
if (!string.IsNullOrEmpty(data.Icon))
{
tabName = $"{data.Icon} {data.Name}";
}
var tab = _tabView.AddUTKTab(tabName);
tab.IsEnabled = data.IsEnabled;
var tab = CreateTabButton(data.Name, i);
tab.SetEnabled(data.IsEnabled);
if (!string.IsNullOrEmpty(data.Tooltip))
{
tab.tooltip = data.Tooltip;
}
_tabButtons.Add(tab);
_tabContainer.Add(tab);
}
// 이벤트 재구독
_tabView.OnTabChanged += OnTabViewTabChanged;
}
/// <summary>
/// UTKTabView의 선택 상태를 동기화합니다.
/// 탭 버튼을 생성합니다.
/// </summary>
private void SyncTabViewSelection(int tabIndex)
private Button CreateTabButton(string label, int index)
{
if (_tabView == null) return;
int viewIndex;
if (_showAllTab)
viewIndex = tabIndex == ALL_TAB_INDEX ? 0 : tabIndex + 1;
else
viewIndex = tabIndex;
if (viewIndex >= 0 && viewIndex < _tabView.UTKTabs.Count)
_tabView.SelectedIndex = viewIndex;
var button = new Button(() => SelectTab(index))
{
text = label
};
button.AddToClassList("tab-button");
return button;
}
/// <summary>
/// UTKTabView에서 탭 변경 이벤트 발생 시 처리
/// 탭 선택 스타일을 업데이트합니다.
/// </summary>
private void OnTabViewTabChanged(int viewIndex, Tab? tab)
private void UpdateTabStyles()
{
int dataIndex;
if (_showAllTab)
dataIndex = viewIndex == 0 ? ALL_TAB_INDEX : viewIndex - 1;
else
dataIndex = viewIndex;
for (int i = 0; i < _tabButtons.Count; i++)
{
var btn = _tabButtons[i];
int tabIndex = _showAllTab ? (i == 0 ? ALL_TAB_INDEX : i - 1) : i;
// 이미 선택된 탭이면 무시
if (dataIndex == _selectedTabIndex) return;
SelectTab(dataIndex);
if (tabIndex == _selectedTabIndex)
btn.AddToClassList("tab-button-selected");
else
btn.RemoveFromClassList("tab-button-selected");
}
}
/// <summary>
@@ -642,13 +609,9 @@ namespace UVC.UIToolkit
if (_propertyList == null) return;
if (tabIndex == ALL_TAB_INDEX)
{
LoadAllTabData();
}
else if (tabIndex >= 0 && tabIndex < _tabDataList.Count)
{
LoadSingleTabData(_tabDataList[tabIndex]);
}
}
/// <summary>
@@ -688,7 +651,6 @@ namespace UVC.UIToolkit
/// <summary>
/// 모든 탭의 데이터를 병합하여 UTKPropertyList에 로드합니다.
/// 병합 전략: Mixed 방식으로 통합 (IUTKPropertyEntry 리스트로 변환)
/// </summary>
private void LoadAllTabData()
{
@@ -721,9 +683,7 @@ namespace UVC.UIToolkit
case TabPropertyDataType.Mixed:
var mixedItems = tabData.GetMixedData();
if (mixedItems != null)
{
allEntries.AddRange(mixedItems);
}
break;
}
}
@@ -737,9 +697,7 @@ namespace UVC.UIToolkit
#region Private Methods - Search Persistence
/// <summary>
/// 현재 탭의 검색어를 저장합니다.
/// </summary>
/// <summary>현재 탭의 검색어를 저장합니다.</summary>
private void SaveCurrentSearchQuery()
{
if (_propertyList == null) return;
@@ -751,9 +709,7 @@ namespace UVC.UIToolkit
_tabSearchQueries.Remove(_selectedTabIndex);
}
/// <summary>
/// 지정된 탭의 저장된 검색어를 복원합니다.
/// </summary>
/// <summary>지정된 탭의 저장된 검색어를 복원합니다.</summary>
private void RestoreSearchQuery(int tabIndex)
{
if (_propertyList == null) return;
@@ -841,13 +797,6 @@ namespace UVC.UIToolkit
_header.UnregisterCallback<PointerUpEvent>(OnHeaderPointerUp);
}
// TabView 이벤트 해제 및 정리
if (_tabView != null)
{
_tabView.OnTabChanged -= OnTabViewTabChanged;
_tabView.Dispose();
}
// PropertyList 정리
_propertyList?.Dispose();
_propertyList = null;
@@ -859,12 +808,13 @@ namespace UVC.UIToolkit
// 데이터 정리
_tabDataList.Clear();
_tabSearchQueries.Clear();
_tabButtons.Clear();
// UI 참조 정리
_header = null;
_titleLabel = null;
_closeButton = null;
_tabView = null;
_tabContainer = null;
}
#endregion
}