feat:场景视图添加属性编辑，添加轮廓显示
This commit is contained in:
m0_75251201
799
UIFrame/Utilities/ControlUtilities.cs
Normal file
799
UIFrame/Utilities/ControlUtilities.cs
Normal file
@@ -0,0 +1,799 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using TMPro;
|
||||
using UnityEngine;
|
||||
using UnityEngine.Events;
|
||||
using UnityEngine.UI;
|
||||
|
||||
namespace UIFrame.Utilities
|
||||
{
|
||||
|
||||
|
||||
[Serializable]
|
||||
public struct RectTransformConfig
|
||||
{
|
||||
public Vector2 AnchorMin;
|
||||
public Vector2 AnchorMax;
|
||||
public Vector2 AnchoredPosition;
|
||||
public Vector2 SizeDelta;
|
||||
public Vector2 OffsetMin;
|
||||
public Vector2 OffsetMax;
|
||||
public Vector2 Pivot;
|
||||
|
||||
// 默认配置
|
||||
public static readonly RectTransformConfig Default = new RectTransformConfig(
|
||||
Vector2.up, // 锚点最小：左上角 (0, 1)
|
||||
Vector2.up, // 锚点最大：左上角 (0, 1)
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 0.5f) // 默认居中轴心点
|
||||
);
|
||||
|
||||
// 填充父级的配置
|
||||
public static readonly RectTransformConfig FillParent = new RectTransformConfig(
|
||||
Vector2.zero, // 锚点最小：左下角 (0, 0)
|
||||
Vector2.one, // 锚点最大：右上角 (1, 1)
|
||||
Vector2.zero,
|
||||
Vector2.zero, // sizeDelta为零表示通过offsetMin/Max来控制尺寸
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 0.5f)
|
||||
);
|
||||
|
||||
public RectTransformConfig(
|
||||
Vector2 anchorMin,
|
||||
Vector2 anchorMax,
|
||||
Vector2 anchoredPosition,
|
||||
Vector2 sizeDelta,
|
||||
Vector2 offsetMin,
|
||||
Vector2 offsetMax,
|
||||
Vector2 pivot)
|
||||
{
|
||||
AnchorMin = anchorMin;
|
||||
AnchorMax = anchorMax;
|
||||
AnchoredPosition = anchoredPosition;
|
||||
SizeDelta = sizeDelta;
|
||||
OffsetMin = offsetMin;
|
||||
OffsetMax = offsetMax;
|
||||
Pivot = pivot;
|
||||
}
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct ButtonConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig;
|
||||
public Color BackgroundColor;
|
||||
public string Text;
|
||||
public int FontSize;
|
||||
public Color TextColor;
|
||||
public bool RaycastTarget;
|
||||
|
||||
public static readonly ButtonConfig Default = new ButtonConfig(
|
||||
RectTransformConfig.Default,
|
||||
new Color(0.2f, 0.2f, 0.2f, 1f),
|
||||
"Button",
|
||||
18,
|
||||
Color.white,
|
||||
true
|
||||
);
|
||||
|
||||
public ButtonConfig(
|
||||
RectTransformConfig rectConfig,
|
||||
Color backgroundColor,
|
||||
string text,
|
||||
int fontSize,
|
||||
Color textColor,
|
||||
bool raycastTarget = true)
|
||||
{
|
||||
RectConfig = rectConfig;
|
||||
BackgroundColor = backgroundColor;
|
||||
Text = text;
|
||||
FontSize = fontSize;
|
||||
TextColor = textColor;
|
||||
RaycastTarget = raycastTarget;
|
||||
}
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct TextConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig;
|
||||
public string Text;
|
||||
public int FontSize;
|
||||
public Color TextColor;
|
||||
public TextAlignmentOptions Alignment;
|
||||
public bool RaycastTarget;
|
||||
|
||||
public static readonly TextConfig Default = new TextConfig(
|
||||
rectConfig: RectTransformConfig.Default,
|
||||
text: "New Text",
|
||||
fontSize: 18,
|
||||
textColor: Color.white,
|
||||
alignment: TextAlignmentOptions.Center,
|
||||
raycastTarget: false
|
||||
);
|
||||
|
||||
public TextConfig(
|
||||
string text,
|
||||
int fontSize,
|
||||
Color textColor,
|
||||
TextAlignmentOptions alignment,
|
||||
bool raycastTarget,
|
||||
RectTransformConfig rectConfig)
|
||||
{
|
||||
RectConfig = rectConfig;
|
||||
Text = text;
|
||||
FontSize = fontSize;
|
||||
TextColor = textColor;
|
||||
Alignment = alignment;
|
||||
RaycastTarget = raycastTarget;
|
||||
}
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct ScrollViewConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig; // 新增：ScrollView自身的RectTransform配置
|
||||
public bool Vertical;
|
||||
public bool Horizontal;
|
||||
public Color BackgroundColor;
|
||||
public Vector2 ContentPadding; // 内容区域的内边距（上下左右）
|
||||
|
||||
public static readonly ScrollViewConfig Default = new ScrollViewConfig
|
||||
{
|
||||
RectConfig = new RectTransformConfig(
|
||||
new Vector2(0.5f, 0.5f), // 锚点最小：中心 (0.5, 0.5)
|
||||
new Vector2(0.5f, 0.5f), // 锚点最大：中心 (0.5, 0.5)
|
||||
Vector2.zero,
|
||||
new Vector2(400, 300), // 默认尺寸
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 0.5f)
|
||||
),
|
||||
Vertical = true,
|
||||
Horizontal = false,
|
||||
BackgroundColor = new Color(0.1f, 0.1f, 0.1f, 0.8f),
|
||||
ContentPadding = new Vector2(10, 10) // (horizontal, vertical)
|
||||
};
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct InputFieldConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig;
|
||||
public Color BackgroundColor;
|
||||
public string PlaceholderText;
|
||||
public int PlaceholderFontSize;
|
||||
public Color PlaceholderTextColor;
|
||||
public Color TextColor;
|
||||
public int FontSize;
|
||||
public TextAlignmentOptions TextAlignment;
|
||||
public TMP_InputField.CharacterValidation CharacterValidation;
|
||||
public int CharacterLimit;
|
||||
|
||||
public static readonly InputFieldConfig Default = new InputFieldConfig(
|
||||
RectTransformConfig.Default,
|
||||
new Color(0.2f, 0.2f, 0.2f, 1f),
|
||||
"Enter text here",
|
||||
14,
|
||||
new Color(0.7f, 0.7f, 0.7f, 1f),
|
||||
Color.white,
|
||||
18,
|
||||
TextAlignmentOptions.Left,
|
||||
TMP_InputField.CharacterValidation.None,
|
||||
0
|
||||
);
|
||||
|
||||
public InputFieldConfig(
|
||||
RectTransformConfig rectConfig,
|
||||
Color backgroundColor,
|
||||
string placeholderText,
|
||||
int placeholderFontSize,
|
||||
Color placeholderTextColor,
|
||||
Color textColor,
|
||||
int fontSize,
|
||||
TextAlignmentOptions textAlignment,
|
||||
TMP_InputField.CharacterValidation characterValidation = TMP_InputField.CharacterValidation.None,
|
||||
int characterLimit = 0)
|
||||
{
|
||||
RectConfig = rectConfig;
|
||||
BackgroundColor = backgroundColor;
|
||||
PlaceholderText = placeholderText;
|
||||
PlaceholderFontSize = placeholderFontSize;
|
||||
PlaceholderTextColor = placeholderTextColor;
|
||||
TextColor = textColor;
|
||||
FontSize = fontSize;
|
||||
TextAlignment = textAlignment;
|
||||
CharacterValidation = characterValidation;
|
||||
CharacterLimit = characterLimit;
|
||||
}
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct LabeledInputFieldConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig; // 整个控件（标签+输入框）的配置
|
||||
public string LabelText;
|
||||
public int LabelFontSize;
|
||||
public Color LabelTextColor;
|
||||
public float LabelWidth; // 标签部分的固定宽度
|
||||
public float Spacing; // 标签和输入框之间的间距
|
||||
public InputFieldConfig InputFieldConfig; // 复用已有的输入框配置
|
||||
|
||||
public static readonly LabeledInputFieldConfig Default = new LabeledInputFieldConfig
|
||||
{
|
||||
RectConfig = new RectTransformConfig(
|
||||
Vector2.up, // 锚点最小：左上角 (0, 1)
|
||||
Vector2.one, // 锚点最大：右上角 (1, 1)，默认水平拉伸
|
||||
Vector2.zero,
|
||||
new Vector2(0, 30), // 默认高度30
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 1) // 轴心点：顶部居中
|
||||
),
|
||||
LabelText = "Label",
|
||||
LabelFontSize = 18,
|
||||
LabelTextColor = Color.white,
|
||||
LabelWidth = 100f,
|
||||
Spacing = 10f,
|
||||
InputFieldConfig = InputFieldConfig.Default
|
||||
};
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct DropdownConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig;
|
||||
public List<string> Options;
|
||||
public Color BackgroundColor;
|
||||
public int CaptionFontSize; // 下拉框当前选中项的文本大小
|
||||
public Color CaptionTextColor;
|
||||
public int ItemFontSize; // 下拉列表每一项的文本大小
|
||||
public Color ItemTextColor;
|
||||
|
||||
public static readonly DropdownConfig Default = new DropdownConfig(
|
||||
new RectTransformConfig(
|
||||
new Vector2(0.5f, 0.5f), // 锚点最小：中心 (0.5, 0.5)
|
||||
new Vector2(0.5f, 0.5f), // 锚点最大：中心 (0.5, 0.5)
|
||||
Vector2.zero,
|
||||
new Vector2(160, 30),
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 0.5f)
|
||||
),
|
||||
new List<string> { "Option A", "Option B", "Option C" },
|
||||
new Color(0.2f, 0.2f, 0.2f, 1f),
|
||||
18,
|
||||
Color.white,
|
||||
16,
|
||||
Color.white
|
||||
);
|
||||
|
||||
public DropdownConfig(RectTransformConfig rectConfig, List<string> options, Color backgroundColor,
|
||||
int captionFontSize, Color captionTextColor, int itemFontSize, Color itemTextColor)
|
||||
{
|
||||
RectConfig = rectConfig;
|
||||
Options = options;
|
||||
BackgroundColor = backgroundColor;
|
||||
CaptionFontSize = captionFontSize;
|
||||
CaptionTextColor = captionTextColor;
|
||||
ItemFontSize = itemFontSize;
|
||||
ItemTextColor = itemTextColor;
|
||||
}
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct LabeledDropdownConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig;
|
||||
public string LabelText;
|
||||
public int LabelFontSize;
|
||||
public Color LabelTextColor;
|
||||
public float LabelWidth;
|
||||
public float Spacing;
|
||||
public DropdownConfig DropdownConfig;
|
||||
|
||||
public static readonly LabeledDropdownConfig Default = new LabeledDropdownConfig
|
||||
{
|
||||
RectConfig = new RectTransformConfig(
|
||||
Vector2.up, // 锚点最小：左上角 (0, 1)
|
||||
Vector2.one, // 锚点最大：右上角 (1, 1)
|
||||
Vector2.zero,
|
||||
new Vector2(0, 30),
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 1)
|
||||
),
|
||||
LabelText = "Label",
|
||||
LabelFontSize = 18,
|
||||
LabelTextColor = Color.white,
|
||||
LabelWidth = 100f,
|
||||
Spacing = 10f,
|
||||
DropdownConfig = DropdownConfig.Default
|
||||
};
|
||||
}
|
||||
|
||||
[Serializable]
|
||||
public struct ToggleConfig
|
||||
{
|
||||
public RectTransformConfig RectConfig;
|
||||
public string LabelText;
|
||||
public int LabelFontSize;
|
||||
public Color LabelTextColor;
|
||||
public Color BackgroundColor;
|
||||
public Color CheckmarkColor;
|
||||
public float Spacing; // 开关图形和标签之间的间距
|
||||
public bool IsOnByDefault;
|
||||
|
||||
public static readonly ToggleConfig Default = new ToggleConfig
|
||||
{
|
||||
RectConfig = new RectTransformConfig(
|
||||
Vector2.up, // 锚点最小：左上角 (0, 1)
|
||||
Vector2.up, // 锚点最大：左上角 (0, 1)
|
||||
Vector2.zero,
|
||||
new Vector2(160, 20),
|
||||
Vector2.zero,
|
||||
Vector2.zero,
|
||||
new Vector2(0.5f, 0.5f)
|
||||
),
|
||||
LabelText = "Toggle",
|
||||
LabelFontSize = 18,
|
||||
LabelTextColor = Color.white,
|
||||
BackgroundColor = new Color(0.2f, 0.2f, 0.2f, 1f),
|
||||
CheckmarkColor = new Color(0.1f, 0.6f, 1f, 1f),
|
||||
Spacing = 10f,
|
||||
IsOnByDefault = false
|
||||
};
|
||||
}
|
||||
|
||||
public static class ControlUtilities
|
||||
{
|
||||
// 通用方法：将 RectTransformConfig 应用于 RectTransform
|
||||
private static void ApplyRectTransformConfig(RectTransform rectTransform, RectTransformConfig config)
|
||||
{
|
||||
rectTransform.anchorMin = config.AnchorMin;
|
||||
rectTransform.anchorMax = config.AnchorMax;
|
||||
rectTransform.pivot = config.Pivot;
|
||||
|
||||
// 当sizeDelta为Vector2.zero时，我们假定用户希望通过offsetMin/Max来拉伸元素
|
||||
// 否则使用anchoredPosition和sizeDelta来定位和设置尺寸
|
||||
if (config.SizeDelta == Vector2.zero && (config.OffsetMin != Vector2.zero ||
|
||||
config.OffsetMax != Vector2.zero ||
|
||||
(config.AnchorMin == Vector2.zero &&
|
||||
config.AnchorMax == Vector2.one)))
|
||||
{
|
||||
rectTransform.offsetMin = config.OffsetMin;
|
||||
rectTransform.offsetMax = config.OffsetMax;
|
||||
}
|
||||
else
|
||||
{
|
||||
rectTransform.anchoredPosition = config.AnchoredPosition;
|
||||
rectTransform.sizeDelta = config.SizeDelta;
|
||||
}
|
||||
}
|
||||
|
||||
// ========================
|
||||
// 矩形对象创建
|
||||
// ========================
|
||||
/// <summary>
|
||||
/// 创建一个带有 RectTransform 组件的空 GameObject。
|
||||
/// </summary>
|
||||
/// <param name="parent">父级 Transform。</param>
|
||||
/// <param name="name">GameObject 的名称。</param>
|
||||
/// <param name="config">RectTransform 的配置。</param>
|
||||
/// <returns>创建的 RectTransform 组件。</returns>
|
||||
public static RectTransform CreateRect(Transform parent, string name, RectTransformConfig config)
|
||||
{
|
||||
var obj = new GameObject(name);
|
||||
var rect = obj.AddComponent<RectTransform>();
|
||||
rect.SetParent(parent, false); // false表示不保留世界坐标，而是以父级为基准
|
||||
ApplyRectTransformConfig(rect, config);
|
||||
return rect;
|
||||
}
|
||||
|
||||
// ========================
|
||||
// 按钮创建
|
||||
// ========================
|
||||
public static (Button? button, TextMeshProUGUI? text) CreateButton(RectTransform? parent, ButtonConfig config,
|
||||
UnityAction? onClick)
|
||||
{
|
||||
// 使用 CreateRect 创建按钮根对象并应用配置
|
||||
var btnRect = CreateRect(parent, config.Text + "Button", config.RectConfig);
|
||||
|
||||
var button = btnRect.gameObject.AddComponent<Button>();
|
||||
var image = btnRect.gameObject.AddComponent<Image>();
|
||||
image.color = config.BackgroundColor;
|
||||
button.image = image;
|
||||
|
||||
// 创建文本子对象，并使其填充按钮
|
||||
var txtRect = CreateRect(btnRect, "Text (TMP)", RectTransformConfig.FillParent);
|
||||
|
||||
var tmpText = txtRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
tmpText.text = config.Text;
|
||||
tmpText.color = config.TextColor;
|
||||
tmpText.alignment = TextAlignmentOptions.Center;
|
||||
tmpText.fontSize = config.FontSize;
|
||||
tmpText.raycastTarget = config.RaycastTarget; // 文本RaycastTarget通常为false，除非文本本身需要互动
|
||||
if (onClick != null)
|
||||
button.onClick.AddListener(onClick);
|
||||
return (button, tmpText);
|
||||
}
|
||||
|
||||
// ========================
|
||||
// 文本创建（重载）
|
||||
// ========================
|
||||
public static TextMeshProUGUI CreateText(Transform parent, string text)
|
||||
{
|
||||
var config = TextConfig.Default;
|
||||
config.Text = text;
|
||||
return CreateText(parent, config);
|
||||
}
|
||||
|
||||
public static TextMeshProUGUI CreateText(Transform parent, TextConfig config)
|
||||
{
|
||||
// 使用 CreateRect 创建文本对象并应用配置
|
||||
var textRect = CreateRect(parent, config.Text + "Text", config.RectConfig);
|
||||
|
||||
var tmpText = textRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
tmpText.text = config.Text;
|
||||
tmpText.color = config.TextColor;
|
||||
tmpText.alignment = config.Alignment;
|
||||
tmpText.fontSize = config.FontSize;
|
||||
tmpText.raycastTarget = config.RaycastTarget;
|
||||
|
||||
return tmpText;
|
||||
}
|
||||
|
||||
// ========================
|
||||
// 滚动视图创建
|
||||
// ========================
|
||||
public static (ScrollRect scrollRect, RectTransform content) CreateScrollView(
|
||||
Transform parent,
|
||||
ScrollViewConfig config)
|
||||
{
|
||||
// 1. ScrollView 根对象
|
||||
var scrollViewRect = CreateRect(parent, "ScrollView", config.RectConfig);
|
||||
|
||||
var scrollView = scrollViewRect.gameObject.AddComponent<ScrollRect>();
|
||||
var scrollViewImage = scrollViewRect.gameObject.AddComponent<Image>();
|
||||
scrollViewImage.color = config.BackgroundColor;
|
||||
scrollViewImage.raycastTarget = true;
|
||||
|
||||
// 2. Viewport 子对象 (始终填充 ScrollView)
|
||||
var viewportRect = CreateRect(scrollViewRect, "Viewport", RectTransformConfig.FillParent);
|
||||
|
||||
viewportRect.gameObject.AddComponent<RectMask2D>(); // 或 Mask，但 RectMask2D 性能更好
|
||||
var viewportImage = viewportRect.gameObject.AddComponent<Image>();
|
||||
viewportImage.color = Color.clear; // 透明背景
|
||||
|
||||
// 3. Content 子对象
|
||||
var contentRect =
|
||||
CreateRect(viewportRect, "Content", RectTransformConfig.Default); // 初始使用Default，后续会根据滚动方向调整
|
||||
|
||||
// 设置 Content 的锚点：根据滚动方向决定
|
||||
if (config.Vertical && !config.Horizontal)
|
||||
{
|
||||
// 垂直滚动：宽度拉满，高度自适应
|
||||
contentRect.anchorMin = new Vector2(0, 1);
|
||||
contentRect.anchorMax = new Vector2(1, 1);
|
||||
contentRect.pivot = new Vector2(0.5f, 1);
|
||||
contentRect.anchoredPosition = new Vector2(0, -config.ContentPadding.y);
|
||||
contentRect.sizeDelta = new Vector2(-2 * config.ContentPadding.x, 0); // 左右留边距
|
||||
// 添加 VerticalLayoutGroup 通常是需要的，但这里只创建基础结构
|
||||
}
|
||||
else if (config.Horizontal && !config.Vertical)
|
||||
{
|
||||
// 水平滚动：高度拉满，宽度自适应
|
||||
contentRect.anchorMin = new Vector2(0, 0);
|
||||
contentRect.anchorMax = new Vector2(0, 1);
|
||||
contentRect.pivot = new Vector2(0, 0.5f);
|
||||
contentRect.anchoredPosition = new Vector2(config.ContentPadding.x, 0);
|
||||
contentRect.sizeDelta = new Vector2(0, -2 * config.ContentPadding.y);
|
||||
// 添加 HorizontalLayoutGroup 通常是需要的
|
||||
}
|
||||
else
|
||||
{
|
||||
// 双向滚动：自由布局，通常锚点设为左上角
|
||||
contentRect.anchorMin = new Vector2(0, 1);
|
||||
contentRect.anchorMax = new Vector2(0, 1);
|
||||
contentRect.pivot = new Vector2(0, 1);
|
||||
contentRect.anchoredPosition = new Vector2(config.ContentPadding.x, -config.ContentPadding.y);
|
||||
contentRect.sizeDelta = new Vector2(0, 0); // 自适应
|
||||
}
|
||||
|
||||
// 4. 关联 ScrollRect
|
||||
scrollView.viewport = viewportRect;
|
||||
scrollView.content = contentRect;
|
||||
scrollView.vertical = config.Vertical;
|
||||
scrollView.horizontal = config.Horizontal;
|
||||
scrollView.movementType = ScrollRect.MovementType.Elastic;
|
||||
scrollView.inertia = true;
|
||||
scrollView.decelerationRate = 0.135f; // 默认值
|
||||
|
||||
return (scrollView, contentRect);
|
||||
}
|
||||
|
||||
// ========================
|
||||
// 文本编辑器创建
|
||||
// ========================
|
||||
public static (TMP_InputField inputField, TextMeshProUGUI text) CreateInputField(Transform parent,
|
||||
InputFieldConfig config)
|
||||
{
|
||||
// 使用 CreateRect 创建输入框根对象并应用配置
|
||||
var inputFieldRect = CreateRect(parent, "InputField", config.RectConfig);
|
||||
|
||||
var inputField = inputFieldRect.gameObject.AddComponent<TMP_InputField>();
|
||||
|
||||
// 背景图像
|
||||
var backgroundImage = inputFieldRect.gameObject.AddComponent<Image>();
|
||||
// 注意：Resources.Load 会在运行时加载，推荐通过 Inspector 赋值或使用 Addressables
|
||||
// 为了保持原有功能，暂时保留，如果提示找不到，请确保路径正确或导入默认UI资源
|
||||
backgroundImage.sprite = Resources.Load<Sprite>("UI/Skins/Background");
|
||||
backgroundImage.type = Image.Type.Sliced;
|
||||
backgroundImage.color = config.BackgroundColor;
|
||||
inputField.image = backgroundImage; // 设置TMP_InputField的图片引用
|
||||
|
||||
// 输入框文本组件 (始终填充输入框)
|
||||
var textRect = CreateRect(inputFieldRect, "Text (TMP)", RectTransformConfig.FillParent);
|
||||
|
||||
var tmpText = textRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
tmpText.text = "";
|
||||
tmpText.color = config.TextColor;
|
||||
tmpText.alignment = config.TextAlignment;
|
||||
tmpText.fontSize = config.FontSize;
|
||||
tmpText.raycastTarget = false; // 输入框内的文本通常不需要射线检测
|
||||
inputField.textComponent = tmpText; // 设置TMP_InputField的文字组件引用
|
||||
|
||||
// 占位符文本组件 (始终填充输入框)
|
||||
var placeholderRect = CreateRect(inputFieldRect, "Placeholder", RectTransformConfig.FillParent);
|
||||
|
||||
var placeholderText = placeholderRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
placeholderText.text = config.PlaceholderText;
|
||||
placeholderText.color = config.PlaceholderTextColor;
|
||||
placeholderText.alignment = config.TextAlignment;
|
||||
placeholderText.fontSize = config.PlaceholderFontSize;
|
||||
placeholderText.raycastTarget = false; // 占位符通常不需要射线检测
|
||||
inputField.placeholder = placeholderText; // 设置TMP_InputField的占位符引用
|
||||
|
||||
// 配置输入字段属性
|
||||
inputField.characterValidation = config.CharacterValidation;
|
||||
inputField.characterLimit = config.CharacterLimit;
|
||||
|
||||
return (inputField, tmpText);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建一个网格布局容器，用于自动排列子对象。
|
||||
/// </summary>
|
||||
/// <param name="parent">父级 Transform。</param>
|
||||
/// <param name="name">GameObject 名称。</param>
|
||||
/// <param name="rectConfig">容器的 RectTransform 配置。</param>
|
||||
/// <param name="constraintCount">每行或每列的元素数量。</param>
|
||||
/// <param name="cellSize">每个单元格的大小。</param>
|
||||
/// <param name="spacing">单元格之间的间距。</param>
|
||||
/// <param name="constraint">约束类型（按行数或列数）。</param>
|
||||
/// <returns>创建的网格容器的 RectTransform。</returns>
|
||||
public static RectTransform CreateGridLayoutContainer(
|
||||
Transform parent,
|
||||
string name,
|
||||
RectTransformConfig rectConfig,
|
||||
int constraintCount,
|
||||
Vector2 cellSize,
|
||||
Vector2 spacing,
|
||||
GridLayoutGroup.Constraint constraint = GridLayoutGroup.Constraint.FixedColumnCount)
|
||||
{
|
||||
var containerRect = CreateRect(parent, name, rectConfig);
|
||||
var gridLayout = containerRect.gameObject.AddComponent<GridLayoutGroup>();
|
||||
|
||||
gridLayout.constraint = constraint;
|
||||
if (constraint == GridLayoutGroup.Constraint.FixedColumnCount)
|
||||
gridLayout.constraintCount = constraintCount;
|
||||
else if (constraint == GridLayoutGroup.Constraint.FixedRowCount)
|
||||
gridLayout.constraintCount = constraintCount;
|
||||
|
||||
gridLayout.cellSize = cellSize;
|
||||
gridLayout.spacing = spacing;
|
||||
|
||||
return containerRect;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建一个带标签的输入框（左边文字，右边输入）。
|
||||
/// </summary>
|
||||
/// <param name="parent">父级 Transform。</param>
|
||||
/// <param name="config">控件配置。</param>
|
||||
/// <returns>包含根对象、标签和输入框的元组。</returns>
|
||||
public static (RectTransform root, TextMeshProUGUI label, TMP_InputField inputField) CreateLabeledInputField(
|
||||
Transform parent, LabeledInputFieldConfig config)
|
||||
{
|
||||
// 1. 创建根容器并添加水平布局
|
||||
var rootRect = CreateRect(parent, config.LabelText + " LabeledInput", config.RectConfig);
|
||||
var layoutGroup = rootRect.gameObject.AddComponent<HorizontalLayoutGroup>();
|
||||
layoutGroup.childControlWidth = true;
|
||||
layoutGroup.childControlHeight = true;
|
||||
layoutGroup.childForceExpandWidth = false;
|
||||
layoutGroup.spacing = config.Spacing;
|
||||
|
||||
// 2. 创建标签
|
||||
var labelConfig = new TextConfig(
|
||||
config.LabelText,
|
||||
config.LabelFontSize,
|
||||
config.LabelTextColor,
|
||||
TextAlignmentOptions.Left,
|
||||
false,
|
||||
RectTransformConfig.Default // RectTransform由LayoutGroup控制
|
||||
);
|
||||
var label = CreateText(rootRect, labelConfig);
|
||||
var labelLayout = label.gameObject.AddComponent<LayoutElement>();
|
||||
labelLayout.preferredWidth = config.LabelWidth;
|
||||
labelLayout.flexibleWidth = 0; // 不参与弹性宽度分配
|
||||
// 3. 创建输入框
|
||||
var (inputField, _) = CreateInputField(rootRect, config.InputFieldConfig);
|
||||
var inputLayout = inputField.gameObject.AddComponent<LayoutElement>();
|
||||
inputLayout.flexibleWidth = 1; // 占据剩余所有宽度
|
||||
return (rootRect, label, inputField);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建一个下拉框控件。
|
||||
/// </summary>
|
||||
/// <param name="parent">父级 Transform。</param>
|
||||
/// <param name="config">控件配置。</param>
|
||||
/// <returns>包含下拉框组件和其主标签的元组。</returns>
|
||||
public static (TMP_Dropdown dropdown, TextMeshProUGUI captionText) CreateDropdown(Transform parent,
|
||||
DropdownConfig config)
|
||||
{
|
||||
// Unity 从代码创建 Dropdown 比较繁琐，因为它依赖于一个预设的模板结构。
|
||||
// 以下代码将手动构建这个结构。
|
||||
|
||||
// 1. Root Dropdown Object
|
||||
var dropdownRect = CreateRect(parent, "Dropdown", config.RectConfig);
|
||||
var dropdownImage = dropdownRect.gameObject.AddComponent<Image>();
|
||||
dropdownImage.color = config.BackgroundColor;
|
||||
var dropdown = dropdownRect.gameObject.AddComponent<TMP_Dropdown>();
|
||||
// 2. Label (Caption Text)
|
||||
var labelRect = CreateRect(dropdownRect, "Label", RectTransformConfig.FillParent);
|
||||
labelRect.offsetMin = new Vector2(10, 0);
|
||||
labelRect.offsetMax = new Vector2(-25, 0);
|
||||
var labelText = labelRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
labelText.alignment = TextAlignmentOptions.Left;
|
||||
labelText.color = config.CaptionTextColor;
|
||||
labelText.fontSize = config.CaptionFontSize;
|
||||
dropdown.captionText = labelText;
|
||||
// 3. Arrow
|
||||
var arrowRect = CreateRect(dropdownRect, "Arrow", new RectTransformConfig(
|
||||
new Vector2(1, 0.5f), new Vector2(1, 0.5f), new Vector2(-15, 0), new Vector2(20, 20), Vector2.zero,
|
||||
Vector2.zero, new Vector2(0.5f, 0.5f)
|
||||
));
|
||||
var arrowImage = arrowRect.gameObject.AddComponent<Image>();
|
||||
arrowImage.color = new Color(0.8f, 0.8f, 0.8f); // 默认箭头颜色
|
||||
// 4. Template (Scroll View, the dropdown list) - 必须默认禁用
|
||||
var templateRect = CreateRect(dropdownRect, "Template", new RectTransformConfig(
|
||||
new Vector2(0, 0), new Vector2(1, 0), new Vector2(0, 2), new Vector2(0, 150), Vector2.zero,
|
||||
Vector2.zero, new Vector2(0.5f, 1)
|
||||
));
|
||||
var templateImage = templateRect.gameObject.AddComponent<Image>();
|
||||
templateImage.color = config.BackgroundColor;
|
||||
var scrollRect = templateRect.gameObject.AddComponent<ScrollRect>();
|
||||
scrollRect.movementType = ScrollRect.MovementType.Clamped;
|
||||
templateRect.gameObject.SetActive(false);
|
||||
dropdown.template = templateRect;
|
||||
|
||||
// 5. Viewport
|
||||
var viewportRect = CreateRect(templateRect, "Viewport", RectTransformConfig.FillParent);
|
||||
viewportRect.gameObject.AddComponent<RectMask2D>();
|
||||
scrollRect.viewport = viewportRect;
|
||||
|
||||
// 6. Content
|
||||
var contentRect = CreateRect(viewportRect, "Content", new RectTransformConfig(
|
||||
new Vector2(0, 1), new Vector2(1, 1), Vector2.zero, new Vector2(0, 28), Vector2.zero, Vector2.zero,
|
||||
new Vector2(0.5f, 1)
|
||||
));
|
||||
scrollRect.content = contentRect;
|
||||
|
||||
// 7. Item (The template for each option)
|
||||
var itemRect = CreateRect(contentRect, "Item", new RectTransformConfig(
|
||||
new Vector2(0, 1), new Vector2(1, 1), Vector2.zero, new Vector2(0, 20), Vector2.zero, Vector2.zero,
|
||||
new Vector2(0.5f, 1)
|
||||
));
|
||||
var itemToggle = itemRect.gameObject.AddComponent<Toggle>();
|
||||
itemToggle.targetGraphic = itemRect.gameObject.AddComponent<Image>(); // Add an image to be the background
|
||||
|
||||
var itemLabelRect = CreateRect(itemRect, "Item Label", RectTransformConfig.FillParent);
|
||||
itemLabelRect.offsetMin = new Vector2(10, 0);
|
||||
itemLabelRect.offsetMax = new Vector2(-10, 0);
|
||||
var itemLabel = itemLabelRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
itemLabel.color = config.ItemTextColor;
|
||||
itemLabel.fontSize = config.ItemFontSize;
|
||||
dropdown.itemText = itemLabel;
|
||||
// 8. Populate options
|
||||
dropdown.ClearOptions();
|
||||
dropdown.AddOptions(config.Options);
|
||||
return (dropdown, labelText);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建一个带标签的下拉框（左边文字，右边下拉）。
|
||||
/// </summary>
|
||||
/// <param name="parent">父级 Transform。</param>
|
||||
/// <param name="config">控件配置。</param>
|
||||
/// <returns>包含根对象、标签和下拉框的元组。</returns>
|
||||
public static (RectTransform root, TextMeshProUGUI label, TMP_Dropdown dropdown) CreateLabeledDropdown(
|
||||
Transform parent, LabeledDropdownConfig config)
|
||||
{
|
||||
// 1. 创建根容器并添加水平布局
|
||||
var rootRect = CreateRect(parent, config.LabelText + " LabeledDropdown", config.RectConfig);
|
||||
var layoutGroup = rootRect.gameObject.AddComponent<HorizontalLayoutGroup>();
|
||||
layoutGroup.childControlWidth = true;
|
||||
layoutGroup.childControlHeight = true;
|
||||
layoutGroup.childForceExpandWidth = true;
|
||||
layoutGroup.spacing = config.Spacing;
|
||||
|
||||
// 2. 创建标签
|
||||
var labelConfig = new TextConfig(
|
||||
config.LabelText,
|
||||
config.LabelFontSize,
|
||||
config.LabelTextColor,
|
||||
TextAlignmentOptions.Left,
|
||||
false,
|
||||
RectTransformConfig.Default
|
||||
);
|
||||
var label = CreateText(rootRect, labelConfig);
|
||||
var labelLayout = label.gameObject.AddComponent<LayoutElement>();
|
||||
labelLayout.preferredWidth = config.LabelWidth;
|
||||
labelLayout.flexibleWidth = 0;
|
||||
// 3. 创建下拉框
|
||||
var (dropdown, _) = CreateDropdown(rootRect, config.DropdownConfig);
|
||||
var dropdownLayout = dropdown.gameObject.AddComponent<LayoutElement>();
|
||||
dropdownLayout.flexibleWidth = 1;
|
||||
return (rootRect, label, dropdown);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 创建一个切换开关控件。
|
||||
/// </summary>
|
||||
/// <param name="parent">父级 Transform。</param>
|
||||
/// <param name="config">控件配置。</param>
|
||||
/// <returns>包含Toggle组件、标签和勾选标记图像的元组。</returns>
|
||||
public static (Toggle toggle, TextMeshProUGUI label, Image checkmark) CreateToggle(Transform parent,
|
||||
ToggleConfig config)
|
||||
{
|
||||
// 1. Root Toggle Object
|
||||
var toggleRect = CreateRect(parent, "Toggle", config.RectConfig);
|
||||
var toggle = toggleRect.gameObject.AddComponent<Toggle>();
|
||||
toggle.isOn = config.IsOnByDefault;
|
||||
// 2. Background
|
||||
var backgroundRect = CreateRect(toggleRect, "Background", new RectTransformConfig(
|
||||
new Vector2(0, 0.5f), new Vector2(0, 0.5f), Vector2.zero, new Vector2(20, 20), Vector2.zero,
|
||||
Vector2.zero, new Vector2(0, 0.5f)
|
||||
));
|
||||
var backgroundImage = backgroundRect.gameObject.AddComponent<Image>();
|
||||
backgroundImage.color = config.BackgroundColor;
|
||||
toggle.targetGraphic = backgroundImage;
|
||||
|
||||
// 3. Checkmark
|
||||
var checkmarkRect = CreateRect(backgroundRect, "Checkmark", RectTransformConfig.FillParent);
|
||||
checkmarkRect.offsetMin = new Vector2(3, 3);
|
||||
checkmarkRect.offsetMax = new Vector2(-3, -3);
|
||||
var checkmarkImage = checkmarkRect.gameObject.AddComponent<Image>();
|
||||
checkmarkImage.color = config.CheckmarkColor;
|
||||
toggle.graphic = checkmarkImage;
|
||||
|
||||
// 4. Label
|
||||
var labelRect = CreateRect(toggleRect, "Label", new RectTransformConfig(
|
||||
new Vector2(0, 0), new Vector2(1, 1), Vector2.zero, new Vector2(-config.Spacing - 20, 0),
|
||||
new Vector2(config.Spacing + 20, 0), Vector2.zero, new Vector2(0, 0.5f)
|
||||
));
|
||||
var label = labelRect.gameObject.AddComponent<TextMeshProUGUI>();
|
||||
label.text = config.LabelText;
|
||||
label.color = config.LabelTextColor;
|
||||
label.fontSize = config.LabelFontSize;
|
||||
label.alignment = TextAlignmentOptions.Left;
|
||||
|
||||
return (toggle, label, checkmarkImage);
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user