XRLib/Assets/Scripts/UVC/UIToolkit/Button/UTKToggle.cs

#nullable enable
using System;
using UnityEngine;
using UnityEngine.UIElements;

namespace UVC.UIToolkit
{
    /// <summary>
    /// 토글 스위치 컴포넌트.
    /// Unity Toggle을 래핑하여 커스텀 스타일을 적용합니다.
    /// </summary>
    /// <example>
    /// <para><b>C# 코드에서 사용:</b></para>
    /// <code>
    /// // 기본 토글
    /// var toggle = new UTKToggle();
    /// toggle.Label = "알림 받기";
    /// toggle.IsOn = true;
    /// toggle.OnValueChanged += (isOn) => Debug.Log($"토글: {isOn}");
    /// </code>
    /// <para><b>UXML에서 사용:</b></para>
    /// <code>
    /// <ui:UXML xmlns:utk="UVC.UIToolkit">
    ///     <!-- 기본 토글 -->
    ///     <utk:UTKToggle label="다크 모드" />
    ///     
    ///     <!-- 기본값 켜짐 -->
    ///     <utk:UTKToggle label="자동 저장" value="true" />
    ///     
    ///     <!-- 비활성화 -->
    ///     <utk:UTKToggle label="프리미엄 기능" IsEnabled="false" />
    /// </ui:UXML>
    /// </code>
    /// </example>
    [UxmlElement]
    public partial class UTKToggle : Toggle, IDisposable
    {
        #region Constants
        private const string USS_PATH = "UIToolkit/Button/UTKToggle";
        #endregion

        #region Fields
        private bool _disposed;
        private bool _isEnabled = true;
        #endregion

        #region Events
        /// <summary>상태 변경 이벤트</summary>
        public event Action<bool>? OnValueChanged;
        #endregion

        #region Properties
        /// <summary>토글 상태</summary>
        [UxmlAttribute]
        public bool IsOn
        {
            get => value;
            set => SetOn(value, true);
        }

        /// <summary>활성화 상태</summary>
        [UxmlAttribute]
        public bool IsEnabled
        {
            get => _isEnabled;
            set
            {
                _isEnabled = value;
                SetEnabled(value);
                EnableInClassList("utk-toggle--disabled", !value);
            }
        }
        #endregion

        #region Constructor
        public UTKToggle() : base()
        {
            UTKThemeManager.Instance.ApplyThemeToElement(this);

            var uss = Resources.Load<StyleSheet>(USS_PATH);
            if (uss != null)
            {
                styleSheets.Add(uss);
            }

            SetupStyles();
            SetupEvents();
            SubscribeToThemeChanges();
        }

        public UTKToggle(string label) : this()
        {
            this.label = label;
        }
        #endregion

        #region Setup
        private void SetupStyles()
        {
            AddToClassList("utk-toggle");
        }

        private void SetupEvents()
        {
            this.RegisterValueChangedCallback(OnToggleValueChanged);
        }

        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 OnToggleValueChanged(ChangeEvent<bool> evt)
        {
            EnableInClassList("utk-toggle--on", evt.newValue);
            OnValueChanged?.Invoke(evt.newValue);
        }
        #endregion

        #region Methods
        /// <summary>
        /// 상태 설정
        /// </summary>
        public void SetOn(bool newValue, bool notify)
        {
            if (value == newValue) return;

            SetValueWithoutNotify(newValue);
            EnableInClassList("utk-toggle--on", newValue);

            if (notify)
            {
                OnValueChanged?.Invoke(newValue);
            }
        }
        #endregion

        #region IDisposable
        public void Dispose()
        {
            if (_disposed) return;
            _disposed = true;

            UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
            OnValueChanged = null;
        }
        #endregion
    }
}