menu

Node Creation Dialog Configuration

Support the documentation

This documentation was written by volunteers. Please help support our effort:

Help us improve the documentation

When creating new nodes, you have the possibility to ask for additional data during node creation. This data will be passed to nodeCreationHandlers.

The creation dialog supports most of the inspector editors, except of those that require to show a secondary inspector view. See Property Editor Reference for more details about configuring inspector editors.

For example, this functionality is used in Neos to ask users for Document title before creating document nodes:

'Neos.Neos:Document':
  ui:
    group: 'general'
    creationDialog:
      elements:
        title:
          type: string
          ui:
            label: i18n
            editor: 'Neos.Neos/Inspector/Editors/TextFieldEditor'
          validation:
            'Neos.Neos/Validation/NotEmptyValidator': []
  options:
    nodeCreationHandlers:
      documentTitle:
        nodeCreationHandler: 'Neos\Neos\Ui\NodeCreationHandler\DocumentTitleNodeCreationHandler'

You may register multiple nodeCreationHandlers per NodeType. Each nodeCreationHandler must implement NodeCreationHandlerInterface. It gets the newly created $node and the $data coming from the creation dialog.
 

Note

The elements of the creation dialog define an arbitrary set of data that will be passed to a nodeCreationHandler. Those elements will not automatically set node properties in any way. To take action based on that data you would need to write a custom node creation handler or use a package that already provides such functionality.


There are community packages which can help to define the node creation in Fusion only: