khi/XRLib
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

샘플 코드 개선. UTKHelpBox 개선

Browse Source
This commit is contained in:
logonkhi
2026-01-26 20:00:21 +09:00
parent 99f9c3b26d
commit 097436a8b0
18 changed files with 1321 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files

116
Assets/Scripts/UVC/UIToolkit/Common/UTKHelpBox.cs
View File

@@ -18,10 +18,11 @@ namespace UVC.UIToolkit
/// Unity Inspector에서 볼 수 있는 노란색/빨간색 경고 박스와 같은 역할입니다.
/// </para>
///
/// <para><b>메시지 유형 (HelpBoxMessageType):</b></para>
/// <para><b>메시지 유형 (MessageType):</b></para>
/// <list type="bullet">
/// <item><description><c>None</c> - 아이콘 없이 텍스트만 표시</description></item>
/// <item><description><c>Info</c> - 정보 아이콘 (파란색) - 일반 안내 메시지</description></item>
/// <item><description><c>Success</c> - 성공 아이콘 (녹색) - 작업 완료, 성공</description></item>
/// <item><description><c>Warning</c> - 경고 아이콘 (노란색) - 주의 필요한 사항</description></item>
/// <item><description><c>Error</c> - 오류 아이콘 (빨간색) - 에러, 문제 상황</description></item>
/// </list>
@@ -46,22 +47,29 @@ namespace UVC.UIToolkit
/// // 정보 메시지
/// var infoBox = new UTKHelpBox()
/// {
/// Message = "이 기능은 베타 버전입니다.",
/// messageType = HelpBoxMessageType.Info
/// Text = "이 기능은 베타 버전입니다.",
/// messageType = UTKHelpBox.MessageType.Info
/// };
///
/// // 성공 메시지
/// var successBox = new UTKHelpBox()
/// {
/// Text = "저장되었습니다.",
/// messageType = UTKHelpBox.MessageType.Success
/// };
///
/// // 경고 메시지
/// var warningBox = new UTKHelpBox()
/// {
/// Message = "주의: 되돌릴 수 없습니다.",
/// messageType = HelpBoxMessageType.Warning
/// Text = "주의: 되돌릴 수 없습니다.",
/// messageType = UTKHelpBox.MessageType.Warning
/// };
///
/// // 오류 메시지
/// var errorBox = new UTKHelpBox()
/// {
/// Message = "오류: 파일을 찾을 수 없습니다.",
/// messageType = HelpBoxMessageType.Error
/// Text = "오류: 파일을 찾을 수 없습니다.",
/// messageType = UTKHelpBox.MessageType.Error
/// };
/// </code>
/// <para><b>UXML에서 사용:</b></para>
@@ -70,6 +78,9 @@ namespace UVC.UIToolkit
/// <!-- 정보 -->
/// <utk:UTKHelpBox text="정보 메시지입니다." message-type="Info" />
///
/// <!-- 성공 -->
/// <utk:UTKHelpBox text="성공 메시지입니다." message-type="Success" />
///
/// <!-- 경고 -->
/// <utk:UTKHelpBox text="경고 메시지입니다." message-type="Warning" />
///
@@ -78,8 +89,20 @@ namespace UVC.UIToolkit
/// </ui:UXML>
/// </code>
/// </example>
/// <summary>
/// 메시지 유형
/// </summary>
public enum MessageType
{
None,
Info,
Success,
Warning,
Error
}
[UxmlElement]
public partial class UTKHelpBox : HelpBox, IDisposable
public partial class UTKHelpBox : VisualElement, IDisposable
{
#region Constants
private const string USS_PATH = "UIToolkit/Common/UTKHelpBox";
@@ -87,26 +110,35 @@ namespace UVC.UIToolkit
#region Fields
private bool _disposed;
private Label? _iconLabel;
private Label? _messageLabel;
private string _text = "";
private MessageType _messageType = MessageType.Info;
#endregion
#region Properties
/// <summary>메시지 텍스트</summary>
[UxmlAttribute("text")]
public string Message
public string Text
{
get => text;
set => text = value;
get => _text;
set
{
_text = value;
if (_messageLabel != null)
_messageLabel.text = value;
}
}
/// <summary>메시지 타입</summary>
[UxmlAttribute("message-type")]
public new HelpBoxMessageType MessageType
public MessageType messageType
{
get => base.messageType;
get => _messageType;
set
{
base.messageType = value;
UpdateMessageTypeClass();
_messageType = value;
UpdateMessageType();
}
}
#endregion
@@ -122,39 +154,73 @@ namespace UVC.UIToolkit
styleSheets.Add(uss);
}
SetupUI();
SetupStyles();
SubscribeToThemeChanges();
}
public UTKHelpBox(string message, HelpBoxMessageType type = HelpBoxMessageType.Info) : this()
public UTKHelpBox(string message, MessageType type = MessageType.Info) : this()
{
Message = message;
MessageType = type;
Text = message;
messageType = type;
}
#endregion
#region Setup
private void SetupUI()
{
// 아이콘 레이블 (Material Icon)
_iconLabel = new Label();
_iconLabel.AddToClassList("utk-helpbox__icon");
// Material Icons 폰트 적용
UTKMaterialIcons.ApplyIconStyle(_iconLabel);
// 수직 정렬
_iconLabel.style.unityTextAlign = TextAnchor.MiddleCenter;
_iconLabel.style.alignSelf = Align.Center;
Add(_iconLabel);
// 메시지 레이블
_messageLabel = new Label(_text);
_messageLabel.AddToClassList("utk-helpbox__message");
// 수직 정렬
_messageLabel.style.unityTextAlign = TextAnchor.MiddleLeft;
_messageLabel.style.alignSelf = Align.Center;
Add(_messageLabel);
}
private void SetupStyles()
{
AddToClassList("utk-helpbox");
UpdateMessageTypeClass();
UpdateMessageType();
}
private void UpdateMessageTypeClass()
private void UpdateMessageType()
{
if (_iconLabel == null || _messageLabel == null) return;
RemoveFromClassList("utk-helpbox--info");
RemoveFromClassList("utk-helpbox--success");
RemoveFromClassList("utk-helpbox--warning");
RemoveFromClassList("utk-helpbox--error");
RemoveFromClassList("utk-helpbox--none");
var typeClass = messageType switch
var (typeClass, iconText) = _messageType switch
{
HelpBoxMessageType.Warning => "utk-helpbox--warning",
HelpBoxMessageType.Error => "utk-helpbox--error",
HelpBoxMessageType.None => "utk-helpbox--none",
_ => "utk-helpbox--info"
MessageType.Success => ("utk-helpbox--success", UTKMaterialIcons.CheckCircle),
MessageType.Warning => ("utk-helpbox--warning", UTKMaterialIcons.Warning),
MessageType.Error => ("utk-helpbox--error", UTKMaterialIcons.Error),
MessageType.None => ("utk-helpbox--none", ""),
_ => ("utk-helpbox--info", UTKMaterialIcons.Info)
};
AddToClassList(typeClass);
_iconLabel.text = iconText;
_iconLabel.style.display = _messageType == MessageType.None ? DisplayStyle.None : DisplayStyle.Flex;
}
private void SubscribeToThemeChanges()