UGUI 原理与核心机制:Canvas、RectTransform、布局、事件与网格

6453 字
32 分钟
UGUI 原理与核心机制:Canvas、RectTransform、布局、事件与网格

本文讲 UGUI 的工作原理。性能问题(Rebuild、合批、过度绘制)见 UGUI 性能优化,项目中的 UI 架构见 UI 框架设计。

一、整体结构#

UGUI 由几个分工明确的部分组成:

部分代表组件职责
画布Canvas、CanvasScaler决定 UI 怎么渲染、渲染在哪、怎么适配屏幕;负责把下面的元素合批
布局RectTransform、LayoutGroup、ContentSizeFitter决定每个元素的位置和大小
图形Image、RawImage、Text(都继承自 Graphic)生成自己的网格和材质
遮罩Mask、RectMask2D裁剪子元素
交互EventSystem、InputModule、GraphicRaycaster把输入转换成点击、拖拽等事件,发给对应的元素
控件Button、Toggle、ScrollRect、InputField组合上面的能力,实现具体交互

一个 Image 是怎么显示出来的#

1. 属性变化(换图、改颜色、改大小)
↓ 标记为"脏",登记到 CanvasUpdateRegistry
2. 渲染前,Canvas 统一处理所有脏元素:
↓ 先执行布局(计算 RectTransform 的大小和位置)
↓ 再重建图形:Graphic 通过 VertexHelper 生成顶点,交给 CanvasRenderer
3. Canvas 收集所有元素的网格,排序、合批(原生代码中执行)
↓
4. 提交渲染

第 2 步是 Rebuild,第 3 步是 Rebatch,它们的开销和优化见 UGUI 性能优化。

二、Canvas#

三种渲染模式#

模式原理特点适合
Screen Space - Overlay不经过相机,在所有相机渲染完之后直接画在屏幕最上层简单,永远在最上面;3D 物体、粒子无法显示在 UI 之上大部分 2D 界面
Screen Space - Camera由指定的相机渲染,Canvas 放在相机前方一定距离(Plane Distance)的平面上可以和粒子、3D 模型穿插排序,可以受后处理影响需要在 UI 中显示粒子特效、3D 模型
World SpaceCanvas 就是场景中的一个物体,有自己的位置、旋转和缩放会被 3D 物体遮挡,有透视头顶血条、场景中的告示牌、VR 中的界面
  • Camera 模式下如果没有指定相机,会退化成和 Overlay 一样的效果。
  • URP 中常用的做法是相机堆叠:主相机渲染场景,再叠加一个专门渲染 UI 的 Overlay 相机,UI Canvas 使用 Camera 模式指向它。
  • World Space 的 Canvas 要接收点击,需要设置 Event Camera。

Canvas Scaler#

模式行为
Constant Pixel SizeUI 元素保持固定的像素大小,屏幕越大,UI 显得越小
Scale With Screen Size以参考分辨率为基准,按屏幕大小整体缩放。最常用
Constant Physical Size按物理尺寸(厘米、英寸)保持大小

Scale With Screen Size 的 Match 参数决定按宽度还是高度缩放,具体的适配做法见 UI 框架设计。

排序#

  • 多个 Canvas 之间按 Sorting Layer 和 Order in Layer(sortingOrder)排序,数值大的在上面。
  • 子 Canvas 勾选 Override Sorting 后,可以使用自己的排序值,而不是跟随父 Canvas。
  • 同一个 Canvas 内,按 Hierarchy 中的顺序绘制:越靠下的越后画,显示在越上层。可以用 SetAsLastSibling() 把元素调到最上层。

UI 中的粒子特效#

粒子系统不是 UI 元素,它的渲染顺序由自己的 Renderer 的 sortingOrder 决定:

  • Overlay 模式:粒子由相机渲染,而 Overlay 的 UI 在所有相机之后绘制,所以粒子永远在 UI 下面。
  • Camera 模式:粒子和 Canvas 一起排序。把粒子的 sortingOrder 设置在两个 Canvas 之间,就能夹在两层 UI 中间。

