UTKAccodion 완료. UTKComponentList 수정 중
This commit is contained in:
logonkhi
@@ -14,17 +14,119 @@ namespace UVC.UIToolkit
|
||||
/// 윈도우 형태의 컴포넌트입니다. 모든 트리 관련 기능은 내부 UTKComponentList에 위임됩니다.
|
||||
/// </para>
|
||||
///
|
||||
/// <para><b>UXML에서 사용:</b></para>
|
||||
/// <code>
|
||||
/// <UVC.UIToolkit.Window.UTKComponentListWindow name="tree-list-window" />
|
||||
/// </code>
|
||||
/// <para><b>UXML 사용 예시:</b></para>
|
||||
/// <code><![CDATA[
|
||||
/// <!-- UXML 파일에서 UTKComponentListWindow 사용 -->
|
||||
/// <ui:UXML xmlns:utk="UVC.UIToolkit">
|
||||
/// <utk:UTKComponentListWindow name="component-window" />
|
||||
/// </ui:UXML>
|
||||
/// ]]></code>
|
||||
///
|
||||
/// <para><b>코드에서 사용:</b></para>
|
||||
/// <code>
|
||||
/// var window = root.Q<UTKComponentListWindow>();
|
||||
/// window.OnItemSelected += (items) => Debug.Log($"선택: {items[0].name}");
|
||||
/// window.SetData(treeItems);
|
||||
/// </code>
|
||||
/// <para><b>C# 사용 예시:</b></para>
|
||||
/// <code><![CDATA[
|
||||
/// // 1. 윈도우 참조 획득
|
||||
/// var componentWindow = root.Q<UTKComponentListWindow>("component-window");
|
||||
///
|
||||
/// // 2. 윈도우 제목 및 닫기 버튼 설정
|
||||
/// componentWindow.Title = "모델 리스트";
|
||||
/// componentWindow.ShowCloseButton = true;
|
||||
///
|
||||
/// // 3. 데이터 구성 - 카테고리와 아이템
|
||||
/// var data = new List<UTKComponentListItemDataBase>
|
||||
/// {
|
||||
/// new UTKComponentListCategoryData
|
||||
/// {
|
||||
/// name = "캐릭터",
|
||||
/// isExpanded = true,
|
||||
/// children = new List<UTKComponentListItemDataBase>
|
||||
/// {
|
||||
/// new UTKComponentListItemData
|
||||
/// {
|
||||
/// name = "플레이어",
|
||||
/// ExternalKey = "player_001",
|
||||
/// IsVisible = true
|
||||
/// },
|
||||
/// new UTKComponentListItemData
|
||||
/// {
|
||||
/// name = "NPC",
|
||||
/// ExternalKey = "npc_001",
|
||||
/// IsVisible = true
|
||||
/// }
|
||||
/// }
|
||||
/// }
|
||||
/// };
|
||||
/// componentWindow.SetData(data);
|
||||
///
|
||||
/// // 4. 선택 이벤트 구독
|
||||
/// componentWindow.OnItemSelected = (selectedItems) =>
|
||||
/// {
|
||||
/// foreach (var item in selectedItems)
|
||||
/// {
|
||||
/// Debug.Log($"선택됨: {item.name}");
|
||||
/// // 3D 뷰에서 해당 모델 하이라이트
|
||||
/// HighlightModel(item.ExternalKey);
|
||||
/// }
|
||||
/// };
|
||||
///
|
||||
/// // 5. 선택 해제 이벤트
|
||||
/// componentWindow.OnItemDeselected = (deselectedItems) =>
|
||||
/// {
|
||||
/// foreach (var item in deselectedItems)
|
||||
/// {
|
||||
/// UnhighlightModel(item.ExternalKey);
|
||||
/// }
|
||||
/// };
|
||||
///
|
||||
/// // 6. 가시성 변경 이벤트 (눈 아이콘)
|
||||
/// componentWindow.OnItemVisibilityChanged += (item, isVisible) =>
|
||||
/// {
|
||||
/// var gameObject = FindGameObjectByKey(item.ExternalKey);
|
||||
/// if (gameObject != null)
|
||||
/// {
|
||||
/// gameObject.SetActive(isVisible);
|
||||
/// }
|
||||
/// };
|
||||
///
|
||||
/// // 7. 삭제 이벤트 (Delete/Backspace 키)
|
||||
/// componentWindow.EnabledDeleteItem = true;
|
||||
/// componentWindow.OnItemDeleted = (item) =>
|
||||
/// {
|
||||
/// Debug.Log($"삭제 요청: {item.name}");
|
||||
/// componentWindow.DeleteItem(item);
|
||||
/// };
|
||||
///
|
||||
/// // 8. 더블클릭 이벤트
|
||||
/// componentWindow.OnItemDoubleClicked = (item) =>
|
||||
/// {
|
||||
/// // 카메라 포커스
|
||||
/// FocusCameraOn(item.ExternalKey);
|
||||
/// };
|
||||
///
|
||||
/// // 9. 윈도우 닫힘 이벤트
|
||||
/// componentWindow.OnClosed += () =>
|
||||
/// {
|
||||
/// Debug.Log("윈도우가 닫혔습니다.");
|
||||
/// };
|
||||
///
|
||||
/// // 10. 프로그래밍 방식 선택
|
||||
/// componentWindow.SelectItem("플레이어", notify: true);
|
||||
/// componentWindow.DeselectItem("플레이어", notify: false);
|
||||
/// componentWindow.ClearSelection();
|
||||
/// componentWindow.SelectByItemId(itemId);
|
||||
///
|
||||
/// // 11. 아이템 추가/삭제
|
||||
/// var newItem = new UTKComponentListItemData { name = "새 캐릭터" };
|
||||
/// componentWindow.AddItem(newItem);
|
||||
/// componentWindow.AddItem(categoryData, newItem);
|
||||
/// componentWindow.DeleteItem(newItem);
|
||||
/// componentWindow.SetItemName(newItem, "수정된 이름");
|
||||
///
|
||||
/// // 12. 윈도우 표시
|
||||
/// componentWindow.Show();
|
||||
///
|
||||
/// // 13. 리소스 해제 (OnDestroy에서 호출)
|
||||
/// componentWindow.Dispose();
|
||||
/// ]]></code>
|
||||
/// </summary>
|
||||
[UxmlElement]
|
||||
public partial class UTKComponentListWindow : VisualElement, IDisposable
|
||||
@@ -36,14 +138,20 @@ namespace UVC.UIToolkit
|
||||
#region 상수 (Constants)
|
||||
/// <summary>메인 UXML 파일 경로 (Resources 폴더 기준)</summary>
|
||||
private const string UXML_PATH = "UIToolkit/Window/UTKComponentListWindow";
|
||||
|
||||
/// <summary>USS 파일 경로 (Resources 폴더 기준)</summary>
|
||||
private const string USS_PATH = "UIToolkit/Window/UTKComponentListWindowUss";
|
||||
#endregion
|
||||
|
||||
#region UI 컴포넌트 참조 (UI Component References)
|
||||
/// <summary>내부 UTKComponentList 컴포넌트</summary>
|
||||
private UTKComponentList? _componentList;
|
||||
|
||||
/// <summary>트리 리스트 닫기 버튼</summary>
|
||||
private Button? _closeButton;
|
||||
/// <summary>트리 리스트 닫기 버튼 (UTKButton)</summary>
|
||||
private UTKButton? _closeButton;
|
||||
|
||||
/// <summary>윈도우 제목 라벨</summary>
|
||||
private Label? _titleLabel;
|
||||
#endregion
|
||||
|
||||
#region 공개 속성 (Public Properties)
|
||||
@@ -57,6 +165,20 @@ namespace UVC.UIToolkit
|
||||
get => _componentList?.EnabledDeleteItem ?? false;
|
||||
set { if (_componentList != null) _componentList.EnabledDeleteItem = value; }
|
||||
}
|
||||
|
||||
/// <summary>윈도우 제목을 가져오거나 설정합니다.</summary>
|
||||
public string Title
|
||||
{
|
||||
get => _titleLabel?.text ?? string.Empty;
|
||||
set { if (_titleLabel != null) _titleLabel.text = value; }
|
||||
}
|
||||
|
||||
/// <summary>닫기 버튼 표시 여부를 설정합니다.</summary>
|
||||
public bool ShowCloseButton
|
||||
{
|
||||
get => _closeButton?.style.display == DisplayStyle.Flex;
|
||||
set { if (_closeButton != null) _closeButton.style.display = value ? DisplayStyle.Flex : DisplayStyle.None; }
|
||||
}
|
||||
#endregion
|
||||
|
||||
#region 외부 이벤트 (Public Events)
|
||||
@@ -145,17 +267,35 @@ namespace UVC.UIToolkit
|
||||
return;
|
||||
}
|
||||
|
||||
// 3. 닫기 버튼 찾기 및 이벤트 연결
|
||||
_closeButton = this.Q<Button>("close-btn");
|
||||
// 3. 테마 적용 및 변경 구독
|
||||
UTKThemeManager.Instance.ApplyThemeToElement(this);
|
||||
SubscribeToThemeChanges();
|
||||
|
||||
// USS 로드 (테마 변수 스타일시트 이후에 로드되어야 변수가 해석됨)
|
||||
var uss = Resources.Load<StyleSheet>(USS_PATH);
|
||||
if (uss != null)
|
||||
{
|
||||
styleSheets.Add(uss);
|
||||
}
|
||||
|
||||
// 4. 헤더 요소 참조
|
||||
_titleLabel = this.Q<Label>("title");
|
||||
_closeButton = this.Q<UTKButton>("close-btn");
|
||||
|
||||
// 5. 닫기 버튼 설정 및 이벤트 연결
|
||||
if (_closeButton != null)
|
||||
{
|
||||
_closeButton.clicked += () =>
|
||||
{
|
||||
this.style.display = DisplayStyle.None;
|
||||
OnClosed?.Invoke();
|
||||
};
|
||||
_closeButton.SetMaterialIcon(UTKMaterialIcons.Close, 16);
|
||||
_closeButton.OnClicked += OnCloseButtonClicked;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>닫기 버튼 클릭 이벤트 핸들러</summary>
|
||||
private void OnCloseButtonClicked()
|
||||
{
|
||||
this.style.display = DisplayStyle.None;
|
||||
OnClosed?.Invoke();
|
||||
}
|
||||
#endregion
|
||||
|
||||
#region 공개 메서드 (Public Methods)
|
||||
@@ -263,6 +403,24 @@ namespace UVC.UIToolkit
|
||||
}
|
||||
#endregion
|
||||
|
||||
#region 테마 (Theme)
|
||||
|
||||
private void SubscribeToThemeChanges()
|
||||
{
|
||||
UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
|
||||
RegisterCallback<DetachFromPanelEvent>(_ =>
|
||||
{
|
||||
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
|
||||
});
|
||||
}
|
||||
|
||||
private void OnThemeChanged(UTKTheme theme)
|
||||
{
|
||||
UTKThemeManager.Instance.ApplyThemeToElement(this);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region IDisposable
|
||||
/// <summary>
|
||||
/// 리소스를 해제하고 이벤트 핸들러를 정리합니다.
|
||||
@@ -272,15 +430,26 @@ namespace UVC.UIToolkit
|
||||
if (_disposed) return;
|
||||
_disposed = true;
|
||||
|
||||
// 테마 변경 이벤트 해제
|
||||
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
|
||||
|
||||
// 내부 UTKComponentList 정리
|
||||
_componentList?.Dispose();
|
||||
_componentList = null;
|
||||
|
||||
// 닫기 버튼 이벤트 해제 및 정리
|
||||
if (_closeButton != null)
|
||||
{
|
||||
_closeButton.OnClicked -= OnCloseButtonClicked;
|
||||
_closeButton.Dispose();
|
||||
}
|
||||
|
||||
// 외부 이벤트 구독자 정리
|
||||
OnClosed = null;
|
||||
|
||||
// UI 참조 정리
|
||||
_closeButton = null;
|
||||
_titleLabel = null;
|
||||
}
|
||||
#endregion
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user