跳到主要内容

5.8.6 设置图元事件

事件是数据驱动组态画面的核心机制:通过定义事件类型、事件动作与触发条件,图元可以在数据变化或鼠标操作时自动改变展现形式。事件类型有鼠标移入、鼠标移出、选中等,但最重要的是"图元属性值变化"。图元的属性可以与 IDMP 元素的一个属性绑定,当这个值的某个触发条件满足时,就可以触发指定的事件动作。而事件动作包括开始动画、停止动画等,但最重要的动作是"设置图元属性",可以改变图元的展现形式,比如图元的颜色、背景颜色、显示的文本等。下面挨个进行详细说明。

5.8.6.1 添加事件​

添加相应事件,即可实现相应的事件行为。提示:部分事件行为只有在查看时才展示效果,编辑时无法展示。

事件类型:鼠标移入、鼠标移出、选中、取消选中、鼠标按下、鼠标弹起、单击、双击、图元属性值变化。

事件行为:打开链接、设置图元属性、执行动画、暂停动画、停止动画、执行 JavaScript、执行 Window 函数、自定义消息。

如下图,为画布中图元设置了两个事件:当鼠标移入时,将背景色设置为绿色,当鼠标移出时,恢复背景色。

5.8.6.2 条件触发器​

可以为事件添加触发条件。触发条件最常用的是"关系运算",可以对图元的属性,包括值、进度、状态、文本进行逻辑判断(其他属性不提供逻辑判断的支持)。

如下图,设置当图元文本大于 30 时鼠标移入才会触发事件。图中演示,文本为 40 的图元满足条件,会触发背景变绿,而文本为 20 的图元不满足,鼠标移入时并不触发背景变绿。

触发条件数据结构​

触发条件由图元事件中的 where 对象描述,包含以下字段:

  • type:任意值,建议填写条件的功能名称以便阅读;为空时表示没有触发条件。
  • fn:条件函数,返回布尔值,优先级最高。
  • fnJs:条件的 JavaScript 代码文本,可获取 pen 和 context 参数,返回布尔值,优先级次之。
  • key:通过属性名进行条件比较,优先级最低。
  • comparison:属性比较运算符,配合 key 使用。
  • value:属性比较值,配合 key 使用。

comparison 支持的运算符如下:

运算符含义
>大于
>=大于等于
<小于
<=小于等于
=等于
!=不等于
[)介于。运算符本身仅表示"介于"语义,具体区间边界由 value 字段使用标准数学区间记法指定,支持 []、[)、(]、() 四种组合。例如 value 为 [0, 100) 表示包含 0 但不包含 100;(0, 100] 表示不包含 0 但包含 100;[0, 100] 表示同时包含 0 和 100
![)不介于,"介于"以外的范围,区间边界同样由 value 字段指定
[]属于集合,例如 [1,20,30..50,65],其中 30..50 表示 30 到 50 之间的连续整数区间;也支持字符串,例如 [1,20,aaa,值1]
![]不属于,"属于"以外的集合

5.8.6.3 执行 JavaScript​

当事件行为选择"执行 JavaScript"时,事件触发后会运行用户编写的 JavaScript 代码片段,可用于上报数据、调用接口、刷新业务状态等场景。代码片段中可以访问以下变量:

  • pen:当前触发事件的图元对象
  • params:在事件配置中传入的参数
  • context:执行上下文
  • arguments:原始事件参数

图元事件的等效数据结构示例:

// EventAction 由画布运行时提供,这里内联以便示例自洽:
// "JS" 即执行 JavaScript 代码块。
const EventAction = { JS: "JS" };

const pen = {
name: "rectangle",
text: "矩形",
x: 100,
y: 100,
width: 100,
height: 100,
events: [
{
name: "click",
action: EventAction.JS,
params: "我是参数", // 传递到代码块的参数
value: `
console.log('arguments', arguments);
console.log('当前点击的图元', pen);
console.log('参数', params);
console.log('上下文', context);
`, // 代码块
},
],
};

调用接口的示例(将以下任意一个字符串赋值给事件的 value 字段):

// 使用链式 .then()
fetch("/api/device/data?mock=1")
.then((res) => res.text())
.then((data) => console.log(data));

// 或者使用 async/await
(async () => {
const res = await fetch("/api/device/data?mock=1");
const data = await res.text();
console.log(data);
})();

5.8.6.4 事件的应用​

事件是驱动其他功能点的通用机制,通过"设置图元属性"事件行为可以修改图元的状态、值、进度等属性,通过"执行动画"等事件行为可以播放动画: