Files
XRLib/Assets/Scripts/UVC/UIToolkit/Dropdown/UTKEnumDropDown.cs
2026-01-13 20:39:45 +09:00

151 lines
4.0 KiB
C#

#nullable enable
using System;
using UnityEngine;
using UnityEngine.UIElements;
namespace UVC.UIToolkit
{
/// <summary>
/// Enum 선택 드롭다운 컴포넌트.
/// Unity EnumField를 래핑하여 커스텀 스타일을 적용합니다.
/// </summary>
/// <example>
/// <para><b>C# 코드에서 사용:</b></para>
/// <code>
/// // Enum 정의
/// public enum MyOption { Option1, Option2, Option3 }
///
/// // 기본 Enum 드롭다운
/// var enumDropdown = new UTKEnumDropDown();
/// enumDropdown.label = "옵션 선택";
/// enumDropdown.Init(MyOption.Option1);
///
/// // 값 변경 이벤트
/// enumDropdown.OnValueChanged += (value) => {
/// Debug.Log($"선택됨: {value}");
/// };
///
/// // 현재 값 가져오기
/// var current = (MyOption)enumDropdown.Value;
/// </code>
/// <para><b>UXML에서 사용:</b></para>
/// <code>
/// <ui:UXML xmlns:utk="UVC.UIToolkit">
/// <!-- UXML에서는 C#에서 Init() 호출 필요 -->
/// <utk:UTKEnumDropDown name="my-enum" label="옵션" />
/// </ui:UXML>
/// </code>
/// <para><b>UXML 로드 후 초기화:</b></para>
/// <code>
/// var enumField = root.Q<UTKEnumDropDown>("my-enum");
/// enumField.Init(MyOption.Option1);
/// </code>
/// </example>
[UxmlElement]
public partial class UTKEnumDropDown : EnumField, IDisposable
{
#region Constants
private const string USS_PATH = "UIToolkit/Dropdown/UTKEnumDropDown";
#endregion
#region Fields
private bool _disposed;
private bool _isEnabled = true;
#endregion
#region Events
/// <summary>값 변경 이벤트</summary>
public event Action<Enum?>? OnValueChanged;
#endregion
#region Properties
/// <summary>현재 값</summary>
public Enum? Value
{
get => value;
set => this.value = value;
}
/// <summary>활성화 상태</summary>
[UxmlAttribute]
public bool IsEnabled
{
get => _isEnabled;
set
{
_isEnabled = value;
SetEnabled(value);
EnableInClassList("utk-enum-dropdown--disabled", !value);
}
}
#endregion
#region Constructor
public UTKEnumDropDown() : base()
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
var uss = Resources.Load<StyleSheet>(USS_PATH);
if (uss != null)
{
styleSheets.Add(uss);
}
SetupStyles();
SetupEvents();
SubscribeToThemeChanges();
}
public UTKEnumDropDown(string label, Enum defaultValue) : this()
{
this.label = label;
Init(defaultValue);
}
#endregion
#region Setup
private void SetupStyles()
{
AddToClassList("utk-enum-dropdown");
}
private void SetupEvents()
{
this.RegisterValueChangedCallback(OnFieldValueChanged);
}
private void SubscribeToThemeChanges()
{
UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
RegisterCallback<DetachFromPanelEvent>(_ =>
{
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
});
}
private void OnThemeChanged(UTKTheme theme)
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
}
#endregion
#region Event Handlers
private void OnFieldValueChanged(ChangeEvent<Enum> evt)
{
OnValueChanged?.Invoke(evt.newValue);
}
#endregion
#region IDisposable
public void Dispose()
{
if (_disposed) return;
_disposed = true;
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
OnValueChanged = null;
}
#endregion
}
}