UTKProperyWindow 개발 중

This commit is contained in:
logonkhi
2026-02-03 20:43:36 +09:00
parent 297ca29082
commit 8181eae4c6
74 changed files with 1268 additions and 385 deletions

View File

@@ -114,7 +114,7 @@ namespace UVC.UIToolkit
private void SetupEvents()
{
this.RegisterValueChangedCallback(OnRadioValueChanged);
RegisterCallback<ChangeEvent<bool>>(OnRadioValueChanged);
}
private void SubscribeToThemeChanges()
@@ -168,6 +168,7 @@ namespace UVC.UIToolkit
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
OnValueChanged = null;
UnregisterCallback<ChangeEvent<bool>>(OnRadioValueChanged);
}
#endregion
}

View File

@@ -17,6 +17,19 @@ namespace UVC.UIToolkit
/// toggle.label = "알림 받기";
/// toggle.IsOn = true;
/// toggle.OnValueChanged += (isOn) => Debug.Log($"토글: {isOn}");
///
/// // 상호작용 불가능 (읽기 전용, 프로그래밍 방식으로만 변경 가능)
/// var readOnlyToggle = new UTKToggle("읽기 전용 토글");
/// readOnlyToggle.IsOn = true;
/// readOnlyToggle.IsInteractive = false; // 사용자 클릭/키보드 입력 차단
/// readOnlyToggle.SetOn(false, true); // 프로그래밍 방식으로는 변경 가능
///
/// // IsEnabled vs IsInteractive
/// var disabledToggle = new UTKToggle("완전 비활성화");
/// disabledToggle.IsEnabled = false; // 시각적 비활성화 + 모든 변경 불가
///
/// var nonInteractiveToggle = new UTKToggle("상호작용 비활성화");
/// nonInteractiveToggle.IsInteractive = false; // 사용자 입력만 차단, 시각적 활성화 유지
/// </code>
/// <para><b>UXML에서 사용:</b></para>
/// <code>
@@ -29,6 +42,9 @@ namespace UVC.UIToolkit
///
/// <!-- 비활성화 -->
/// <utk:UTKToggle label="프리미엄 기능" is-enabled="false" />
///
/// <!-- 상호작용 불가능 (읽기 전용) -->
/// <utk:UTKToggle label="시스템 상태" value="true" is-interactive="false" />
/// </ui:UXML>
/// </code>
/// </example>
@@ -42,6 +58,7 @@ namespace UVC.UIToolkit
#region Fields
private bool _disposed;
private bool _isEnabled = true;
private bool _isInteractive = true;
#endregion
#region Events
@@ -70,6 +87,22 @@ namespace UVC.UIToolkit
EnableInClassList("utk-toggle--disabled", !value);
}
}
/// <summary>
/// 상호작용 가능 여부. false일 경우 마우스/키보드 입력을 무시하지만 프로그래밍 방식으로는 값 변경 가능.
/// IsEnabled와 달리 시각적으로는 활성화 상태를 유지합니다.
/// </summary>
[UxmlAttribute("is-interactive")]
public bool IsInteractive
{
get => _isInteractive;
set
{
_isInteractive = value;
UpdateInteractiveState();
EnableInClassList("utk-toggle--non-interactive", !value);
}
}
#endregion
#region Constructor
@@ -102,7 +135,9 @@ namespace UVC.UIToolkit
private void SetupEvents()
{
this.RegisterValueChangedCallback(OnToggleValueChanged);
RegisterCallback<ChangeEvent<bool>>(OnToggleValueChanged);
RegisterCallback<MouseDownEvent>(OnMouseDown, TrickleDown.TrickleDown);
RegisterCallback<KeyDownEvent>(OnKeyDown, TrickleDown.TrickleDown);
}
private void SubscribeToThemeChanges()
@@ -126,6 +161,28 @@ namespace UVC.UIToolkit
EnableInClassList("utk-toggle--on", evt.newValue);
OnValueChanged?.Invoke(evt.newValue);
}
private void OnMouseDown(MouseDownEvent evt)
{
if (!_isInteractive)
{
evt.StopImmediatePropagation();
evt.PreventDefault();
}
}
private void OnKeyDown(KeyDownEvent evt)
{
if (!_isInteractive)
{
// Space나 Enter 키로 토글 변경 방지
if (evt.keyCode == KeyCode.Space || evt.keyCode == KeyCode.Return || evt.keyCode == KeyCode.KeypadEnter)
{
evt.StopImmediatePropagation();
evt.PreventDefault();
}
}
}
#endregion
#region Methods
@@ -144,6 +201,15 @@ namespace UVC.UIToolkit
OnValueChanged?.Invoke(newValue);
}
}
/// <summary>
/// 상호작용 상태 업데이트
/// </summary>
private void UpdateInteractiveState()
{
// IsInteractive가 false일 때 포커스 불가능하게 설정
focusable = _isInteractive;
}
#endregion
#region IDisposable
@@ -154,6 +220,9 @@ namespace UVC.UIToolkit
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
OnValueChanged = null;
UnregisterCallback<ChangeEvent<bool>>(OnToggleValueChanged);
UnregisterCallback<MouseDownEvent>(OnMouseDown, TrickleDown.TrickleDown);
UnregisterCallback<KeyDownEvent>(OnKeyDown, TrickleDown.TrickleDown);
}
#endregion
}

View File

@@ -98,7 +98,7 @@ namespace UVC.UIToolkit
private void SetupEvents()
{
this.RegisterValueChangedCallback(OnValueChanged);
RegisterCallback<ChangeEvent<ToggleButtonGroupState>>(OnValueChanged);
}
private void SubscribeToThemeChanges()
@@ -157,6 +157,7 @@ namespace UVC.UIToolkit
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
OnSelectionChanged = null;
UnregisterCallback<ChangeEvent<ToggleButtonGroupState>>(OnValueChanged);
}
#endregion
}