Context Menu in JQuery TreeGrid widget

The Context menu in TreeGrid control is used to manipulate (add, edit and delete) the tree grid rows. In TreeGrid, context menu can be enabled with the contextMenuSettings property. The contextMenuSettings property contains two inner properties showContextMenu and contextMenuItems.

The showContextMenu property is used to enable or disable the context menu, default value for this property is false.

The contextMenuItems property is used to add the menu items to context menu, this property renders Add and Delete options by default when the menu items are not provided.

  • js
  • $("#treegrid1").ejTreeGrid(
            {   
               // ...     
                editSettings:{allowEditing: true , editMode:"rowEditing"},
                contextMenuSettings:{showContextMenu: true 
                                    contextMenuItems:[ "add","edit","delete"]},
                // ...             
            });

    The following screenshot displays the Context menu in TreeGrid control.

    Context-Menu_img1

    Context Menu in JQuery TreeGrid widget

    Header context menu can be enabled by setting showContextMenu as true. The default value of the showContextMenu property is false.

    Following options are shown in header context menu.

    • Column Chooser - Display all the column names; you can enable or disable a column by select or deselect the respective column name in the column chooser menu. This option is default option of header context menu.
    • Sort Ascending & Sort Descending - Used to sort the items in the column. These menu options will be displayed only when you enable the allowSorting property. To perform multilevel sorting, the allowMultiSorting property should be enabled.
    • Freeze, Unfreeze & Freeze Preceding Columns - Used to freeze or unfreeze the columns. These set of menu options will be displayed in all the columns when isFrozen property is enabled in any of the columns. However you can control the visibility of these menu options in a particular column by enabling/disabling the allowFreezing property of that specific column.

    The below code snippet explains how to enable header context menu in TreeGrid

  • js
  • $("#treegrid1").ejTreeGrid(
        {   
            // ...     
            contextMenuSettings:{showContextMenu: true },
            // ...             
        });

    The following screenshot displays the Header context menu in TreeGrid control.

    Context-Menu_img2

    ContextMenu Customization

    Context menu can be customized by adding a new custom menu item to it. In TreeGrid, context menu can be customized using the contextMenuOpen client-side event. This event is triggered when the context menu is rendered with mouse right click action. The following properties are available in the event.

    • headerText: Display text for menu item.
    • menuId: provides ID field for the created DOM element for custom menu item.
    • iconPath: Image location for menu item.
    • eventHandler: Client-side event for menu item click.
  • js
  • $("#treegrid1").ejTreeGrid({
                // ...     
                contextMenuSettings: {
                    showContextMenu: true
                },
                contextMenuOpen: customMenu,
                // ...             
            });
    
            function customMenu(args) {
                args.contextMenuItems.push({
                    headerText: "Custom Menu",
                    menuId: "customMenu",
                    iconPath: "url(.../images/customMenu.png)",
                    eventHandler: customMenuClick,
                });
                if(args.headerContextMenuItems){
                    args.headerContextMenuItems.push.apply({
                        headerText: "Delete Column",
                        menuId: "Delete",
                        iconPath: "url(.../images/customMenu.png)",
                        eventHandler: customHeaderMenuClick,
                    });
                }
            }
    
            function customMenuClick(args) {
                // ...
            }
    
            function customHeaderMenuClick(args) {
                // ...
            }

    The following screenshot displays the customization of Context menu in TreeGrid control.

    Context-Menu_img2