attachEvent

为 dhtmlxScheduler 的内部事件绑定处理函数

string attachEvent(SchedulerEventName name,function handler,object settings);
nameSchedulerEventName事件名称,大小写不敏感
handlerfunction处理该事件的函数
settingsobject可选,事件处理函数的配置对象
stringid 绑定事件处理函数的标识符

Example

scheduler.attachEvent("onEventSave", function(id, ev) {
    if (!ev.text) {
        alert("文本不能为空");
        return false;
    }
    return true;
})

Related samples

Details

同一个事件可以绑定多个处理函数,所有处理函数都会被执行。
如果任何一个处理函数返回 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});
See also
返回顶部