CommandPaletteActionProvider - how to group entries?

[rsoika]

Is there a way to group actions in a CommandPaletteActionProvider?
Currently my palette shows all actions ordered alphanumeric:

In videos I have seen that it should be possible. But I did not figure out how to realize this.

My code is more or less copied from the worklfow example and looks like this:

      actions.addAll(Sets.newHashSet(
         new LabeledAction("Create Manual Task",
            Lists.newArrayList(new CreateNodeOperation(ModelTypes.MANUAL_TASK, lastMousePosition.orElse(point(0, 0)),
               "fa-plus-square"))),
         new LabeledAction("Create User Task",
            Lists.newArrayList(new CreateNodeOperation(ModelTypes.USER_TASK, lastMousePosition.orElse(point(0, 0)),
               "fa-plus-square"))),
         ....
      ));

It seems that the interface CommandPaletteActionProvider did not provide any grouping?

Thanks for any hints or help.

[planger]

The command palette action provider is used to specify the actions shown in the palette that opens up on Ctrl+Space. In the GLSP code, the palette shown in your screenshot is called tool palette and its items are provided by an implementation of the ToolPaletteItemProvider.

The DefaultToolPaletteItemProvider collects all registered instances of CreateNodeOperationHandler and CreateEdgeOperationHandler and shows them in the group Nodes and Edges respectively. This is what you see in your screenshot.

If you want to provide custom grouping, you'll have to bind a custom ToolPaletteItemProvider.

   @Override
   protected Class<? extends ToolPaletteItemProvider> bindToolPaletteItemProvider() {
      return MyToolPaletteItemProvider.class;
   }

To create groups, use the following utils in the implementation of getItems in your provider (see also the implementation of DefaultToolPaletteItemProvider).

      return Lists.newArrayList(
         PaletteItem.createPaletteGroup("node-group", "Nodes", nodes, "symbol-property", "A"),
         PaletteItem.createPaletteGroup("edge-group", "Edges", edges, "symbol-property", "B"));

In addition, it is always possible to customize the entire tool palette on the client by rebinding your own implementation of the tool palette module.

[rsoika]

Thanks for clarification.
I have created a short doc page with the information you provided and a code example. Maybe you can use this in some way for the documentation:
https://github.com/imixs/imixs-bpmn.glsp/blob/master/doc/TOOL_PALETTE.md