Magnolia 5.7 reached extended end of life on May 31, 2022. Support for this branch is limited, see End-of-life policy. Please note that to cover the extra maintenance effort, this EEoL period is a paid extension in the life of the branch. Customers who opt for the extended maintenance will need a new license key to run future versions of Magnolia 5.7. If you have any questions or to subscribe to the extended maintenance, please get in touch with your local contact at Magnolia.

Editor is a component that edits a content item. The editor typically contains a form. In a content app, you should create an editor definition under the detail subapp. Define the node types the editor edits, a form for editing them, and actions for saving the edit.

detail:
  editor:
    nodeType:
      icon: icon-node-content
      name: mgnl:contact
    actions:
      - name: commit
      - name: cancel
    form:
      tabs:
        - name: personal
          # field definitions
Node nameValue

 detail


 editor


 nodeType


 icon

icon-node-content

 name

mgnl:contact

 actions


 commit


 cancel


 form


 tabs


 personal


 ...


Properties:

nodeType

required

A node type that this editor component can edit and save.

name

required

A Magnolia or JCR node type such as mgnl:page or mgnl:contact.

icon

optional

CSS class that identifies an icon displayed on the items in the workbench.

actions

required

Actions available in the editor. Define the actions in separate action definitions and reference them here by name.

<action-name>

required

Name of a primary action. Typically you need at least commit and cancel.

actionArea

optional

A secondary action area in the bottom left corner of the editor. Contains the action area configuration.

For an example, see Configuring secondary actions.

secondaryActions

optional

Add subnodes to match the secondary actions defined in the actionsnode. The order of the subnodes defines the sequence in which they are rendered. Actions configured under secondaryActions are rendered on the left  and other actions are on the right side.

<actionName>

required

Name of a secondary action.

actionRenderers

optional

Define a subnode for each action which requires its own renderer.

<actionName>

required

Name of the secondary action.

rendererClass

required

A renderer class if the secondary action requires one. Must implement ActionRenderer .

form

optional

A form definition if this editor is used to edit form-like data.

wide

optional, default is false

true opens the editor in wide mode using all available horizontal space.

Click the expand/collapse button in the top right corner to toggle between the wide and normal (720px) modes.