UTKIntPropertyItemView, UTKIntRangePropertyItemView UTKNumberStepper 적용

This commit is contained in:
김형인
2026-02-06 00:35:15 +09:00
parent c1f5d2c208
commit 18af2fc9c6
8 changed files with 371 additions and 22 deletions

View File

@@ -11,6 +11,8 @@ namespace UVC.UIToolkit
{
#region Fields
private string _dateFormat = "yyyy-MM-dd";
private DateTime _minDay = DateTime.MinValue;
private DateTime _maxDay = DateTime.MaxValue;
#endregion
#region Properties
@@ -23,6 +25,20 @@ namespace UVC.UIToolkit
get => _dateFormat;
set => _dateFormat = value ?? "yyyy-MM-dd";
}
/// <summary>최소 날짜</summary>
public DateTime MinDay
{
get => _minDay;
set => _minDay = value;
}
/// <summary>최대 날짜</summary>
public DateTime MaxDay
{
get => _maxDay;
set => _maxDay = value;
}
#endregion
#region Constructor
@@ -36,6 +52,25 @@ namespace UVC.UIToolkit
public UTKDatePropertyItem(string id, string name, DateTime initialValue = default, bool isReadOnly = false)
: base(id, name, initialValue == default ? DateTime.Today : initialValue)
{
_minDay = DateTime.MinValue;
_maxDay = DateTime.MaxValue;
IsReadOnly = isReadOnly;
}
/// <summary>
/// 날짜 속성을 생성합니다 (날짜 제한 포함).
/// </summary>
/// <param name="id">고유 ID</param>
/// <param name="name">표시 이름</param>
/// <param name="initialValue">초기 값</param>
/// <param name="minDay">최소 날짜 (null이면 제한 없음)</param>
/// <param name="maxDay">최대 날짜 (null이면 제한 없음)</param>
/// <param name="isReadOnly">읽기 전용 여부</param>
public UTKDatePropertyItem(string id, string name, DateTime initialValue, DateTime? minDay, DateTime? maxDay, bool isReadOnly = false)
: base(id, name, initialValue == default ? DateTime.Today : initialValue)
{
_minDay = minDay ?? DateTime.MinValue;
_maxDay = maxDay ?? DateTime.MaxValue;
IsReadOnly = isReadOnly;
}
#endregion

View File

@@ -64,7 +64,7 @@ namespace UVC.UIToolkit
/// <param name="maxValue">최대값</param>
/// <param name="useSlider">슬라이더 사용 여부</param>
/// <param name="isReadOnly">읽기 전용 여부</param>
public UTKFloatPropertyItem(string id, string name, float initialValue, float minValue, float maxValue, bool useSlider = true, bool isReadOnly = false)
public UTKFloatPropertyItem(string id, string name, float initialValue, float minValue = float.MinValue, float maxValue = float.MaxValue, bool useSlider = true, bool isReadOnly = false)
: base(id, name, initialValue)
{
_minValue = minValue;

View File

@@ -12,8 +12,8 @@ namespace UVC.UIToolkit
#region Fields
private bool _useSlider;
private bool _useStepper;
private int _minValue;
private int _maxValue = 100;
private int _minValue = int.MinValue;
private int _maxValue = int.MaxValue;
private int _step = 1;
#endregion
@@ -28,8 +28,6 @@ namespace UVC.UIToolkit
set
{
_useSlider = value;
// UseSlider가 true이면 UseStepper는 false로
if (value) _useStepper = false;
}
}
@@ -40,8 +38,6 @@ namespace UVC.UIToolkit
set
{
_useStepper = value;
// UseStepper가 true이면 UseSlider는 false로
if (value) _useSlider = false;
}
}

View File

@@ -1,4 +1,5 @@
#nullable enable
using System;
namespace UVC.UIToolkit
{
@@ -8,14 +9,52 @@ namespace UVC.UIToolkit
/// </summary>
public class UTKIntRangePropertyItem : UTKPropertyItemBase<UTKIntRange>
{
#region Fields
private bool _useStepper;
private int _stepperMinValue = int.MinValue;
private int _stepperMaxValue = int.MaxValue;
private int _stepperStep = 1;
#endregion
#region Properties
/// <summary>속성 타입</summary>
public override UTKPropertyType PropertyType => UTKPropertyType.IntRange;
/// <summary>스테퍼(증감 버튼) 사용 여부</summary>
public bool UseStepper
{
get => _useStepper;
set
{
_useStepper = value;
}
}
/// <summary>스테퍼 증감 단위 (기본값: 1)</summary>
public int StepperStep
{
get => _stepperStep;
set => _stepperStep = Math.Max(1, value);
}
/// <summary>스테퍼 최소값</summary>
public int StepperMinValue
{
get => _stepperMinValue;
set => _stepperMinValue = value;
}
/// <summary>스테퍼 최대값</summary>
public int StepperMaxValue
{
get => _stepperMaxValue;
set => _stepperMaxValue = value;
}
#endregion
#region Constructor
/// <summary>
/// 정수 범위 속성을 생성합니다.
/// 정수 범위 속성을 생성합니다 (필드 모드).
/// </summary>
/// <param name="id">고유 ID</param>
/// <param name="name">표시 이름</param>
@@ -34,10 +73,39 @@ namespace UVC.UIToolkit
/// <param name="name">표시 이름</param>
/// <param name="min">최소값</param>
/// <param name="max">최대값</param>
/// <param name="stepperStep">스테퍼 증감 단위</param>
/// <param name="stepperMinValue">스테퍼 최소값</param>
/// <param name="stepperMaxValue">스테퍼 최대값</param>
/// <param name="useStepper">스테퍼 사용 여부</param>
/// <param name="isReadOnly">읽기 전용 여부</param>
public UTKIntRangePropertyItem(string id, string name, int min, int max, bool isReadOnly = false)
public UTKIntRangePropertyItem(string id, string name, int min, int max, int stepperStep = 1, int stepperMinValue = int.MinValue, int stepperMaxValue = int.MaxValue, bool useStepper = false, bool isReadOnly = false)
: base(id, name, new UTKIntRange(min, max))
{
_stepperMinValue = stepperMinValue;
_stepperMaxValue = stepperMaxValue;
_useStepper = useStepper;
_stepperStep = stepperStep;
IsReadOnly = isReadOnly;
}
/// <summary>
/// 정수 범위 속성을 생성합니다 (슬라이더/스테퍼 모드).
/// </summary>
/// <param name="id">고유 ID</param>
/// <param name="name">표시 이름</param>
/// <param name="initialValue">초기 범위 값</param>
/// <param name="stepperStep">스테퍼 증감 단위</param>
/// <param name="stepperMinValue">스테퍼 최소값</param>
/// <param name="stepperMaxValue">스테퍼 최대값</param>
/// <param name="useStepper">스테퍼 사용 여부</param>
/// <param name="isReadOnly">읽기 전용 여부</param>
public UTKIntRangePropertyItem(string id, string name, UTKIntRange initialValue, int stepperStep = 1, int stepperMinValue = int.MinValue, int stepperMaxValue = int.MaxValue, bool useStepper = false, bool isReadOnly = false)
: base(id, name, initialValue)
{
_stepperMinValue = stepperMinValue;
_stepperMaxValue = stepperMaxValue;
_useStepper = useStepper;
_stepperStep = stepperStep;
IsReadOnly = isReadOnly;
}
#endregion

View File

@@ -15,14 +15,70 @@ namespace UVC.UIToolkit
#region Fields
private UTKIntegerField? _minField;
private UTKIntegerField? _maxField;
private UTKNumberStepper? _minStepper;
private UTKNumberStepper? _maxStepper;
private UTKIntRange _value;
private bool _useStepper;
private int _stepperMinValue = int.MinValue;
private int _stepperMaxValue = int.MaxValue;
private int _stepperStep = 1;
private IUTKPropertyItem<UTKIntRange>? _boundData;
#endregion
#region Properties
protected override string ViewTypeName => "UTKIntRangePropertyItemView";
/// <summary>스테퍼(증감 버튼) 사용 여부</summary>
public bool UseStepper
{
get => _useStepper;
set
{
if (_useStepper != value)
{
_useStepper = value;
UpdateModeClass();
}
}
}
/// <summary>스테퍼 최소값</summary>
public int StepperMinValue
{
get => _stepperMinValue;
set
{
_stepperMinValue = value;
if (_minStepper != null) _minStepper.MinValue = value;
if (_maxStepper != null) _maxStepper.MinValue = value;
}
}
/// <summary>스테퍼 최대값</summary>
public int StepperMaxValue
{
get => _stepperMaxValue;
set
{
_stepperMaxValue = value;
if (_minStepper != null) _minStepper.MaxValue = value;
if (_maxStepper != null) _maxStepper.MaxValue = value;
}
}
/// <summary>스테퍼 증감 단위</summary>
public int StepperStep
{
get => _stepperStep;
set
{
_stepperStep = Math.Max(1, value);
if (_minStepper != null) _minStepper.Step = _stepperStep;
if (_maxStepper != null) _maxStepper.Step = _stepperStep;
}
}
/// <summary>현재 값</summary>
public UTKIntRange Value
{
@@ -94,31 +150,57 @@ namespace UVC.UIToolkit
{
_minField = this.Q<UTKIntegerField>("min-field");
_maxField = this.Q<UTKIntegerField>("max-field");
_minStepper = this.Q<UTKNumberStepper>("min-stepper");
_maxStepper = this.Q<UTKNumberStepper>("max-stepper");
// Fallback: UXML에서 못 찾으면 생성
if (_valueContainer != null)
{
_valueContainer.style.flexDirection = FlexDirection.Row;
// IntegerField 생성
if (_minField == null)
{
_minField = new UTKIntegerField { name = "min-field" };
_minField.style.flexGrow = 1;
_minField.AddToClassList("utk-property-item-view__field");
_valueContainer.Add(_minField);
var separator = new UTKLabel("~", UTKLabel.LabelSize.Body2);
separator.AddToClassList("utk-property-item-view__range-separator");
_valueContainer.Add(separator);
}
if (_maxField == null)
{
var separator = new UTKLabel("~", UTKLabel.LabelSize.Body2);
separator.AddToClassList("utk-property-item-view__range-separator");
_valueContainer.Add(separator);
_maxField = new UTKIntegerField { name = "max-field" };
_maxField.style.flexGrow = 1;
_maxField.AddToClassList("utk-property-item-view__field");
_valueContainer.Add(_maxField);
}
// NumberStepper 생성
if (_minStepper == null)
{
_minStepper = new UTKNumberStepper(_stepperMinValue, _stepperMaxValue, _value.Min, _stepperStep, IsReadOnly)
{
name = "min-stepper"
};
_minStepper.style.flexGrow = 1;
_minStepper.AddToClassList("utk-property-item-view__stepper");
_valueContainer.Add(_minStepper);
}
if (_maxStepper == null)
{
_maxStepper = new UTKNumberStepper(_stepperMinValue, _stepperMaxValue, _value.Max, _stepperStep, IsReadOnly)
{
name = "max-stepper"
};
_maxStepper.style.flexGrow = 1;
_maxStepper.AddToClassList("utk-property-item-view__stepper");
_valueContainer.Add(_maxStepper);
}
}
// 초기 값 설정
@@ -132,6 +214,25 @@ namespace UVC.UIToolkit
_maxField.SetValueWithoutNotify(_value.Max);
_maxField.isReadOnly = IsReadOnly;
}
if (_minStepper != null)
{
_minStepper.MinValue = _stepperMinValue;
_minStepper.MaxValue = _stepperMaxValue;
_minStepper.Step = _stepperStep;
_minStepper.SetValue(_value.Min, false);
_minStepper.IsReadOnly = IsReadOnly;
}
if (_maxStepper != null)
{
_maxStepper.MinValue = _stepperMinValue;
_maxStepper.MaxValue = _stepperMaxValue;
_maxStepper.Step = _stepperStep;
_maxStepper.SetValue(_value.Max, false);
_maxStepper.IsReadOnly = IsReadOnly;
}
// 컨트롤 가시성 업데이트
UpdateControlVisibility();
}
private void RegisterEvents()
@@ -144,6 +245,14 @@ namespace UVC.UIToolkit
{
_maxField.OnValueChanged += OnMaxChanged;
}
if (_minStepper != null)
{
_minStepper.OnValueChanged += OnMinStepperChanged;
}
if (_maxStepper != null)
{
_maxStepper.OnValueChanged += OnMaxStepperChanged;
}
}
private void UnregisterEvents()
@@ -156,6 +265,65 @@ namespace UVC.UIToolkit
{
_maxField.OnValueChanged -= OnMaxChanged;
}
if (_minStepper != null)
{
_minStepper.OnValueChanged -= OnMinStepperChanged;
}
if (_maxStepper != null)
{
_maxStepper.OnValueChanged -= OnMaxStepperChanged;
}
}
private void UpdateModeClass()
{
// ReadOnly 상태에서는 무조건 IntegerField만 표시
if (IsReadOnly)
{
RemoveFromClassList("utk-property-item-view--stepper");
UpdateControlVisibility();
return;
}
// 스테퍼 클래스
if (_useStepper)
{
AddToClassList("utk-property-item-view--stepper");
}
else
{
RemoveFromClassList("utk-property-item-view--stepper");
}
UpdateControlVisibility();
}
/// <summary>컨트롤 가시성을 업데이트합니다.</summary>
private void UpdateControlVisibility()
{
bool isReadOnlyMode = IsReadOnly;
bool showStepper = !isReadOnlyMode && _useStepper;
bool showIntField = isReadOnlyMode || !_useStepper;
if (_minField != null)
{
_minField.style.display = showIntField ? DisplayStyle.Flex : DisplayStyle.None;
}
if (_maxField != null)
{
_maxField.style.display = showIntField ? DisplayStyle.Flex : DisplayStyle.None;
}
if (_minStepper != null)
{
_minStepper.style.display = showStepper ? DisplayStyle.Flex : DisplayStyle.None;
}
if (_maxStepper != null)
{
_maxStepper.style.display = showStepper ? DisplayStyle.Flex : DisplayStyle.None;
}
}
#endregion
@@ -174,6 +342,11 @@ namespace UVC.UIToolkit
{
if (_minField != null) _minField.isReadOnly = isReadOnly;
if (_maxField != null) _maxField.isReadOnly = isReadOnly;
if (_minStepper != null) _minStepper.IsReadOnly = isReadOnly;
if (_maxStepper != null) _maxStepper.IsReadOnly = isReadOnly;
// ReadOnly 상태 변경 시 모드 클래스 업데이트
UpdateModeClass();
}
#endregion
@@ -207,6 +380,36 @@ namespace UVC.UIToolkit
}
}
}
private void OnMinStepperChanged(int newMin)
{
var newValue = new UTKIntRange(newMin, _value.Max);
if (!_value.Equals(newValue))
{
_value = newValue;
OnValueChanged?.Invoke(newValue);
if (_boundData != null && !_boundData.Value.Equals(newValue))
{
_boundData.Value = newValue;
}
}
}
private void OnMaxStepperChanged(int newMax)
{
var newValue = new UTKIntRange(_value.Min, newMax);
if (!_value.Equals(newValue))
{
_value = newValue;
OnValueChanged?.Invoke(newValue);
if (_boundData != null && !_boundData.Value.Equals(newValue))
{
_boundData.Value = newValue;
}
}
}
#endregion
#region Value Update
@@ -221,6 +424,16 @@ namespace UVC.UIToolkit
{
_maxField.SetValueWithoutNotify(_value.Max);
}
if (_minStepper != null && _minStepper.Value != _value.Min)
{
_minStepper.SetValue(_value.Min, false);
}
if (_maxStepper != null && _maxStepper.Value != _value.Max)
{
_maxStepper.SetValue(_value.Max, false);
}
}
#endregion
@@ -249,6 +462,31 @@ namespace UVC.UIToolkit
IsVisible = data.IsVisible;
TooltipText = data.Tooltip;
// UTKIntRangePropertyItem의 스테퍼 설정 적용
if (data is UTKIntRangePropertyItem rangeItem)
{
_useStepper = rangeItem.UseStepper;
_stepperMinValue = rangeItem.StepperMinValue;
_stepperMaxValue = rangeItem.StepperMaxValue;
_stepperStep = rangeItem.StepperStep;
// 스테퍼에 값 적용
if (_minStepper != null)
{
_minStepper.MinValue = _stepperMinValue;
_minStepper.MaxValue = _stepperMaxValue;
_minStepper.Step = _stepperStep;
}
if (_maxStepper != null)
{
_maxStepper.MinValue = _stepperMinValue;
_maxStepper.MaxValue = _stepperMaxValue;
_maxStepper.Step = _stepperStep;
}
UpdateModeClass();
}
data.OnTypedValueChanged += OnDataValueChanged;
UpdateValueUI();
@@ -287,6 +525,8 @@ namespace UVC.UIToolkit
OnValueChanged = null;
_minField = null;
_maxField = null;
_minStepper = null;
_maxStepper = null;
}
base.Dispose(disposing);