TaskMenu

Displays a context menu for tasks. Items are populated by other features and/or application code. Configure it with false to disable it completely. If enabled, CellMenu feature is not available. Cell context menu items are handled by this feature.

Default task menu items

Here is the list of menu items provided by the Task menu feature and populated by the other features:

¹ Set showTaskColorPickers to true to enable this item

*

items that are shown for the locked grid cells only

>

first level of submenu

Customizing the menu items

The menu items in the Task menu can be customized, existing items can be changed or removed, and new items can be added. This is handled using the items config of the feature.

To add extra items for all events:

const gantt = new Gantt({
    features : {
        taskMenu : {
            // Extra items for all events
            items : {
                flagTask : {
                    text : 'Extra',
                    icon : 'fa fa-fw fa-flag',
                    onItem({taskRecord}) {
                        taskRecord.flagged = true;
                    }
                }
            }
        }
    }
});

Remove menu/submenu items

Items can be removed from the menu:

const gantt = new Gantt({
    features : {
        taskMenu : {
            items : {
                // Hide delete task option
                deleteTask: false,

                // Hide item from the `add` submenu
                add: {
                    menu: {
                         subtask: false
                    }
                }
            }
        }
    }
});

Manipulate items for specific tasks

Items can behave different depending on the type of the task:

const gantt = new Gantt({
    features : {
        taskMenu : {
            // Process items before menu is shown
            processItems({ items, taskRecord }) {
                 // Push an extra item for conferences
                 if (taskRecord.type === 'conference') {
                     items.showSessions = {
                         text : 'Show sessions',
                         ontItem({taskRecord}) {
                             // ...
                         }
                     };
                 }

                 // Do not show menu for secret events
                 if (taskRecord.type === 'secret') {
                     return false;
                 }
            }
        }
    }
});

Full information of the menu customization can be found in the "Customizing the Task menu" guide.

This feature is enabled by default