69 lines
2.8 KiB
C#
69 lines
2.8 KiB
C#
using UnityEngine;
|
||
using UnityEngine.UI;
|
||
|
||
namespace UI
|
||
{
|
||
public class BarUI : MonoBehaviour
|
||
{
|
||
[SerializeField] private Image image;
|
||
|
||
[Header("Progress Gradient")] [SerializeField]
|
||
private Gradient progressGradient; // 用于定义多色进度渐变
|
||
|
||
[Header("Editor Preview")] [SerializeField] [Range(0, 1)]
|
||
private float _editorProgressPreview = 0f; // 用于在编辑器中预览的进度值
|
||
|
||
/// <summary>
|
||
/// 获取或设置进度条的当前进度 (0-1)。
|
||
/// 设置时会同时更新进度条的填充量和根据渐变更新颜色。
|
||
/// </summary>
|
||
public float Progress
|
||
{
|
||
get => image.fillAmount;
|
||
set
|
||
{
|
||
// 在运行时检查image是否已赋值
|
||
if (image == null)
|
||
{
|
||
Debug.LogWarning("BarUI: Image reference is not set! Cannot update progress or color.", this);
|
||
return;
|
||
}
|
||
|
||
// 确保进度值在0到1之间，防止出现异常情况
|
||
float clampedValue = Mathf.Clamp01(value);
|
||
image.fillAmount = clampedValue;
|
||
|
||
// 使用Gradient的Evaluate方法根据进度值获取对应的渐变颜色
|
||
// Unity编辑器会自动为Gradient字段初始化一个默认实例，但在某些特殊运行时情况下，
|
||
// 还是可以加一个null检查以增加健壮性。
|
||
if (progressGradient != null)
|
||
{
|
||
image.color = progressGradient.Evaluate(clampedValue);
|
||
}
|
||
else
|
||
{
|
||
// 如果梯度未定义（极少发生），则使用默认颜色并发出警告
|
||
Debug.LogWarning("BarUI: Progress Gradient is not set! Using default white color.", this);
|
||
image.color = Color.white;
|
||
}
|
||
}
|
||
}
|
||
|
||
// OnValidate是Unity编辑器特有的方法，当脚本实例在编辑器中被加载或Inspector中的数据被修改时调用
|
||
private void OnValidate()
|
||
{
|
||
// 只有当存在Image引用时才进行更新，避免在编辑器中因未赋值而引发NullReferenceException
|
||
if (image != null)
|
||
{
|
||
// 在编辑器中修改_editorProgressPreview时，同步更新实际的Progress
|
||
// 这会触发Progress属性的setter，进而更新fillAmount和color
|
||
Progress = _editorProgressPreview;
|
||
}
|
||
else
|
||
{
|
||
// 在编辑器中未分配Image时给出提示，防止用户迷惑
|
||
Debug.LogWarning("BarUI: Image reference is not assigned. Editor preview disabled.", this);
|
||
}
|
||
}
|
||
}
|
||
} |