428 lines
14 KiB
C#
428 lines
14 KiB
C#
#nullable enable
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Threading;
|
|
using Cysharp.Threading.Tasks;
|
|
using UnityEngine;
|
|
using UnityEngine.UIElements;
|
|
using UVC.Locale;
|
|
|
|
namespace UVC.UIToolkit
|
|
{
|
|
/// <summary>
|
|
/// UIToolkit 기반 툴팁 매니저
|
|
/// VisualElement에 마우스 오버 시 툴팁 표시
|
|
/// </summary>
|
|
public class UTKTooltipManager : IDisposable
|
|
{
|
|
#region Singleton
|
|
private static UTKTooltipManager? _instance;
|
|
public static UTKTooltipManager Instance => _instance ??= new UTKTooltipManager();
|
|
|
|
protected UTKTooltipManager() { }
|
|
#endregion
|
|
|
|
#region Constants
|
|
private const string UXML_PATH = "UIToolkit/Common/UTKTooltip";
|
|
private const string USS_PATH = "UIToolkit/Common/UTKTooltip";
|
|
private const int SHOW_DELAY_MS = 500;
|
|
private const int POSITION_OFFSET = 10;
|
|
#endregion
|
|
|
|
#region Fields
|
|
private VisualElement? _root;
|
|
private VisualElement? _tooltipContainer;
|
|
private Label? _tooltipLabel;
|
|
private bool _isInitialized;
|
|
private bool _isVisible;
|
|
private bool _disposed;
|
|
|
|
private CancellationTokenSource? _showDelayCts;
|
|
private readonly Dictionary<VisualElement, string> _tooltipRegistry = new();
|
|
private readonly Dictionary<VisualElement, EventCallback<PointerEnterEvent>> _enterCallbacks = new();
|
|
private readonly Dictionary<VisualElement, EventCallback<PointerLeaveEvent>> _leaveCallbacks = new();
|
|
private readonly Dictionary<VisualElement, EventCallback<PointerMoveEvent>> _moveCallbacks = new();
|
|
#endregion
|
|
|
|
#region Properties
|
|
public bool IsInitialized => _isInitialized;
|
|
public bool IsVisible => _isVisible;
|
|
#endregion
|
|
|
|
#region Initialization
|
|
/// <summary>
|
|
/// 툴팁 매니저를 초기화합니다.
|
|
/// </summary>
|
|
/// <param name="root">VisualElement 트리의 루트</param>
|
|
public void Initialize(VisualElement root)
|
|
{
|
|
if (_isInitialized)
|
|
{
|
|
Debug.LogWarning("[UTKTooltipManager] Already initialized.");
|
|
return;
|
|
}
|
|
|
|
_root = root;
|
|
|
|
// UXML 로드 시도
|
|
var visualTree = Resources.Load<VisualTreeAsset>(UXML_PATH);
|
|
if (visualTree != null)
|
|
{
|
|
_tooltipContainer = visualTree.Instantiate();
|
|
_tooltipContainer.name = "utk-tooltip-container";
|
|
_tooltipLabel = _tooltipContainer.Q<Label>("tooltip-label");
|
|
}
|
|
else
|
|
{
|
|
// UXML 없으면 코드로 생성
|
|
CreateTooltipUI();
|
|
}
|
|
|
|
if (_tooltipContainer != null)
|
|
{
|
|
_tooltipContainer.style.position = Position.Absolute;
|
|
_tooltipContainer.style.display = DisplayStyle.None;
|
|
_tooltipContainer.pickingMode = PickingMode.Ignore;
|
|
_root.Add(_tooltipContainer);
|
|
}
|
|
|
|
// 테마 변경 이벤트 구독
|
|
UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
|
|
|
|
_isInitialized = true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// 테마 변경 시 호출
|
|
/// </summary>
|
|
private void OnThemeChanged(UTKTheme theme)
|
|
{
|
|
if (_tooltipContainer != null)
|
|
{
|
|
UTKThemeManager.Instance.ApplyThemeToElement(_tooltipContainer);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// 코드로 툴팁 UI 생성
|
|
/// </summary>
|
|
private void CreateTooltipUI()
|
|
{
|
|
_tooltipContainer = new VisualElement
|
|
{
|
|
name = "utk-tooltip-container",
|
|
pickingMode = PickingMode.Ignore
|
|
};
|
|
|
|
// 테마 적용
|
|
UTKThemeManager.Instance.ApplyThemeToElement(_tooltipContainer);
|
|
|
|
// USS 스타일시트 로드
|
|
var uss = Resources.Load<StyleSheet>(USS_PATH);
|
|
if (uss != null)
|
|
{
|
|
_tooltipContainer.styleSheets.Add(uss);
|
|
}
|
|
|
|
// USS 클래스로 스타일 적용
|
|
_tooltipContainer.AddToClassList("utk-tooltip-container");
|
|
|
|
_tooltipLabel = new Label
|
|
{
|
|
name = "tooltip-label",
|
|
pickingMode = PickingMode.Ignore
|
|
};
|
|
_tooltipLabel.AddToClassList("utk-tooltip-label");
|
|
|
|
_tooltipContainer.Add(_tooltipLabel);
|
|
}
|
|
#endregion
|
|
|
|
#region Public Methods
|
|
/// <summary>
|
|
/// 툴팁을 즉시 표시합니다.
|
|
/// </summary>
|
|
/// <param name="text">표시할 텍스트</param>
|
|
/// <param name="position">화면 좌표</param>
|
|
public void Show(string text, Vector2 position)
|
|
{
|
|
if (!_isInitialized || _tooltipContainer == null || _tooltipLabel == null)
|
|
return;
|
|
|
|
// 다국어 처리
|
|
string displayText = GetLocalizedText(text);
|
|
if (string.IsNullOrEmpty(displayText))
|
|
{
|
|
Hide();
|
|
return;
|
|
}
|
|
|
|
_tooltipLabel.text = displayText;
|
|
_tooltipContainer.style.display = DisplayStyle.Flex;
|
|
_tooltipContainer.BringToFront();
|
|
_isVisible = true;
|
|
|
|
// 다음 프레임에 위치 조정 (레이아웃 계산 후)
|
|
_tooltipContainer.schedule.Execute(() => AdjustPosition(position));
|
|
}
|
|
|
|
/// <summary>
|
|
/// 지연 후 툴팁을 표시합니다.
|
|
/// </summary>
|
|
/// <param name="text">표시할 텍스트</param>
|
|
/// <param name="position">화면 좌표</param>
|
|
/// <param name="delayMs">지연 시간 (밀리초)</param>
|
|
public async UniTaskVoid ShowDelayed(string text, Vector2 position, int delayMs = SHOW_DELAY_MS)
|
|
{
|
|
CancelShowDelay();
|
|
_showDelayCts = new CancellationTokenSource();
|
|
|
|
try
|
|
{
|
|
await UniTask.Delay(delayMs, cancellationToken: _showDelayCts.Token);
|
|
Show(text, position);
|
|
}
|
|
catch (OperationCanceledException)
|
|
{
|
|
// 취소됨 - 무시
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// 툴팁을 숨깁니다.
|
|
/// </summary>
|
|
public void Hide()
|
|
{
|
|
CancelShowDelay();
|
|
|
|
if (_tooltipContainer != null)
|
|
{
|
|
_tooltipContainer.style.display = DisplayStyle.None;
|
|
}
|
|
_isVisible = false;
|
|
}
|
|
|
|
/// <summary>
|
|
/// VisualElement에 툴팁을 연결합니다.
|
|
/// </summary>
|
|
/// <param name="element">대상 요소</param>
|
|
/// <param name="tooltip">툴팁 텍스트 또는 다국어 키</param>
|
|
public void AttachTooltip(VisualElement element, string tooltip)
|
|
{
|
|
if (element == null || string.IsNullOrEmpty(tooltip))
|
|
return;
|
|
|
|
// 기존 등록 제거
|
|
DetachTooltip(element);
|
|
|
|
_tooltipRegistry[element] = tooltip;
|
|
|
|
// 이벤트 콜백 생성 및 등록
|
|
// 참고: evt.position은 로컬 좌표이므로, 패널 기준 좌표로 변환 필요
|
|
EventCallback<PointerEnterEvent> enterCallback = evt =>
|
|
{
|
|
if (_tooltipRegistry.TryGetValue(element, out var text))
|
|
{
|
|
// 로컬 좌표를 root 좌표로 변환
|
|
var rootPosition = element.LocalToWorld(evt.localPosition);
|
|
if (_root != null)
|
|
{
|
|
rootPosition = _root.WorldToLocal(rootPosition);
|
|
}
|
|
ShowDelayed(text, rootPosition).Forget();
|
|
}
|
|
};
|
|
|
|
EventCallback<PointerLeaveEvent> leaveCallback = _ => Hide();
|
|
|
|
EventCallback<PointerMoveEvent> moveCallback = evt =>
|
|
{
|
|
if (_isVisible)
|
|
{
|
|
// 로컬 좌표를 root 좌표로 변환
|
|
var rootPosition = element.LocalToWorld(evt.localPosition);
|
|
if (_root != null)
|
|
{
|
|
rootPosition = _root.WorldToLocal(rootPosition);
|
|
}
|
|
AdjustPosition(rootPosition);
|
|
}
|
|
};
|
|
|
|
element.RegisterCallback(enterCallback);
|
|
element.RegisterCallback(leaveCallback);
|
|
element.RegisterCallback(moveCallback);
|
|
|
|
_enterCallbacks[element] = enterCallback;
|
|
_leaveCallbacks[element] = leaveCallback;
|
|
_moveCallbacks[element] = moveCallback;
|
|
}
|
|
|
|
/// <summary>
|
|
/// VisualElement에서 툴팁을 제거합니다.
|
|
/// </summary>
|
|
/// <param name="element">대상 요소</param>
|
|
public void DetachTooltip(VisualElement element)
|
|
{
|
|
if (element == null)
|
|
return;
|
|
|
|
_tooltipRegistry.Remove(element);
|
|
|
|
if (_enterCallbacks.TryGetValue(element, out var enterCallback))
|
|
{
|
|
element.UnregisterCallback(enterCallback);
|
|
_enterCallbacks.Remove(element);
|
|
}
|
|
|
|
if (_leaveCallbacks.TryGetValue(element, out var leaveCallback))
|
|
{
|
|
element.UnregisterCallback(leaveCallback);
|
|
_leaveCallbacks.Remove(element);
|
|
}
|
|
|
|
if (_moveCallbacks.TryGetValue(element, out var moveCallback))
|
|
{
|
|
element.UnregisterCallback(moveCallback);
|
|
_moveCallbacks.Remove(element);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// 등록된 툴팁 텍스트를 업데이트합니다.
|
|
/// </summary>
|
|
/// <param name="element">대상 요소</param>
|
|
/// <param name="tooltip">새 툴팁 텍스트</param>
|
|
public void UpdateTooltip(VisualElement element, string tooltip)
|
|
{
|
|
if (element == null)
|
|
return;
|
|
|
|
if (string.IsNullOrEmpty(tooltip))
|
|
{
|
|
DetachTooltip(element);
|
|
}
|
|
else if (_tooltipRegistry.ContainsKey(element))
|
|
{
|
|
_tooltipRegistry[element] = tooltip;
|
|
}
|
|
else
|
|
{
|
|
AttachTooltip(element, tooltip);
|
|
}
|
|
}
|
|
#endregion
|
|
|
|
#region Private Methods
|
|
/// <summary>
|
|
/// 지연 표시 취소
|
|
/// </summary>
|
|
private void CancelShowDelay()
|
|
{
|
|
_showDelayCts?.Cancel();
|
|
_showDelayCts?.Dispose();
|
|
_showDelayCts = null;
|
|
}
|
|
|
|
/// <summary>
|
|
/// 다국어 텍스트 가져오기
|
|
/// </summary>
|
|
private string GetLocalizedText(string keyOrText)
|
|
{
|
|
if (string.IsNullOrEmpty(keyOrText))
|
|
return string.Empty;
|
|
|
|
// LocalizationManager 연동
|
|
if (LocalizationManager.Instance != null)
|
|
{
|
|
string localized = LocalizationManager.Instance.GetString(keyOrText);
|
|
if (!string.IsNullOrEmpty(localized) && localized != keyOrText)
|
|
{
|
|
return localized;
|
|
}
|
|
}
|
|
|
|
return keyOrText;
|
|
}
|
|
|
|
/// <summary>
|
|
/// 화면 경계 내에서 위치 조정
|
|
/// </summary>
|
|
private void AdjustPosition(Vector2 mousePosition)
|
|
{
|
|
if (_tooltipContainer == null || _root == null)
|
|
return;
|
|
|
|
var tooltipSize = new Vector2(
|
|
_tooltipContainer.resolvedStyle.width,
|
|
_tooltipContainer.resolvedStyle.height
|
|
);
|
|
|
|
var rootSize = new Vector2(
|
|
_root.resolvedStyle.width,
|
|
_root.resolvedStyle.height
|
|
);
|
|
|
|
// 기본 위치: 마우스 오른쪽 아래
|
|
float x = mousePosition.x + POSITION_OFFSET;
|
|
float y = mousePosition.y + POSITION_OFFSET;
|
|
|
|
// 오른쪽 경계 체크
|
|
if (x + tooltipSize.x > rootSize.x)
|
|
{
|
|
x = mousePosition.x - tooltipSize.x - POSITION_OFFSET;
|
|
}
|
|
|
|
// 아래쪽 경계 체크
|
|
if (y + tooltipSize.y > rootSize.y)
|
|
{
|
|
y = mousePosition.y - tooltipSize.y - POSITION_OFFSET;
|
|
}
|
|
|
|
// 왼쪽/위쪽 경계 체크
|
|
x = Mathf.Max(0, x);
|
|
y = Mathf.Max(0, y);
|
|
|
|
_tooltipContainer.style.left = x;
|
|
_tooltipContainer.style.top = y;
|
|
}
|
|
#endregion
|
|
|
|
#region IDisposable
|
|
public void Dispose()
|
|
{
|
|
if (_disposed)
|
|
return;
|
|
|
|
_disposed = true;
|
|
|
|
// 테마 이벤트 구독 해제
|
|
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
|
|
|
|
CancelShowDelay();
|
|
|
|
// 모든 등록된 요소에서 이벤트 해제
|
|
foreach (var element in new List<VisualElement>(_tooltipRegistry.Keys))
|
|
{
|
|
DetachTooltip(element);
|
|
}
|
|
|
|
_tooltipRegistry.Clear();
|
|
_enterCallbacks.Clear();
|
|
_leaveCallbacks.Clear();
|
|
_moveCallbacks.Clear();
|
|
|
|
// UI 제거
|
|
_tooltipContainer?.RemoveFromHierarchy();
|
|
_tooltipContainer = null;
|
|
_tooltipLabel = null;
|
|
_root = null;
|
|
|
|
_isInitialized = false;
|
|
_isVisible = false;
|
|
_instance = null;
|
|
}
|
|
#endregion
|
|
}
|
|
}
|