UITemplateElement

Since 2.2.1

UITemplateElement 在运行时加载已保存的 UITemplate 资源，并将其子元素和样式表插入自身。它用于复用在编辑器中创建的 UI 布局，无需重复编写代码。

循环模板引用会被检测到并记录为错误。

UIElement 中记录的所有内容（布局、样式、事件、数据绑定等）同样适用于此。

---

用法

JavaKotlinKubeJS

var tmpl = new UITemplateElement(IResourcePath.parse("mymod:my_panel"));
parent.addChild(tmpl);

// Change the template at runtime:
tmpl.setTemplate(IResourcePath.parse("mymod:other_panel"));

uiTemplate("mymod:my_panel") { }

let tmpl = new UITemplateElement();
tmpl.setTemplate(IResourcePath.parse("mymod:my_panel"));
parent.addChild(tmpl);

---

XML

<template path="mymod:my_panel"/>

XML 属性	类型	描述
path	string	要加载的 UITemplate 资源路径（如 mymod:my_panel）。

---

字段

名称	类型	访问权限	描述
path	IResourcePath（可空）	private（有 getter）	当前加载的模板路径。
template	UITemplate（可空）	private（有 getter）	解析后的 UITemplate 实例。

---

方法

方法	返回值	描述
setTemplate(IResourcePath)	UITemplateElement	加载新模板，替换当前的子元素和样式。传入 null 可清除。