所以需要”UI - 特效 - UI”穿插的项目,一般使用 Camera 模式,并给每个界面和特效分配排序值。另一种做法是使用把粒子转换成 UI 网格来绘制的插件,让粒子像普通 UI 元素一样参与排序和遮罩。

三、RectTransform#

核心概念#

RectTransform 在 Transform 的基础上,增加了矩形区域和相对于父节点的定位方式:

属性含义
锚点 anchorMin / anchorMax在父节点矩形中的位置,取值 0 到 1。决定自己跟随父节点的哪部分移动和拉伸
轴心 pivot自身的中心点,取值 0 到 1。旋转、缩放围绕它进行,位置也以它为准
anchoredPosition轴心相对于锚点参考位置的偏移
sizeDelta自身大小比锚点区域大多少
offsetMin / offsetMax左下角、右上角相对于对应锚点的偏移
rect计算后的实际矩形(只读),rect.width / rect.height 是真实大小

两种情况#

锚点重合(固定大小):anchorMin == anchorMax,锚点是父节点中的一个点。

父节点
┌────────────────────────────┐
│ A │
│ ┌───────┐ │
│ │ P │ │
│ └───────┘ │
└────────────────────────────┘
  • A:锚点,位于父节点的右上角 (1, 1);P:轴心。
  • anchoredPosition = 轴心 P 相对锚点 A 的偏移;sizeDelta = 自身的宽高。

父节点变大时,元素跟着右上角移动,自身大小不变。适合按钮、图标。

锚点分开(拉伸):anchorMin != anchorMax,锚点是父节点中的一块区域。

父节点
┌────────────────────────────┐
│ A────────────────────────A │
│ │ ┌──────────────┐ │ │
│ │ │ │ │ │
│ │ └──────────────┘ │ │
│ A────────────────────────A │
└────────────────────────────┘
  • 四个 A 围成锚点区域,横向铺满父节点 (0, y) ~ (1, y)。
  • 元素在锚点区域内左右各留出一段距离,sizeDelta.x = 实际宽度 − 锚点区域宽度(这里为负数)。

父节点变宽时,元素跟着拉宽,左右边距保持不变。适合背景、标题栏、列表。

计算公式#

以宽度方向为例:

实际宽度 = (anchorMax.x - anchorMin.x) × 父节点宽度 + sizeDelta.x

所以:

  • 锚点重合时,锚点区域宽度为 0,sizeDelta 就是实际大小。
  • 锚点分开时,sizeDelta 不是实际大小,只是相对于锚点区域的差值。直接读 sizeDelta 当宽度用,是很常见的 Bug。

常用操作#

var rt = (RectTransform)transform;
float width = rt.rect.width; // 读取实际大小
rt.SetSizeWithCurrentAnchors(RectTransform.Axis.Horizontal, 300); // 设置实际大小,不论锚点如何
rt.anchoredPosition = new Vector2(0, -100); // 相对锚点定位
  • 修改了子元素或者布局后,立刻读取 rect 可能还是旧值,因为布局要到渲染前才统一计算。需要立刻拿到结果时,调用 LayoutRebuilder.ForceRebuildLayoutImmediate(rt)(有开销,不要频繁调用)。
  • localPosition 是相对父节点轴心的位置,anchoredPosition 是相对锚点的位置,两者在锚点不在父节点中心时不相等。

四、布局系统#

组成#

角色接口组件作用
布局元素ILayoutElementImage、Text、LayoutElement提供自己想要多大:最小、首选、弹性尺寸
布局控制器ILayoutGroupHorizontalLayoutGroup、VerticalLayoutGroup、GridLayoutGroup决定子元素的位置和大小
自身控制器ILayoutSelfControllerContentSizeFitter、AspectRatioFitter决定自己的大小

布局元素提供三种尺寸,布局组按优先级分配空间:

  1. 先满足所有元素的最小尺寸(Min);
  2. 空间还有剩余,增加到首选尺寸(Preferred);
  3. 还有剩余,按弹性尺寸(Flexible)的比例分配。

计算顺序#

