本文详细介绍了逻辑开发中的事件机制,包括平台支持的事件类型、事件处理器的配置和执行等。
事件类型
在魔笔平台中,事件可分为页面事件、页面组件事件、前端函数事件和集成操作事件。每种类型的事件都涵盖了不同的用户操作或系统状态变化,并可以触发相应的处理逻辑。
页面事件
页面事件是在整个页面级别触发的事件。下表列举了平台目前支持的所有页面事件:
事件名称 | 事件描述 |
挂载(mounted) | 页面加载完成时触发,可以用来初始化数据或设置状态。 |
页面组件事件
页面组件事件是在用户与页面中各个组件进行交互时触发的事件。下表列举了平台目前支持的常见页面组件事件:
不同页面组件支持的事件类型存在差异,请参考每个组件的详细说明文档。
事件名称 | 事件描述 |
点击(click) | 用户点击组件时触发,常见于按钮、链接等组件。 |
改变(change) | 用户修改输入内容时触发,常见于输入框、日期选择器组件。 |
聚焦(focus) | 组件获得焦点时触发,常见于输入框、日期选择器等组件。 |
失焦(blur) | 组件失去焦点时触发,常见于输入框、日期选择器等组件。 |
前端函数事件
前端函数事件是由自定义前端函数执行所触发的事件。下表列举了平台目前支持的所有前端函数事件:
事件名称 | 事件描述 |
成功(success) | 前端函数执行成功后触发。 |
失败(failure) | 前端函数执行失败后触发。 |
集成操作事件
集成操作事件是应用前端与后端服务和外部 API 交互时触发的事件。下表列举了平台目前支持的所有集成操作事件:
事件名称 | 事件描述 |
成功(success) | 集成操作执行成功后触发。 |
失败(failure) | 集成操作执行失败后触发。 |
事件处理器
为了响应特定的运行时事件,开发者需要在设计器中添加和配置一个或多个事件处理器,类似传统 JavaScript 开发中的addEventListener
机制。
添加和配置事件处理器
开发者可以在设计器中打开特定的页面、页面组件、前端函数或集成操作,并在弹出的属性面板对应位置添加和配置事件处理器。
以页面组件为例,点击属性面板中「交互-事件」右侧的“+”按钮,即可添加一个新的事件处理器。再次单击新添加的事件处理器条目,即可在弹出的“配置事件处理器”面板中完成配置。下图展示了如何为一个页面按钮组件的“点击(click)”事件配置事件处理器:
事件处理器的执行方式
当事件发生时,其对应的所有事件处理器都会立即在前端浏览器环境中执行。每个事件处理器可以认为是一个独立的 JavaScript 回调函数,它们在事件发生时被并行触发,彼此之间不存在时序依赖和先后性保证。
此外,单个事件在被响应的过程中,还可以触发新的事件,从而形成“触发 → 响应 → 触发 → 响应 →...”这样的事件处理链。开发者可以利用这一特性,编排和实现基于事件的复杂逻辑流程。
事件处理器的动作类型
配置一个事件处理器时,需要选择在事件触发时该处理器要执行的具体操作,即“动作”。下表列举了目前平台支持的所有事件处理器动作类型:
动作类型 | 用途描述 | 配置参数 |
控制组件 | 控制页面上的组件行为,例如:显示、隐藏、启用或禁用组件。 |
|
集成操作 | 调用一个集成操作,例如:执行数据库SQL、访问外部 HTTP API。 |
|
前端函数 | 调用一个前端函数 |
|
设置变量 | 更新一个作用域内可见变量的值。 |
|
执行脚本 | 执行一段自定义的前端 JavaScript 脚本。 |
|
显示消息 | 在页面上弹出一个消息通知框(一段时间后自动消失),为用户提供即时反馈。 |
|
跳转页面 | 导航到指定页面,实现应用内页面跳转。 |
|
用户登出 | 登出当前已登录用户,并清理用户会话。 |
|
事件处理器的高级配置
除了上述基础配置,事件处理器还支持如下一些高级配置选项,以允许开发者对事件处理逻辑进行更加精细的控制。
配置选项 | 用途描述 | 配置参数 |
执行条件 | 允许开发者指定事件处理器仅在特定条件下才执行。 |
|
防抖 | 用于限制高频率触发的事件处理器执行次数,以减少不必要的操作执行次数。 |
|