可以为Boost!系列插件中发生的事件，用JavaScript添加独有的处理。本页面介绍事件处理程序的注册和删除方法，以及可以通过event对象执行的操作。各事件类型的详情，请参阅下方的链接。
介绍将事件处理程序注册到事件的方法以及删除的方法。
bst.event.on(type, handler)| 参数名 | 指定的值 | 说明 |
|---|---|---|
| type | 字符串或字符串数组 |
指定要绑定事件处理程序的事件类型或事件类型数组。 |
| handler | 函数 |
事件发生时执行的处理程序。 在事件处理程序中return Promise对象时，会等待异步处理完成后再开始下一个处理。 |
(() => {
"use strict";
const handler = (event) => {
console.log(event);
};
bst.event.on('bst.view.load', handler);
})();bst.event.off(type, handler)| 参数名 | 指定的值 | 说明 |
|---|---|---|
| type | 字符串或字符串数组 |
指定绑定了要删除的事件处理程序的事件类型或事件类型数组。 |
| handler | 函数 |
要删除的事件处理程序。请指定与绑定时相同的事件处理程序。 |
(() => {
"use strict";
const handler = (event) => {
console.log(event);
};
bst.event.on('bst.view.load', handler);
bst.event.off('bst.view.load', handler);
})();介绍在事件处理程序中可以通过event对象执行的操作。
在事件处理程序中改写记录对象的字段值并返回event对象，记录的字段值将被更新。
(() => {
"use strict";
bst.event.on('bst.change.field_1_', (event) => {
const record = event.record;
if (record.field_1_.value=='')
{
record.field_2_.value='option1';
}
return event;
});
})();在事件处理程序中将Lookup字段的lookup属性设为true并返回event对象，将自动获取该Lookup字段的值。
如需清除Lookup字段，请在value属性为空的状态下，将lookup属性设为true。
(() => {
"use strict";
bst.event.on('bst.edit.load', (event) => {
const record = event.record;
if (!record.field_3_.value)
{
record.field_3_.value=1;
record.field_3_.lookup=true;
}
return event;
});
})();在事件处理程序中将error属性设为true并返回event对象，包括后续处理在内的操作将被取消。
(() => {
"use strict";
bst.event.on('bst.create.submit', (event) => {
const record = event.record;
if (record.field_1_.value=='')
{
bst.alert('No value entered.');
event.error=true;
}
return event;
});
})();