子事件

子事件 - 图1

更新时间:2024-08-05 18:12:06
文档

基础属性

属性名称 属性类型 属性说明 回调状态 字符串 回调参数

动作(名称与参数)表

动作名称 动作说明 动作参数 动作参数说明 触发 -/- 触发子事件 执行子事件,子事件在动作组的应用界面中进入 属性·动作·事件

功能概述-41版本


子事件组件可以为动作组添加自定义的回调状态。
子事件 - 图2
如上图所示,任意一个动作组被调用的时候,都会有一个“完成”的默认回调 这个回调状态,通过在动作组定义中-添加“设置返回结果”进行触发 但在有一些场景中,我们需要监听动作组异步事件 举个例子,如果我们做一个动作组,用来显示一个弹窗,那此时,我们需要监听用户点击确认或取消按钮的事件。 因为点击确认和取消,是一个额外的用户行为,而不是“显示弹窗动作组”内部的逻辑,因此,我们无法通过默认的“完成”回调来获取到用户的点击事件。
在这种情况下,我们就需要额外的回调状态,比如“点击确认”,“点击取消”。 通过在动作组下添加子事件组件,就可以为动作组添加自定义的回调状态。

基本用法
在这里,我们以弹窗动作组弹窗小模块为例,来说明子事件的用法。
下文中demo例子的下载地址https://www.ivx.cn/ih5/app/template/download?id=3538
无论是普通的动作组、还是小模块中定义中公共方法下的动作组,都可以添加子事件组件 在“回调状态”属性中,我们可以填写:需要显示在动作组回调列表中的状态名称,比如,在弹窗的例子中,我们添加了一个“点击确认”回调状态:
子事件 - 图3
每个动作组下,可以添加多个子事件
添加子事件之后,我们还需要定义这个子事件的触发时机
子事件 - 图4
比如,在以上弹窗的例子中,弹窗的确认按钮的点击事件,会触发“点击确认”这个子事件。 这样,当我们调用动作组时,就可以通过“点击确认”回调状态,来监听用户点击确认按钮这个事件了。
注意,在小模块的公共方法下的动作组,也可以用同样的方法使用子事件。 比如,我们将弹窗封装为小模块之后,小模块的“显示弹窗”动作,就可以使用自定义回调了
子事件 - 图5

自定义回调参数


自定义回调状态时,我们还可以定义额外的回调参数 比如,在demo例子中,我们制作了一个评分弹窗小模块:
子事件 - 图6
在这个小模块中,我们除了要监听用户点击提交按钮这个事件,还需要拿到用户的评分 此时,我们就可以为子事件添加参数:
子事件 - 图7
比如,在以上例子中,我们添加了“分数”这个参数来获取到用户评分。
然后,在触发子事件时,传入分值
子事件 - 图8
最后,我们在使用这个小模块时,就可以通过“提交评分”回调,来获取到用户的评分了:
子事件 - 图9

功能概述-50版本


子事件是一种特殊的组件,只能添加在动作组下。它允许在动作组执行过程中触发子事件,并且可以通过参数传递数据; 子事件的逻辑-编写在子事件的面板中。这种机制为动作组提供了更高的灵活性和可扩展性 首先,我们在对象树中选中动作组,在动作组中添加一个动作组回调组件
子事件 - 图10
添加完成后,可以在属性中设置回调参数:
子事件 - 图11
配置完成后,就可以在动作组中触发动作组回调了
子事件 - 图12
触发回调时,可以通过变量传参到动作组子事件中。

子事件定义与执行


要定义动作组回调的子事件,需要进入动作组的子事件界面:
子事件 - 图13
在子事件中,可以获取到传入的关联参数
子事件 - 图14
编辑好了子事情的事件逻辑后,可以点击左上角的返回主面板返回事件主面板
子事件 - 图15
当动作组回调被执行时,系统会自动进入到对应的子事件中,执行定义好的逻辑。
核心原理是在动作组执行过程中,可以在需要的时候触发回调,将控制流程转移到预定义的子事件中。 这个功能允许我们在动作组中实现更复杂的逻辑,同时保持主要逻辑的清晰性。 使得我们可以在保持主要逻辑简洁的同时,实现复杂的分支和子流程。
这里是一个使用动作组回调的示例,实现在动作组中根据不同条件触发不同的子事件:
子事件 - 图16
点击下载:示例demo
注意事项:
  1. 动作组回调仅能添加在动作组下,不能在其他位置使用。
  2. 在设置回调参数时,要确保参数名称类型与子事件中的期望一致。
  3. 子事件的定义需要单独进入动作组的子事件界面进行,不要忘记这一步。
  4. 触发回调时,要确保传递的参数与定义的回调参数匹配。
动作组回调为动作组提供了强大的扩展能力。