#nullable enable
using System;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UIElements;
namespace UVC.UIToolkit
{
///
/// 탭 뷰 컴포넌트.
/// Unity TabView를 래핑하여 커스텀 스타일을 적용합니다.
/// 여러 콘텐츠 페이지를 탭으로 전환하여 표시합니다.
///
///
/// TabView(탭 뷰)란?
///
/// TabView는 여러 페이지의 콘텐츠를 탭 버튼으로 전환하여 표시하는 UI 컴포넌트입니다.
/// 같은 공간에 여러 내용을 담을 수 있어 화면 공간을 효율적으로 사용합니다.
/// 설정 페이지, 에디터 창, 프로필 화면 등에서 널리 사용됩니다.
///
///
/// TabView 구성:
///
/// - 탭 헤더 - 탭 버튼들이 나열된 영역
/// - 탭 콘텐츠 - 선택된 탭의 내용이 표시되는 영역
///
///
/// 주요 속성:
///
/// - SelectedIndex - 현재 선택된 탭 인덱스
/// - UTKTabs - 탭 목록 (읽기 전용)
///
///
/// 주요 메서드:
///
/// - AddUTKTab(string, VisualElement) - 탭 추가
/// - AddTab(UTKTab) - UTKTab 인스턴스 추가
/// - RemoveTab(UTKTab) - 탭 제거
/// - ClearTabs() - 모든 탭 제거
///
///
/// 이벤트:
///
/// - OnTabChanged - 탭이 변경될 때 (인덱스, Tab 전달)
///
///
/// 실제 활용 예시:
///
/// - 설정 창 - 일반/고급/정보 탭
/// - 에디터 - 씬/게임/애셋 탭
/// - 프로필 - 정보/활동/설정 탭
/// - 문서 뷰어 - 다중 문서 탭
///
///
///
/// C# 코드에서 사용:
///
/// // 탭 뷰 생성
/// var tabView = new UTKTabView();
///
/// // 탭 추가
/// var tab1 = tabView.AddTab("일반", UTKMaterialIcons.Settings);
/// tab1.Add(new Label("일반 설정 내용"));
///
/// var tab2 = tabView.AddTab("고급", UTKMaterialIcons.Build);
/// tab2.Add(new Label("고급 설정 내용"));
///
/// // 탭 변경 이벤트
/// tabView.OnTabChanged += (index, tab) => Debug.Log($"탭 {index} 선택됨");
///
/// // 탭 선택
/// tabView.SelectedIndex = 0;
///
/// UXML에서 사용:
///
///
///
///
///
///
///
///
///
///
///
///
///
[UxmlElement]
public partial class UTKTabView : TabView, IDisposable
{
#region Constants
private const string USS_PATH = "UIToolkit/Tab/UTKTabView";
#endregion
#region Fields
private bool _disposed;
private readonly List _utkTabs = new();
#endregion
#region Events
/// 탭 변경 이벤트
public event Action? OnTabChanged;
#endregion
#region Properties
/// 선택된 탭 인덱스
public int SelectedIndex
{
get => selectedTabIndex;
set => selectedTabIndex = value;
}
/// UTK 탭 목록
public IReadOnlyList UTKTabs => _utkTabs;
#endregion
#region Constructor
public UTKTabView() : base()
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
var uss = Resources.Load(USS_PATH);
if (uss != null)
{
styleSheets.Add(uss);
}
SetupStyles();
SetupEvents();
SubscribeToThemeChanges();
}
#endregion
#region Setup
private void SetupStyles()
{
AddToClassList("utk-tabview");
}
private void SetupEvents()
{
this.RegisterCallback>(OnTabIndexChanged);
}
private void SubscribeToThemeChanges()
{
UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
RegisterCallback(_ =>
{
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
});
}
private void OnThemeChanged(UTKTheme theme)
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
}
#endregion
#region Event Handlers
private void OnTabIndexChanged(ChangeEvent evt)
{
UpdateTabSelection();
OnTabChanged?.Invoke(evt.newValue, activeTab);
}
private void UpdateTabSelection()
{
for (int i = 0; i < _utkTabs.Count; i++)
{
_utkTabs[i].IsSelected = (i == selectedTabIndex);
}
}
#endregion
#region Methods
///
/// UTK 탭 추가
///
public UTKTab AddUTKTab(string text, VisualElement? content = null)
{
var tab = new UTKTab(text);
if (content != null)
{
tab.Add(content);
}
AddTab(tab);
return tab;
}
///
/// 탭 추가
///
public void AddTab(UTKTab tab)
{
_utkTabs.Add(tab);
Add(tab);
if (_utkTabs.Count == 1)
{
tab.IsSelected = true;
}
}
///
/// 탭 제거
///
public void RemoveTab(UTKTab tab)
{
int index = _utkTabs.IndexOf(tab);
if (index < 0) return;
_utkTabs.RemoveAt(index);
tab.RemoveFromHierarchy();
tab.Dispose();
}
///
/// 모든 탭 제거
///
public void ClearTabs()
{
foreach (var tab in _utkTabs)
{
tab.RemoveFromHierarchy();
tab.Dispose();
}
_utkTabs.Clear();
}
#endregion
#region IDisposable
public void Dispose()
{
if (_disposed) return;
_disposed = true;
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
foreach (var tab in _utkTabs)
{
tab.Dispose();
}
_utkTabs.Clear();
OnTabChanged = null;
}
#endregion
}
}