# onBeforeTaskChanged

### Description

@short: 在用户完成拖拽并释放鼠标按钮后，但在应用变更之前触发

@signature: onBeforeTaskChanged: (id: string | number, mode: string, task: Task) =\> boolean;

### Parameters

- `id` - (required) *string | number* - 任务 ID
- `mode` - (required) *string* - 拖放模式（"resize", "progress", "move", "ignore"）
- `task` - (required) *Task* - 在拖拽前的原始状态下的任务对象的拷贝

### Returns
- `result` - (boolean) - 定义事件默认动作是否会被触发（<b>true</b>）还是被取消（<b>false</b>）

### Example

~~~jsx
gantt.attachEvent("onBeforeTaskChanged", function(id, mode, task){
    // 在这里插入您的自定义逻辑 
    return true;
});
~~~

### Details

- 当任务在时间轴区域内被拖拽时触发该事件。
- 通过返回 *false* 可以阻止该事件，从而取消拖拽操作。
- 该事件在 [onAfterTaskDrag](api/event/onaftertaskdrag.md) 事件之前触发。

**task** 参数表示任务的原始（未更改）对象，而通过 **gantt.getTask(id)** 访问的任务数据则反映了更新后的状态。
这使得可以比较以检测拖拽过程中发生了哪些变化，比如持续时间是增加还是减少，开始日期是向前还是向后移动。<br>
从该事件返回 *false* 会使甘特图中的任务恢复到原始任务值。

### Related API
- [drag_mode](api/config/drag_mode.md)
- [onAfterTaskDrag](api/event/onaftertaskdrag.md)