1. 计算宽度需求:从子节点到父节点(自下而上)
2. 设置宽度:从父节点到子节点(自上而下)
3. 计算高度需求:自下而上
4. 设置高度:自上而下
  • 为什么自下而上计算需求:父节点要知道子节点各自想要多大,才能决定自己要多大。
  • 为什么先算宽度再算高度:文字的高度取决于宽度。宽度确定了,才能知道换几行,从而算出高度。

常见问题#

  • ContentSizeFitter 不能放在受 LayoutGroup 控制的子节点上,两者会争夺对大小的控制权,Unity 会给出警告。正确做法是让父节点的 LayoutGroup 控制子节点大小。
  • 布局组嵌套越深,重建开销越大。内容固定的界面,可以在布局计算完成后禁用布局组件(见 UGUI 性能优化)。

五、事件系统#

组成#

组件作用
EventSystem场景中唯一的事件管理者,记录当前选中的对象,调度输入模块和射线检测器
InputModule读取输入,生成事件。旧输入系统用 StandaloneInputModule,新输入系统用 InputSystemUIInputModule
Raycaster判断某个屏幕坐标下有哪些对象:GraphicRaycaster(挂在 Canvas 上,检测 UI)、PhysicsRaycaster(挂在相机上,检测 3D 碰撞体)、Physics2DRaycaster

一次点击的流程#

1. InputModule 读取到手指按下,生成 PointerEventData(包含位置、按下的对象等)
2. EventSystem 调用所有 Raycaster,收集该位置下的所有候选对象
3. 按优先级排序(Canvas 的排序、层级深度、距离等),第一个就是目标
4. 从目标开始向父节点查找,找到第一个实现了 IPointerDownHandler 的对象,调用它
5. 手指抬起时,如果抬起位置的对象和按下的是同一个,触发 IPointerClickHandler

GraphicRaycaster 怎么判断点中了谁#

对 Canvas 下的每个 Graphic:

  1. 必须勾选了 Raycast Target,并且是激活的;
  2. 点击位置在它的 RectTransform 矩形内;
  3. 通过它的 Raycast 检查:比如在 Mask 外面的会被排除;Image 设置了 alphaHitTestMinimumThreshold 时,透明像素不响应点击(需要贴图开启 Read/Write,会多占一份内存)。
  4. 父节点上的 CanvasGroup 的 blocksRaycasts 为 false 时,整组都不参与检测。

事件接口#

接口触发时机
IPointerEnterHandler / IPointerExitHandler指针进入 / 离开
IPointerDownHandler / IPointerUpHandler按下 / 抬起
IPointerClickHandler在同一个对象上按下并抬起
IBeginDragHandler / IDragHandler / IEndDragHandler开始拖拽 / 拖拽中 / 结束拖拽。移动超过 pixelDragThreshold 才算开始拖拽
IDropHandler拖拽的东西在这个对象上松开
IScrollHandler鼠标滚轮
public class ItemSlot : MonoBehaviour, IPointerClickHandler, IDragHandler
{
public void OnPointerClick(PointerEventData e) { ... }
public void OnDrag(PointerEventData e) { ... }
}

事件冒泡#

事件从命中的对象开始,沿着父节点向上找,交给第一个实现了对应接口的对象处理,找到后就停止。

这解释了一个常见现象:ScrollRect 中的按钮可以点击,而在按钮上拖动时列表也能滚动。因为 Button 只实现了点击相关的接口,没有实现拖拽接口,拖拽事件就继续向上,交给了 ScrollRect。

嵌套 ScrollRect 的冲突:横向滑动的列表放在纵向滑动的列表中,内层 ScrollRect 实现了拖拽接口,会”吃掉”所有拖拽,外层就滑不动了。解决方法是继承 ScrollRect,在开始拖拽时根据拖动方向判断:不是自己负责的方向,就把事件转交给父节点的 ScrollRect。

判断点击是否落在 UI 上#

点击 UI 按钮时,不希望同时触发 3D 场景中的点击(比如角色移动):

// 鼠标
if (EventSystem.current.IsPointerOverGameObject()) return;
// 触摸(旧输入系统),需要传入手指 ID
if (Input.touchCount > 0 && EventSystem.current.IsPointerOverGameObject(Input.GetTouch(0).fingerId)) return;

