通用属性

属性属性名默认值描述
type控件类型字符串:列举定义该控件的类型。
列举的值有:
screen、panel、stack_panel、input_panel、label、image、button、toggle、dropdown、slider、edit_box、custom、factory、scroll_view、scroll_track、scrollbar_box、selection_wheel
controls子控件数组:控件数组添加子控件。
添加子控件示例:"test": { "controls": [{"hi":{"type":"label","text":"hello world"}}] }子控件允许继承和引用,因此并不需要把子控件所有属性写在controls中。
visible可见布尔值true控件是否可见。
enabled启用布尔值true控件是否启用。
禁用后,控件本身以及子控件都会受到影响,并且无法进行交互。
ignored忽略布尔值false控件是否忽略。
alpha不透明度浮点数1控件的不透明度。
取值范围在 0~1 之间。不透明度默认不会传播到子控件,你可以通过 propagate_alpha 属性允许传播不透明度。
propagate_alpha传播不透明度布尔值false控件是否允许传播不透明度到所有子控件。
clips_children裁剪子控件布尔值false控件是否允许裁剪溢出的子控件,子控件溢出该控件的大小才会被裁剪。
子控件被裁剪的某个部分,交互以及图形因此都会受到影响;
子控件使用 "allow_clipping": false 不会被剪辑。
allow_clipping允许裁剪布尔值true控件是否允许裁剪。
clip_offset裁剪偏移量数组:矢量[x,y][0,0]控件的裁剪开始点的偏移量。
clip_state_change_event改变裁剪状态的事件字符串改变控件裁剪状态的事件。
enable_scissor_test启用剪刀测试布尔值false控件是否启用剪刀测试。
剪刀测试用于限制绘制区域。指定一个矩形的剪裁窗口,当启用剪裁测试后,只有在这个窗口之内的像素才能被绘制,其它像素则会被丢弃。换句话说,无论怎么绘制,剪裁窗口以外的像素将不会被修改。详见 剪刀测试 >
selected选中布尔值false控件是否选中。
anims动画数组详见 动画 >
animation_reset_name动画重置事件字符串用于重置动画状态的事件。
详见 动画 >
disable_anim_fast_forward禁用动画快进布尔值false控件是否禁用动画快进。
grid_position网格位置数组:矢量[row, col]定义控件在网格中的位置,同时影响该控件的网格绑定。
factory工厂对象该属性仅适用于 堆叠面板、合集面板、面板。
该属性详见下方的 工厂 >
collection_name合集名字符串该控件的合集名称。
该属性仅适用于 堆叠面板、合集面板、网格。
合集名称可查阅 绑定合集 >
collection_index项目索引整数定义控件在项目中的位置。
variables变量数组 或 对象在达成某个条件下,改变变量的值。
详见 变量 >
modifications修改数组用于修改数组中的对象。
仅用于修改低于当前资源包排序的资源包,一般我们只对 vanilla 进行处理。
(资源包排序为:世界资源包 > 全局资源 > 游戏安装包资源包 > treatment,其中他们还可以细分为许多部分,游戏安装包资源包排序又能分为 vanilla版本包 > vanilla > vanilla_base。)
详见 修改 >
property_bag属性包对象属性包用于储存硬编码的数据。

工厂

该属性的对象内部可填写以下属性:
属性属性名描述
name工厂名字符串
max_children_size子控件数量整数工厂子控件的最大数量,默认无限制。
control_name控件名字符串工厂的子控件名。
属性示例:
"control_name": "@namespace.controls_name"
control_ids控件 ID对象工厂的子控件 ID 对象组。
属性示例:
"control_ids": { "id": "@namespace.controls_name" }
factory_variables工厂变量数组工厂使用的变量。
属性示例:
"factory_variables": ["$test"]