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. 属性变化(换图、改颜色、改大小) ↓ 标记为"脏",登记到 CanvasUpdateRegistry2. 渲染前,Canvas 统一处理所有脏元素: ↓ 先执行布局(计算 RectTransform 的大小和位置) ↓ 再重建图形:Graphic 通过 VertexHelper 生成顶点,交给 CanvasRenderer3. Canvas 收集所有元素的网格,排序、合批(原生代码中执行) ↓4. 提交渲染第 2 步是 Rebuild,第 3 步是 Rebatch,它们的开销和优化见 UGUI 性能优化。
二、Canvas
三种渲染模式
| 模式 | 原理 | 特点 | 适合 |
|---|---|---|---|
| Screen Space - Overlay | 不经过相机,在所有相机渲染完之后直接画在屏幕最上层 | 简单,永远在最上面;3D 物体、粒子无法显示在 UI 之上 | 大部分 2D 界面 |
| Screen Space - Camera | 由指定的相机渲染,Canvas 放在相机前方一定距离(Plane Distance)的平面上 | 可以和粒子、3D 模型穿插排序,可以受后处理影响 | 需要在 UI 中显示粒子特效、3D 模型 |
| World Space | Canvas 就是场景中的一个物体,有自己的位置、旋转和缩放 | 会被 3D 物体遮挡,有透视 | 头顶血条、场景中的告示牌、VR 中的界面 |
- Camera 模式下如果没有指定相机,会退化成和 Overlay 一样的效果。
- URP 中常用的做法是相机堆叠:主相机渲染场景,再叠加一个专门渲染 UI 的 Overlay 相机,UI Canvas 使用 Camera 模式指向它。
- World Space 的 Canvas 要接收点击,需要设置 Event Camera。
Canvas Scaler
| 模式 | 行为 |
|---|---|
| Constant Pixel Size | UI 元素保持固定的像素大小,屏幕越大,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是相对锚点的位置,两者在锚点不在父节点中心时不相等。
四、布局系统
组成
| 角色 | 接口 | 组件 | 作用 |
|---|---|---|---|
| 布局元素 | ILayoutElement | Image、Text、LayoutElement | 提供自己想要多大:最小、首选、弹性尺寸 |
| 布局控制器 | ILayoutGroup | HorizontalLayoutGroup、VerticalLayoutGroup、GridLayoutGroup | 决定子元素的位置和大小 |
| 自身控制器 | ILayoutSelfController | ContentSizeFitter、AspectRatioFitter | 决定自己的大小 |
布局元素提供三种尺寸,布局组按优先级分配空间:
- 先满足所有元素的最小尺寸(Min);
- 空间还有剩余,增加到首选尺寸(Preferred);
- 还有剩余,按弹性尺寸(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. 手指抬起时,如果抬起位置的对象和按下的是同一个,触发 IPointerClickHandlerGraphicRaycaster 怎么判断点中了谁
对 Canvas 下的每个 Graphic:
- 必须勾选了 Raycast Target,并且是激活的;
- 点击位置在它的 RectTransform 矩形内;
- 通过它的
Raycast检查:比如在 Mask 外面的会被排除;Image 设置了alphaHitTestMinimumThreshold时,透明像素不响应点击(需要贴图开启 Read/Write,会多占一份内存)。 - 父节点上的
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;
// 触摸(旧输入系统),需要传入手指 IDif (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.worldCameraRectTransformUtility.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 | 被选中(点击后、或者通过键盘手柄导航选中) |
| Disabled | interactable = false |
状态过渡方式(Transition)
| 方式 | 效果 | 注意 |
|---|---|---|
| Color Tint | 按状态给目标图片乘一个颜色 | 最常用,开销最小 |
| Sprite Swap | 按状态换图 | 每个状态要准备一张图 |
| Animation | 按状态触发 Animator 的 Trigger | Animator 会持续把 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 | 允许的滚动方向 |
movementType | Elastic:拉到边界外会回弹;Clamped:不能超出边界;Unrestricted:不限制 |
inertia / decelerationRate | 松手后是否继续滑动、减速的快慢 |
normalizedPosition | 0 到 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 做插值即可。
InputField(TextMeshPro)
新项目推荐使用 TMP_InputField。
| 事件 | 触发时机 |
|---|---|
onValueChanged | 每输入或删除一个字符 |
onEndEdit | 结束编辑:失去焦点,或单行模式下按下回车 |
onSubmit | 按下回车提交 |
onSelect / onDeselect | 获得 / 失去焦点 |
characterLimit:最大字符数。contentType:标准、整数、小数、字母数字、邮箱、密码(显示为星号)等,会限制可输入的字符,并影响手机弹出的键盘类型。onValidateInput:自定义每个输入字符的过滤规则,比如屏蔽 emoji 或特殊符号。- 移动端:获得焦点时会自动弹出系统软键盘。默认还会在键盘上方显示一个系统输入框,勾选
Hide Mobile Input后改为直接在游戏的输入框中显示文字。 - 中文输入时有输入法的组字过程(拼音还没选定),
onValueChanged中拿到的内容可能包含未确认的拼音,做敏感词检测、字数统计等应以onEndEdit为准。
Dropdown(TextMeshPro)
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 时允许全部关闭。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!