Version: 6000.3
语言: 中文
面板设置属性参考
运行时 UI 事件系统和输入处理

UI 文档组件

UI文档组件引用UXML文档和面板设置资产。它充当场景场景包含游戏的环境和菜单。将每个唯一的场景文件视为一个独特的关卡。在每个场景中,你放置你的环境、障碍物和装饰品,基本上是将你的游戏设计和构建成碎片。更多信息
请参阅术语表
和 UXML 文档。UXML文档指定UI结构,而 面板设置(Panel Settings) 资产处理渲染。

创建UI文档组件

要创建UI文档组件,请执行以下作之一:

  • 要将 UI 文档组件添加到场景中的现有游戏对象,请选择组件> UI 工具包 > UI 文档
  • 要使用预配置的 UI 文档组件创建新的游戏对象,请选择游戏对象> UI 工具包 > UI 文档

将 UI 连接到面板

要将 UI 连接到面板,请在检查器一个 Unity 窗口,显示有关当前选定游戏对象、资产或项目设置的信息,允许您检查和编辑值。更多信息
请参阅术语表
窗口,配置 UI 文档组件。

UI 文档组件
UI 文档组件
  • 面板设置(Panel Settings) :渲染UI的面板设置(Panel Settings) 资产。
  • 源资产(Source Asset) :包含要显示的UI的UXL文档。
  • 排序顺序:UI 文档组件的渲染顺序。值越低,UI 文档组件呈现的时间越早。

在同一面板上渲染多个UXML文档

一个面板可以显示来自多个UXML文档组件的UI。这允许您将复杂的 UI 分解为更小、更易于管理的部分。每个UXML文档组件都引用不同的UXL文档和相同的面板设置资产。

每个UI文档组件都有一个Sort Order属性,用于控制渲染顺序。子 UI 文档组件呈现在其父 UI 文档组件之上。同级UI文档组件(位于同一层次结构级别)根据其排序顺序值按升序呈现。排序顺序值越低,UI 文档组件呈现的时间越早。

注意:如果有多个UI文档组件附加到同一面板设置,则所有这些文档都具有公共焦点导航上下文。如果它们具有不同的面板设置,则即使并排排列它们,导航也不会自动从一个面板跳转到另一个面板设置。要使导航从一个跳转到另一个,您必须将focusController的面板设置设置为FocusController要跳转到的 UI 文档组件。

UI 文档组件的生命周期

Unity 在调用 UI 文档组件的OnEnable()方法。为确保可视化树轻量级节点组成的对象图,用于保存窗口或面板中的所有元素。它定义了使用 UI 工具包构建的每个 UI。
请参阅术语表
正确加载,添加逻辑以与OnEnable()方法。这意味着您的脚本必须响应OnEnable()OnDisable()以安全参考视觉元素实例化或派生自 C# 的可视化树的节点VisualElement类。您可以设置外观样式、定义行为并将其作为 UI 的一部分显示在屏幕上。更多信息
请参阅术语表
从你的 UXML 文档中。

UI 文档组件在响应OnEnable()OnDisable()方法。此方法删除了 UI 文档不会很快重用的 UI 元素,并有效地清除了关联的资源。此外,如果UI文档组件未分配面板设置资产,它会自动清除其内容。

若要隐藏可能很快重复使用或需要快速显示以避免初始化惩罚的 UI 元素,displayUIDocument.rootVisualElementnone.您还可以使用它来隐藏属于较大 UI 层次结构的 UI 元素组件。

其他资源

面板设置属性参考
运行时 UI 事件系统和输入处理