78 lines
2.5 KiB
C#
78 lines
2.5 KiB
C#
using System;
|
||
using TMPro;
|
||
using UnityEngine;
|
||
using UnityEngine.EventSystems;
|
||
using UnityEngine.UI;
|
||
|
||
namespace Cielonos.Settings.UI
|
||
{
|
||
/// <summary>
|
||
/// 按钮型设置条目。不绑定到数据字段，而是执行指定的点击动作。
|
||
/// <para>
|
||
/// 典型用途：打开二级 UIPage（如 Key Binding 页面）、触发重置操作等。
|
||
/// 支持鼠标悬停说明面板。
|
||
/// </para>
|
||
/// </summary>
|
||
public class SettingsEntryButton : MonoBehaviour, IPointerEnterHandler, IPointerExitHandler
|
||
{
|
||
[SerializeField] private TMP_Text labelText;
|
||
[SerializeField] private Button button;
|
||
|
||
private Action onClickAction;
|
||
|
||
/// <summary>条目的显示标题。</summary>
|
||
public string DisplayLabel { get; private set; }
|
||
|
||
/// <summary>条目的说明文本（可为空）。</summary>
|
||
public string Description { get; private set; }
|
||
|
||
/// <summary>鼠标悬停进入时触发。由 SettingsUIPage 设置。</summary>
|
||
public Action<string, string> OnHoverEnter { get; set; }
|
||
|
||
/// <summary>鼠标悬停离开时触发。由 SettingsUIPage 设置。</summary>
|
||
public Action OnHoverExit { get; set; }
|
||
|
||
/// <summary>
|
||
/// 初始化按钮条目。
|
||
/// </summary>
|
||
/// <param name="label">显示标题。</param>
|
||
/// <param name="description">悬停说明文本（可为空）。</param>
|
||
/// <param name="onClick">点击按钮时执行的动作。</param>
|
||
public void Initialize(string label, string description, Action onClick)
|
||
{
|
||
DisplayLabel = label;
|
||
Description = description;
|
||
onClickAction = onClick;
|
||
|
||
if (labelText != null)
|
||
labelText.text = label;
|
||
|
||
if (button != null)
|
||
button.onClick.AddListener(OnButtonClicked);
|
||
}
|
||
|
||
private void OnButtonClicked()
|
||
{
|
||
onClickAction?.Invoke();
|
||
}
|
||
|
||
// ──────────────────── 悬停事件 ────────────────────
|
||
|
||
public void OnPointerEnter(PointerEventData eventData)
|
||
{
|
||
OnHoverEnter?.Invoke(DisplayLabel, Description);
|
||
}
|
||
|
||
public void OnPointerExit(PointerEventData eventData)
|
||
{
|
||
OnHoverExit?.Invoke();
|
||
}
|
||
|
||
private void OnDestroy()
|
||
{
|
||
if (button != null)
|
||
button.onClick.RemoveListener(OnButtonClicked);
|
||
}
|
||
}
|
||
}
|