EnglewoodLAB/Assets/Scripts/UVC/UIToolkit/Slider/UTKMinMaxSlider.cs

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

namespace UVC.UIToolkit
{
    /// <summary>
    /// 최소-최대 범위 슬라이더 컴포넌트.
    /// Unity MinMaxSlider를 래핑하여 커스텀 스타일을 적용합니다.
    /// 두 개의 핸들로 범위(최소값~최대값)를 선택할 수 있습니다.
    /// </summary>
    /// <remarks>
    /// <para><b>MinMaxSlider(범위 슬라이더)란?</b></para>
    /// <para>
    /// MinMaxSlider는 일반 슬라이더와 달리 두 개의 핸들을 가지며, 사용자가 범위를 지정할 수 있습니다.
    /// 가격 필터, 시간대 선택, 수치 범위 지정 등에 활용됩니다.
    /// </para>
    ///
    /// <para><b>주요 속성:</b></para>
    /// <list type="bullet">
    /// <item><description><c>lowLimit</c> - 슬라이더 전체 범위의 최소값 (왼쪽 끝)</description></item>
    /// <item><description><c>highLimit</c> - 슬라이더 전체 범위의 최대값 (오른쪽 끝)</description></item>
    /// <item><description><c>MinValue</c> - 현재 선택된 범위의 최소값 (왼쪽 핸들)</description></item>
    /// <item><description><c>MaxValue</c> - 현재 선택된 범위의 최대값 (오른쪽 핸들)</description></item>
    /// </list>
    ///
    /// <para><b>Limit vs Value 차이:</b></para>
    /// <para>
    /// - <c>lowLimit/highLimit</c>: 슬라이더가 표현할 수 있는 전체 범위 (고정)
    /// - <c>MinValue/MaxValue</c>: 사용자가 선택한 현재 범위 (변경 가능)
    /// </para>
    ///
    /// <para><b>실제 활용 예시:</b></para>
    /// <list type="bullet">
    /// <item><description>쇼핑몰 - 가격대 필터 (₩10,000 ~ ₩50,000)</description></item>
    /// <item><description>미디어 플레이어 - 재생 구간 선택 (클리핑)</description></item>
    /// <item><description>검색 필터 - 날짜/시간 범위 선택</description></item>
    /// <item><description>게임 설정 - 레벨/난이도 범위 필터</description></item>
    /// </list>
    /// </remarks>
    /// <example>
    /// <para><b>C# 코드에서 사용:</b></para>
    /// <code>
    /// // 가격 범위 슬라이더
    /// var priceSlider = new UTKMinMaxSlider();
    /// priceSlider.label = "가격 범위";
    /// priceSlider.lowLimit = 0;       // 전체 범위: 0원
    /// priceSlider.highLimit = 100000; // 전체 범위: 100,000원
    /// priceSlider.MinValue = 10000;   // 선택 범위: 10,000원부터
    /// priceSlider.MaxValue = 50000;   // 선택 범위: 50,000원까지
    ///
    /// // 값 변경 이벤트 (Vector2로 반환)
    /// priceSlider.OnValueChanged += (range) => {
    ///     Debug.Log($"가격: {range.x:N0}원 ~ {range.y:N0}원");
    ///     FilterProducts(range.x, range.y);
    /// };
    ///
    /// // 생성자로 한 번에 설정
    /// var ageSlider = new UTKMinMaxSlider("연령대", 0, 100, 20, 40);
    ///
    /// // 시간 범위 선택 (0~24시)
    /// var timeSlider = new UTKMinMaxSlider("영업 시간", 0, 24, 9, 18);
    /// timeSlider.OnValueChanged += (time) => {
    ///     Debug.Log($"영업시간: {time.x:F0}시 ~ {time.y:F0}시");
    /// };
    /// </code>
    /// <para><b>UXML에서 사용:</b></para>
    /// <code>
    /// <!-- 기본 범위 슬라이더 -->
    /// <utk:UTKMinMaxSlider label="범위"
    ///                      low-limit="0" high-limit="100"
    ///                      min-value="20" max-value="80" />
    ///
    /// <!-- 가격 필터 -->
    /// <utk:UTKMinMaxSlider label="가격대"
    ///                      low-limit="0" high-limit="1000000"
    ///                      min-value="100000" max-value="500000" />
    ///
    /// <!-- 비활성화 상태 -->
    /// <utk:UTKMinMaxSlider label="잠금" is-enabled="false"
    ///                      min-value="30" max-value="70" />
    /// </code>
    /// </example>
    [UxmlElement]
    public partial class UTKMinMaxSlider : MinMaxSlider, IDisposable
    {
        #region Constants
        private const string USS_PATH = "UIToolkit/Slider/UTKMinMaxSlider";
        #endregion

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

        #region Events
        /// <summary>값 변경 이벤트</summary>
        public event Action<Vector2>? OnValueChanged;
        #endregion

        #region Properties
        /// <summary>최소값</summary>
        public float MinValue
        {
            get => minValue;
            set => minValue = value;
        }

        /// <summary>최대값</summary>
        public float MaxValue
        {
            get => maxValue;
            set => maxValue = value;
        }

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

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

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

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

        public UTKMinMaxSlider(string label, float minLimit = 0f, float maxLimit = 100f, float minValue = 0f, float maxValue = 100f) : this()
        {
            this.label = label;
            this.lowLimit = minLimit;
            this.highLimit = maxLimit;
            this.minValue = minValue;
            this.maxValue = maxValue;
        }
        #endregion

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

        private void SetupEvents()
        {
            RegisterCallback<ChangeEvent<Vector2>>(OnSliderValueChanged);
        }

        private void SubscribeToThemeChanges()
        {
            UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
            RegisterCallback<AttachToPanelEvent>(OnAttachToPanelForTheme);
            RegisterCallback<DetachFromPanelEvent>(OnDetachFromPanelForTheme);
        }

        private void OnAttachToPanelForTheme(AttachToPanelEvent evt)
        {
            UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
            UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
            UTKThemeManager.Instance.ApplyThemeToElement(this);
        }

        private void OnDetachFromPanelForTheme(DetachFromPanelEvent evt)
        {
            UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
        }

        private void OnThemeChanged(UTKTheme theme)
        {
            UTKThemeManager.Instance.ApplyThemeToElement(this);
        }
        #endregion

        #region Event Handlers
        private void OnSliderValueChanged(ChangeEvent<Vector2> evt)
        {
            OnValueChanged?.Invoke(evt.newValue);
        }
        #endregion

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

            UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
            UnregisterCallback<AttachToPanelEvent>(OnAttachToPanelForTheme);
            UnregisterCallback<DetachFromPanelEvent>(OnDetachFromPanelForTheme);
            OnValueChanged = null;
            UnregisterCallback<ChangeEvent<Vector2>>(OnSliderValueChanged);
        }
        #endregion
    }
}