另一种做法是不用射线自己检测 3D 物体,而是在相机上挂 PhysicsRaycaster,让 3D 物体也通过事件系统接收点击。这样 UI 和 3D 物体统一排序,挡在前面的 UI 自然会拦截点击。

六、网格生成:Graphic 与 VertexHelper#

原理#

所有可见的 UI 元素都继承自 Graphic。它在需要重建时调用 OnPopulateMesh(VertexHelper vh),往 VertexHelper 中填充顶点和三角形,生成的网格交给 CanvasRenderer,再由 Canvas 合批。

一个 Simple 类型的 Image 就是 4 个顶点、2 个三角形。

自定义 Graphic#

public class Triangle : Graphic
{
protected override void OnPopulateMesh(VertexHelper vh)
{
vh.Clear();
Rect r = GetPixelAdjustedRect();
vh.AddVert(new Vector3(r.xMin, r.yMin), color, Vector2.zero);
vh.AddVert(new Vector3(r.center.x, r.yMax), color, Vector2.zero);
vh.AddVert(new Vector3(r.xMax, r.yMin), color, Vector2.zero);
vh.AddTriangle(0, 1, 2);
}
}

用于绘制雷达图、能力六边形、自定义进度条等特殊形状。

修改已有元素的网格:BaseMeshEffect#

继承 BaseMeshEffect,在 ModifyMesh 中修改其他组件生成的顶点:

public class Gradient : BaseMeshEffect
{
public Color top = Color.white, bottom = Color.black;
public override void ModifyMesh(VertexHelper vh)
{
var v = new UIVertex();
for (int i = 0; i < vh.currentVertCount; i++)
{
vh.PopulateUIVertex(ref v, i);
float t = Mathf.InverseLerp(graphic.rectTransform.rect.yMin, graphic.rectTransform.rect.yMax, v.position.y);
v.color *= Color.Lerp(bottom, top, t);
vh.SetUIVertex(v, i);
}
}
}

UGUI 自带的 Shadow 和 Outline 也是 BaseMeshEffect:它们通过复制顶点实现,Outline 会把顶点复制成原来的 5 倍(4 个方向的阴影加上原图)。文字多时顶点数暴增,这是推荐用 TextMeshPro 做描边的原因之一。

七、Image、图集与文字#

Image 的四种类型#

类型效果用途
Simple整张图拉伸到 RectTransform 的大小图标、头像
Sliced(九宫格)四个角保持原大小,四条边只沿一个方向拉伸,中间双向拉伸按钮、对话框、背景框,任意大小都不变形
Tiled平铺重复重复花纹的背景
Filled按 Fill Amount 只显示一部分,支持水平、垂直、径向进度条、技能冷却

九宫格需要在 Sprite Editor 中设置图片的边框(Border)。中间区域不需要显示时,取消勾选 Fill Center,可以减少过度绘制。

Sprite Atlas#

把多张小图打包成一张大图(图集):

  • 合批:同一个图集中的图片使用同一张贴图,才有可能合批(见 UI 合批规则)。
  • 内存:用到图集中的任意一张小图,整张图集都会被加载。所以图集要按界面或模块划分:通用元素一个图集,每个功能界面各一个图集。不要把所有图都塞进一个大图集。
  • 图集的加载可以交给资源系统控制(Late Binding),配合热更新时常用。

Text 与 TextMeshPro#

Text(旧版)TextMeshPro
字形来源运行时把用到的字符按当前字号渲染到动态字体纹理中预先生成 SDF(有向距离场)字体图集
缩放放大后模糊任意缩放都清晰
描边、阴影、发光用 Outline / Shadow 组件复制顶点,开销大在 Shader 中实现,几乎没有额外开销
富文本、图文混排有限丰富,支持图片表情
现状维护状态,不再推荐Unity 推荐,新版本已集成到 UGUI 中

TextMeshPro 使用中文时,字符数量多,通常把常用字做成静态字体图集,生僻字放在动态的后备(Fallback)字体中按需生成。SDF 原理、字体资源、描边等效果的实现见 字体渲染:Text 与 TextMeshPro。

八、坐标转换#

UI 开发中经常要在三种坐标之间转换:

