#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 } }