#nullable enable
using System;
using UnityEngine;
using UnityEngine.UIElements;
namespace UVC.UIToolkit
{
///
/// 슬라이더 컴포넌트.
/// Unity Slider를 래핑하여 커스텀 스타일을 적용합니다.
/// 드래그 또는 클릭으로 범위 내의 연속적인 값을 선택할 수 있습니다.
///
///
/// 슬라이더(Slider)란?
///
/// 슬라이더는 사용자가 지정된 범위 내에서 연속적인 값을 선택할 수 있는 UI 컨트롤입니다.
/// 볼륨, 밝기, 속도 등 수치 조절에 널리 사용되며, 시각적으로 현재 값의 위치를 확인할 수 있습니다.
///
///
/// 주요 속성:
///
/// - lowValue - 슬라이더의 최소값 (왼쪽 끝)
/// - highValue - 슬라이더의 최대값 (오른쪽 끝)
/// - value - 현재 선택된 값
/// - showInputField - 숫자 입력 필드 표시 여부 (Unity 기본 속성)
/// - direction - 슬라이더 방향 (Horizontal/Vertical)
///
///
/// 실제 활용 예시:
///
/// - 게임 설정 - 볼륨, 밝기, 마우스 감도 조절
/// - 이미지 편집 - 색상 조정, 필터 강도
/// - 애니메이션 - 타임라인 스크러빙, 재생 속도
/// - 3D 에디터 - 오브젝트 스케일, 회전 각도
///
///
///
/// C# 코드에서 사용:
///
/// // 기본 슬라이더 생성
/// var slider = new UTKSlider();
/// slider.label = "볼륨";
/// slider.lowValue = 0;
/// slider.highValue = 100;
/// slider.value = 50;
///
/// // 값 변경 이벤트
/// slider.OnValueChanged += (value) => {
/// Debug.Log($"볼륨: {value}%");
/// AudioListener.volume = value / 100f;
/// };
///
/// // 생성자로 한 번에 설정
/// var brightnessSlider = new UTKSlider("밝기", 0, 100, 75);
///
/// // 0~1 범위 슬라이더 (투명도)
/// var alphaSlider = new UTKSlider("투명도", 0f, 1f, 1f);
/// alphaSlider.OnValueChanged += (alpha) => {
/// material.SetFloat("_Alpha", alpha);
/// };
///
/// UXML에서 사용:
///
///
///
///
///
///
///
///
///
///
///
[UxmlElement]
public partial class UTKSlider : Slider, IDisposable
{
#region Constants
private const string USS_PATH = "UIToolkit/Slider/UTKSlider";
#endregion
#region Fields
private bool _disposed;
private bool _isEnabled = true;
#endregion
#region Events
/// 값 변경 이벤트
public event Action? OnValueChanged;
#endregion
#region Properties
/// 활성화 상태
[UxmlAttribute("is-enabled")]
public bool IsEnabled
{
get => _isEnabled;
set
{
_isEnabled = value;
SetEnabled(value);
EnableInClassList("utk-slider--disabled", !value);
}
}
/// 현재 값
public float Value
{
get => value;
set => this.value = value;
}
#endregion
#region Constructor
public UTKSlider() : base()
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
var uss = Resources.Load(USS_PATH);
if (uss != null)
{
styleSheets.Add(uss);
}
SetupStyles();
SetupEvents();
SubscribeToThemeChanges();
}
public UTKSlider(string label, float minValue = 0f, float maxValue = 100f, float defaultValue = 0f) : this()
{
this.label = label;
this.lowValue = minValue;
this.highValue = maxValue;
this.value = defaultValue;
}
#endregion
#region Setup
private void SetupStyles()
{
AddToClassList("utk-slider");
}
private void SetupEvents()
{
RegisterCallback>(OnSliderValueChanged);
}
private void SubscribeToThemeChanges()
{
UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
RegisterCallback(OnAttachToPanelForTheme);
RegisterCallback(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 evt)
{
OnValueChanged?.Invoke(evt.newValue);
}
#endregion
#region IDisposable
public void Dispose()
{
if (_disposed) return;
_disposed = true;
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
UnregisterCallback(OnAttachToPanelForTheme);
UnregisterCallback(OnDetachFromPanelForTheme);
OnValueChanged = null;
UnregisterCallback>(OnSliderValueChanged);
}
#endregion
}
}