53 lines
1.9 KiB
C#
53 lines
1.9 KiB
C#
using System;
|
||
using UnityEngine;
|
||
using UnityEngine.UI;
|
||
using UnityEngine.Events;
|
||
using TMPro;
|
||
|
||
namespace BaseGames.UI
|
||
{
|
||
/// <summary>
|
||
/// 滑条控件封装：Slider + 实时数值标签 + 一行式 <see cref="Bind"/>，
|
||
/// 消除 <see cref="SettingsPanelController"/> 里"移除监听→设值→加监听→更新标签"的重复样板。
|
||
/// </summary>
|
||
[DisallowMultipleComponent]
|
||
public class UISlider : MonoBehaviour
|
||
{
|
||
[SerializeField] private Slider _slider;
|
||
[Tooltip("实时数值标签（可空）。")]
|
||
[SerializeField] private TMP_Text _valueLabel;
|
||
[Tooltip("数值标签格式（当未传 fmt 委托时使用）。例：\"{0:0}\"、\"{0:0}%\"。")]
|
||
[SerializeField] private string _format = "{0:0}";
|
||
|
||
private Func<float, string> _fmt;
|
||
|
||
public Slider Slider => _slider;
|
||
public float Value => _slider != null ? _slider.value : 0f;
|
||
|
||
/// <summary>
|
||
/// 绑定取值范围、初值与变更回调。<paramref name="fmt"/> 可自定义数值标签文本（优先于 <see cref="_format"/>）。
|
||
/// </summary>
|
||
public void Bind(float min, float max, float value, UnityAction<float> onChanged, Func<float, string> fmt = null)
|
||
{
|
||
if (_slider == null) return;
|
||
_slider.onValueChanged.RemoveAllListeners();
|
||
_slider.minValue = min;
|
||
_slider.maxValue = max;
|
||
_slider.value = Mathf.Clamp(value, min, max);
|
||
_fmt = fmt;
|
||
UpdateLabel(_slider.value);
|
||
_slider.onValueChanged.AddListener(v =>
|
||
{
|
||
onChanged?.Invoke(v);
|
||
UpdateLabel(v);
|
||
});
|
||
}
|
||
|
||
private void UpdateLabel(float v)
|
||
{
|
||
if (_valueLabel == null) return;
|
||
_valueLabel.text = _fmt != null ? _fmt(v) : string.Format(_format, v);
|
||
}
|
||
}
|
||
}
|