Files
XRLib/Assets/Scripts/UVC/UIToolkit/Common/UTKHelpBox.cs
2026-01-13 20:39:45 +09:00

153 lines
4.3 KiB
C#

#nullable enable
using System;
using UnityEngine;
using UnityEngine.UIElements;
namespace UVC.UIToolkit
{
/// <summary>
/// 도움말 박스 컴포넌트.
/// Unity HelpBox를 래핑하여 커스텀 스타일을 적용합니다.
/// </summary>
/// <example>
/// <para><b>C# 코드에서 사용:</b></para>
/// <code>
/// // 정보 메시지
/// var infoBox = new UTKHelpBox()
/// {
/// Message = "이 기능은 베타 버전입니다.",
/// messageType = HelpBoxMessageType.Info
/// };
///
/// // 경고 메시지
/// var warningBox = new UTKHelpBox()
/// {
/// Message = "주의: 되돌릴 수 없습니다.",
/// messageType = HelpBoxMessageType.Warning
/// };
///
/// // 오류 메시지
/// var errorBox = new UTKHelpBox()
/// {
/// Message = "오류: 파일을 찾을 수 없습니다.",
/// messageType = HelpBoxMessageType.Error
/// };
/// </code>
/// <para><b>UXML에서 사용:</b></para>
/// <code>
/// <ui:UXML xmlns:utk="UVC.UIToolkit">
/// <!-- 정보 -->
/// <utk:UTKHelpBox text="정보 메시지입니다." message-type="Info" />
///
/// <!-- 경고 -->
/// <utk:UTKHelpBox text="경고 메시지입니다." message-type="Warning" />
///
/// <!-- 오류 -->
/// <utk:UTKHelpBox text="오류 메시지입니다." message-type="Error" />
/// </ui:UXML>
/// </code>
/// </example>
[UxmlElement]
public partial class UTKHelpBox : HelpBox, IDisposable
{
#region Constants
private const string USS_PATH = "UIToolkit/Common/UTKHelpBox";
#endregion
#region Fields
private bool _disposed;
#endregion
#region Properties
/// <summary>메시지 텍스트</summary>
public string Message
{
get => text;
set => text = value;
}
/// <summary>메시지 타입</summary>
public new HelpBoxMessageType messageType
{
get => base.messageType;
set
{
base.messageType = value;
UpdateMessageTypeClass();
}
}
#endregion
#region Constructor
public UTKHelpBox() : base()
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
var uss = Resources.Load<StyleSheet>(USS_PATH);
if (uss != null)
{
styleSheets.Add(uss);
}
SetupStyles();
SubscribeToThemeChanges();
}
public UTKHelpBox(string message, HelpBoxMessageType type = HelpBoxMessageType.Info) : this()
{
text = message;
messageType = type;
}
#endregion
#region Setup
private void SetupStyles()
{
AddToClassList("utk-helpbox");
UpdateMessageTypeClass();
}
private void UpdateMessageTypeClass()
{
RemoveFromClassList("utk-helpbox--info");
RemoveFromClassList("utk-helpbox--warning");
RemoveFromClassList("utk-helpbox--error");
RemoveFromClassList("utk-helpbox--none");
var typeClass = messageType switch
{
HelpBoxMessageType.Warning => "utk-helpbox--warning",
HelpBoxMessageType.Error => "utk-helpbox--error",
HelpBoxMessageType.None => "utk-helpbox--none",
_ => "utk-helpbox--info"
};
AddToClassList(typeClass);
}
private void SubscribeToThemeChanges()
{
UTKThemeManager.Instance.OnThemeChanged += OnThemeChanged;
RegisterCallback<DetachFromPanelEvent>(_ =>
{
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
});
}
private void OnThemeChanged(UTKTheme theme)
{
UTKThemeManager.Instance.ApplyThemeToElement(this);
}
#endregion
#region IDisposable
public void Dispose()
{
if (_disposed) return;
_disposed = true;
UTKThemeManager.Instance.OnThemeChanged -= OnThemeChanged;
}
#endregion
}
}