为 dhtmlxScheduler 的内部事件绑定处理函数
name | SchedulerEventName | 事件名称,大小写不敏感 |
handler | function | 处理该事件的函数 |
settings | object | 可选,事件处理函数的配置对象 |
string | id 绑定事件处理函数的标识符 |
scheduler.attachEvent("onEventSave", function(id, ev) {
if (!ev.text) {
alert("文本不能为空");
return false;
}
return true;
})
同一个事件可以绑定多个处理函数,所有处理函数都会被执行。
如果任何一个处理函数返回 false,则会阻止关联操作的执行。
处理函数按照绑定的先后顺序依次调用。
通过 event 添加的所有事件监听器,在调用 destructor 时会被自动移除。
配置对象可包含以下两个属性:
1. id - (string) 事件处理函数的唯一标识符
这便于从事件中移除特定的处理函数:
scheduler.attachEvent("onClick", function(){
console.log("event click");
}, {id: "my-click"}); ... //稍后:
gantt.detachEvent("my-click");
2. once - (boolean) 指示事件处理函数是否只执行一次
设置为 true 时,处理函数仅响应事件的首次触发,示例如下:
scheduler.attachEvent("onClick", function(){
console.log("capture next event click");
return true;
}, {once: true});