坐标说明
屏幕坐标像素,左下角为 (0, 0)。触摸、鼠标位置都是屏幕坐标
UI 坐标某个 RectTransform 内的局部坐标,用来设置 anchoredPosition / localPosition
世界坐标3D 场景中的坐标

屏幕 → UI#

// cam:Overlay 模式传 null,Camera 模式传 canvas.worldCamera
RectTransformUtility.ScreenPointToLocalPointInRectangle(
parentRect, Input.mousePosition, cam, out Vector2 localPos);
icon.localPosition = localPos;

拖拽物品时,在 OnDrag 中用 eventData.position 和 eventData.pressEventCamera 做同样的转换。

世界 → UI:头顶血条#

Vector3 screenPos = mainCamera.WorldToScreenPoint(target.position + Vector3.up * 2);
bool visible = screenPos.z > 0; // z < 0 表示在相机背后,要隐藏
hpBar.gameObject.SetActive(visible);
if (visible)
{
RectTransformUtility.ScreenPointToLocalPointInRectangle(
hudRoot, screenPos, uiCamera, out Vector2 localPos);
hpBar.anchoredPosition = localPos;
}

血条很多时,每帧移动它们会导致 Canvas 频繁重新合批。可以把血条放在单独的 Canvas 中,或者直接使用 World Space 的 Canvas 跟随角色。

UI → 屏幕#

Vector2 screenPos = RectTransformUtility.WorldToScreenPoint(cam, uiElement.position);

比如在某个按钮的位置播放 3D 特效,或者新手引导中把手指移到某个按钮上。

九、常用控件#

Selectable:所有可交互控件的基类#

Button、Toggle、Slider、Scrollbar、InputField、Dropdown 都继承自 Selectable,它提供了共同的能力:

交互状态

状态什么时候
Normal默认
Highlighted鼠标悬停
Pressed按下
Selected被选中(点击后、或者通过键盘手柄导航选中)
Disabledinteractable = false

状态过渡方式(Transition)

方式效果注意
Color Tint按状态给目标图片乘一个颜色最常用,开销最小
Sprite Swap按状态换图每个状态要准备一张图
Animation按状态触发 Animator 的 TriggerAnimator 会持续把 UI 标记为脏,引起 Canvas 重建(见 UGUI 性能优化),慎用

其他要点

  • interactable = false 时控件不响应交互,并显示为 Disabled 状态。想让一组控件都不能交互,可以用父节点上 CanvasGroup 的 interactable。
  • Navigation 用于键盘、手柄在控件之间切换焦点。手机游戏用不到时可以设为 None。
  • 在 PC 上点击按钮后,按钮会保持 Selected 状态,看起来像”一直高亮”。这是因为它成为了 EventSystem 当前选中的对象。不需要时,把 Selected 颜色设成和 Normal 一样,或者点击后调用 EventSystem.current.SetSelectedGameObject(null)。

CanvasGroup#

CanvasGroup 不是一个可交互的控件,而是用来整组控制一个节点及其所有子节点:

属性作用
alpha整组的透明度,会和子元素自身的透明度相乘
interactable整组是否可交互,为 false 时子控件都显示为 Disabled
blocksRaycasts整组是否接收射线检测(点击)
ignoreParentGroups是否忽略父级 CanvasGroup 的设置

界面淡入淡出就是对 alpha 做插值:

async UniTask FadeIn(CanvasGroup group, float duration, CancellationToken token)
{
group.blocksRaycasts = false; // 动画期间屏蔽点击
for (float t = 0; t < 1; t += Time.unscaledDeltaTime / duration)
{
group.alpha = t;
await UniTask.Yield(token);
}
group.alpha = 1;
group.blocksRaycasts = true;
}

为什么用 CanvasGroup 而不是逐个修改子元素的颜色:

  • 一个属性控制整组,不需要遍历所有的 Image 和 Text;
  • 修改 Image.color 会让这个 Graphic 重新生成顶点(颜色存在顶点里),子元素多时,每帧都在重建大量网格;而 CanvasGroup 的透明度是作为整组的继承透明度应用的,通常比逐个修改颜色的开销小得多。

注意:

  • alpha 为 0 时界面仍然会参与合批和渲染,也仍然可能接收点击。完全隐藏时还要配合 blocksRaycasts = false,长时间隐藏建议禁用 Canvas(见 UI 的显示与隐藏)。
  • Spine 的 SkeletonGraphic 等自定义渲染的组件,在 CanvasGroup 淡出时可能需要额外的设置(见 Spine 与预乘 Alpha)。

Button#

button.onClick.AddListener(OnStartClicked);
  • onClick 在两种情况下触发:OnPointerClick(左键或手指在按钮上按下并抬起)和 OnSubmit(键盘回车、手柄确认键)。
  • 只有按钮激活并且 interactable 为 true 时才会触发。
  • onClick 是 UnityEvent,也可以在 Inspector 中配置(和 C# 事件的对比见 委托、事件与 Lambda)。

扩展长按:Button 本身没有长按,需要自己实现按下、抬起、离开的接口:

public class LongPressButton : MonoBehaviour,
IPointerDownHandler, IPointerUpHandler, IPointerExitHandler
{
public float duration = 0.5f;
public UnityEvent onLongPress;
float _downTime = -1;
public void OnPointerDown(PointerEventData e) => _downTime = Time.unscaledTime;
public void OnPointerUp(PointerEventData e) => _downTime = -1;
public void OnPointerExit(PointerEventData e) => _downTime = -1; // 手指移出按钮也取消
void Update()
{
if (_downTime >= 0 && Time.unscaledTime - _downTime >= duration)
{
_downTime = -1;
onLongPress.Invoke();
}
}
}

防连点的做法见 UI 框架设计。

Toggle 与 ToggleGroup#

toggle.isOn = true;
toggle.onValueChanged.AddListener(isOn => { ... });
  • Toggle:开关,isOn 表示状态,变化时显示或隐藏它的 Graphic(通常是对勾)。
  • ToggleGroup:把多个 Toggle 设置到同一个组中,同一时间只能有一个是打开的,实现单选(比如页签、难度选择)。
  • allowSwitchOff:为 false 时,点击已经打开的 Toggle 不会关闭它,保证组内始终有一个被选中;为 true 时允许全部关闭。

Slider 与 Scrollbar#

Slider 的结构:

Slider
├── Background
├── Fill Area
│ └── Fill ← fillRect:按值拉伸,显示进度
└── Handle Slide Area
└── Handle ← handleRect:可拖动的滑块
  • minValue、maxValue、value;wholeNumbers 为 true 时只取整数。
  • 只用于显示进度(如血条)时,可以删掉 Handle,并关闭 interactable。

Scrollbar 和 Slider 类似,但值固定在 0 到 1 之间,size 表示滑块占总长度的比例,一般配合 ScrollRect 使用。

最常见的坑:用代码设置值时触发了回调

slider.onValueChanged.AddListener(v => Settings.Volume = v); // 玩家拖动时保存设置
// 打开界面时用数据刷新显示:
slider.value = Settings.Volume; // 也会触发 onValueChanged,又写回了一次 Settings

这里只是多写了一次,如果回调里还有其他逻辑(播放音效、发送网络请求),或者两个控件互相联动,就会出现重复执行甚至死循环。用代码刷新显示时,使用不触发回调的方法:

slider.SetValueWithoutNotify(Settings.Volume);
toggle.SetIsOnWithoutNotify(true);
dropdown.SetValueWithoutNotify(2);
inputField.SetTextWithoutNotify("abc");

ScrollRect#

结构

ScrollRect
└── Viewport ← 可视区域,挂 Mask 或 RectMask2D 裁剪
└── Content ← 内容,大小通常比 Viewport 大,滚动就是移动它的位置
├── Item
├── Item
└── ...

Viewport 的裁剪推荐用 RectMask2D,它不使用模板缓冲,还会剔除完全在区域外的元素(见 Mask 与 RectMask2D)。

常用属性

属性说明
horizontal / vertical允许的滚动方向
movementTypeElastic:拉到边界外会回弹;Clamped:不能超出边界;Unrestricted:不限制
inertia / decelerationRate松手后是否继续滑动、减速的快慢
normalizedPosition0 到 1 的滚动位置。注意 verticalNormalizedPosition 为 1 表示顶部,0 表示底部
onValueChanged滚动时回调,循环列表就是在这里更新哪些项可见

滚动到指定的列表项(纵向列表,Content 的轴心和锚点在顶部):

public void ScrollTo(RectTransform item)
{
scrollRect.StopMovement(); // 停止惯性滑动
float target = -item.anchoredPosition.y - item.rect.height * item.pivot.y; // 让项目的顶部对齐视口顶部
float max = Mathf.Max(0, content.rect.height - viewport.rect.height);
content.anchoredPosition = new Vector2(content.anchoredPosition.x, Mathf.Clamp(target, 0, max));
}

需要平滑滚动时,用 Tween 对 content.anchoredPosition 做插值即可。

  • Content 大小的设置:配合 VerticalLayoutGroup + ContentSizeFitter 可以自动计算 Content 的高度,适合数量少的列表;数据多时用循环列表(见 长列表),自己计算 Content 大小和每一项的位置。
  • 嵌套 ScrollRect 的冲突见上文的 事件冒泡。

InputField(TextMeshPro)#

新项目推荐使用 TMP_InputField。

事件触发时机
onValueChanged每输入或删除一个字符
onEndEdit结束编辑:失去焦点,或单行模式下按下回车
onSubmit按下回车提交
onSelect / onDeselect获得 / 失去焦点
  • characterLimit:最大字符数。
  • contentType:标准、整数、小数、字母数字、邮箱、密码(显示为星号)等,会限制可输入的字符,并影响手机弹出的键盘类型。
  • onValidateInput:自定义每个输入字符的过滤规则,比如屏蔽 emoji 或特殊符号。
  • 移动端:获得焦点时会自动弹出系统软键盘。默认还会在键盘上方显示一个系统输入框,勾选 Hide Mobile Input 后改为直接在游戏的输入框中显示文字。
  • 中文输入时有输入法的组字过程(拼音还没选定),onValueChanged 中拿到的内容可能包含未确认的拼音,做敏感词检测、字数统计等应以 onEndEdit 为准。
dropdown.ClearOptions();
dropdown.AddOptions(new List<string> { "简单", "普通", "困难" });
dropdown.value = 1;
dropdown.onValueChanged.AddListener(index => { ... });
  • Template:Dropdown 下面有一个隐藏的 Template 节点,展开时以它为模板生成选项列表,每个选项是一个 Toggle。修改展开列表的样式,就是修改这个 Template。

  • 展开时会创建两个额外的 Canvas:

    • 一个铺满全屏、透明的 Blocker,点击列表以外的地方时关闭列表;
    • 选项列表本身也带一个 Canvas,并使用一个很大的 sortingOrder,保证显示在最上层。

    所以在有层级管理的 UI 框架中,展开的下拉列表可能盖住引导层甚至系统层。对层级要求严格的项目,通常会自己实现下拉列表。

  • 修改选项后需要调用 RefreshShownValue() 刷新当前显示的文字。

常见追问#

Canvas 的三种渲染模式有什么区别? Overlay 不经过相机,直接画在最上层;Camera 由相机渲染,可以和粒子、3D 物体穿插;World Space 是场景中的物体,用于场景内的 UI。

为什么 Overlay 模式下粒子特效显示不到 UI 上面? Overlay 的 UI 在所有相机渲染完之后才绘制,而粒子由相机渲染,所以永远在 UI 下面。需要改用 Camera 模式并设置排序值。

锚点和轴心有什么区别? 锚点是在父节点中的参考位置,决定元素跟随父节点的哪部分移动或拉伸;轴心是元素自身的中心点,决定旋转、缩放的中心和位置的基准。

sizeDelta 是元素的大小吗? 只有锚点重合时才是。锚点分开时,它表示实际大小比锚点区域大多少。读取实际大小要用 rect.width / rect.height。

布局系统的计算顺序是怎样的?为什么先算宽度? 先自下而上计算宽度需求、自上而下设置宽度,再对高度做同样的事。文字的高度取决于宽度,所以宽度要先确定。

UGUI 的点击事件是怎么传递的? InputModule 生成事件数据,EventSystem 调用各个 Raycaster 找到该位置下的对象并排序,第一个为目标;再从目标向父节点查找第一个实现了对应接口的对象来处理。

为什么 ScrollRect 里的按钮既能点击,又能拖动列表? Button 没有实现拖拽接口,拖拽事件向父节点冒泡交给了 ScrollRect。

嵌套的 ScrollRect 滑动冲突怎么解决? 继承 ScrollRect,在开始拖拽时判断方向,不是自己负责的方向就把拖拽事件转交给父级的 ScrollRect。

怎么判断点击是否在 UI 上? EventSystem.current.IsPointerOverGameObject(),触摸时传入手指 ID。或者给相机挂 PhysicsRaycaster,让 3D 物体也走事件系统。

怎么自定义 UI 的形状? 继承 Graphic 重写 OnPopulateMesh,用 VertexHelper 添加顶点和三角形。修改已有元素的网格则继承 BaseMeshEffect。

为什么推荐 TextMeshPro? 基于 SDF,缩放不模糊;描边、阴影在 Shader 中实现,不增加顶点;富文本功能强。

九宫格的原理是什么? 在图片上设置边框,把图片分成九块:四个角不缩放,四条边单向拉伸,中间双向拉伸,任意大小下边框都不变形。

用代码修改 Slider 的值,为什么会触发 onValueChanged?怎么避免? 设置 value 属性会触发回调。用代码刷新显示时,使用 SetValueWithoutNotify(Toggle、Dropdown、InputField 也有对应的方法)。

ScrollRect 怎么滚动到指定的项? 停止惯性滑动后,根据目标项的位置计算 Content 的 anchoredPosition,并限制在可滚动范围内;需要动画时用 Tween 插值。

ToggleGroup 的 allowSwitchOff 有什么用? 为 false 时,组内始终保持有一个 Toggle 处于打开状态;为 true 时允许全部关闭。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

UGUI 原理与核心机制:Canvas、RectTransform、布局、事件与网格
https://xslab.cloud/posts/unity/ugui-principles/
作者
LuxFire
发布于
2026-10-12
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
循环列表的实现:固定高度、变长项、网格布局与跳转定位
Unity底层/UI 为什么长列表需要循环复用;循环列表的核心原理:根据滚动位置计算可见范围,回收和复用节点;固定高度列表的完整实现;变长项如何用前缀和加二分查找定位;网格布局;跳转到指定项、局部刷新与增删;以及常见的坑。
2
UGUI 性能优化:Canvas 重建、合批与过度绘制
Unity性能优化 UGUI 的性能问题来自哪里:Canvas 的 Rebuild 与 Rebatch、UI 合批规则、过度绘制和射线检测。以及动静分离、图集、Mask 选择、显隐方式、长列表等常用优化手段。
3
Unity 字体渲染:Text 与 TextMeshPro 的原理、使用与描边等效果
Unity底层/UI 字体是怎么变成屏幕上的文字的;旧版 Text 的动态字体纹理及其问题;TextMeshPro 的 SDF 原理、字体资源与图集、后备字体、中文字体方案;描边、阴影、发光、渐变等效果的实现原理;富文本、图文混排、逐字动画;以及文字相关的性能注意事项。
4
UI 框架设计:以休闲游戏为例
项目设计/架构 参考 GameFramework、QFramework、FairyGUI 等主流方案,设计一套适合休闲游戏的 UGUI 框架:层级管理、窗口生命周期、窗口栈与返回键、弹窗队列、缓存与资源释放、遮罩与动画、界面切换与闪烁、屏幕适配、组件绑定、红点系统,并给出核心代码骨架。
5
项目常用功能实现:跑马灯、飞金币、飘字、倒计时、新手引导与打击感
项目设计/业务系统 休闲游戏中高频出现的功能的实现思路与关键代码:跑马灯的队列与滚动,以及不用 Mask 的几种裁剪方式;飞金币与数字滚动;伤害飘字;基于服务器时间的倒计时;新手引导的挖洞遮罩与点击穿透;延迟扣血的双层血条;屏幕震动与顿帧。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录