版本:Unity 6 (6000.0)
语言:English
使用元素
使用 UI 构建器设置 UI 样式

使用 UXML 实例作为模板

您可以将现有的 UXML 文档作为模板实例化到您的 UXML 文档中作为模板实例,这类似于预制体一种资产类型,允许您存储包含组件和属性的完整游戏对象。预制体充当模板,您可以从中在场景中创建新的对象实例。 更多信息
参见 术语表
在 Unity 中的工作方式。

使用 UXML 文档作为模板

要将项目中现有的 UXML 文档用作模板,请执行以下操作

  1. 项目选项卡下,找到您想要实例化的 UXML 资产 (.uxml)。
  2. 将其拖到层次结构中,就像中的一个元素一样。

模板实例会显示在层次结构中,就像一个普通的 TemplateContainer 类型元素。.uxml 文件的名称以灰色字体显示在其名称的右侧。如果展开模板实例,您可以看到实例的内部层次结构。如使用元素中所述,此内部层次结构是只读的,仅供参考。

将子文档作为模板

您可以在 UXML 文档中创建一个子文档作为模板实例,以便您可以重复使用它。

  1. 右键单击子文档。
  2. 选择创建模板
  3. 选择保存文件的位置。

这还会将子文档作为模板实例实例化到现有文档中。

编辑 UXML 文档模板实例

要编辑用作模板实例的原始 UXML 文档,请右键单击模板实例,然后选择以下选项之一

  • UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。 更多信息
    参见 术语表
    构建器中打开
    :卸载当前的 UXML 文档,并加载模板实例

    Open in UI Builder example
    在 UI 构建器中打开示例
  • 在隔离状态下打开实例:在加载模板实例的同时,将当前 UXML 文档保持加载在后台。层次结构画布仅显示模板实例的内容,并且样式表窗格以只读状态包含背景父 UXML 文档的样式表。这是因为样式表仍在应用于模板实例

    Open Instance in Isolation example
    在隔离状态下打开实例示例
  • 在上下文中打开实例:在保持当前 UXML 文档加载的同时,将其所有元素设为只读,并在层次结构画布中显示为暗淡。您可以在父 UXML 文档的上下文中编辑模板实例的内容。使用此选项更新模板实例内容,而不会丢失主机文档的上下文

    Open Instance in Context example
    在上下文中打开实例示例
  • 在项目中显示:在项目窗口一个窗口,显示您的 Assets 文件夹的内容(项目选项卡) 更多信息
    参见 术语表
    中显示模板实例文件的位置。

对于第二个和第三个选项,视口应用程序在用户屏幕上可见的区域。
参见 术语表
上方会出现面包屑。您可以使用面包屑返回到父 UXML 文档。

Sub-document breadcrumbs example
子文档面包屑示例

解包 UXML 文档模板实例

要解包单个模板实例,请右键单击模板实例并选择解包实例。这会将模板实例更改为普通的 UXML 文档。

要解包所有模板实例,请右键单击模板实例并选择完全解包实例。这会将所有模板实例更改为普通的 UXML 文档。

其他资源

使用元素
使用 UI 构建器设置 UI 样式