Tab configuration

The form-based content editor allows to group editor fields in tabs. The fields of which schema elements should be shown in which tabs is configured in the schema definition.

1 Configuration of tabs

Tabs are configured in the schema definition under xsd:annotations/xsd:appinfo. Use the node <tabs> to configure them. If used without sub-nodes, the tabs are configured automatically by OpenCms. To set up the tabs explicitely according to your needs, use a sub-node <tab> for each of them:

<tabs>
    <tab element="Title" collapse="false" name="General" />
    <tab element="Author" collapse="false" name="AuthorTab" />
    <tab element="Availability" collapse="true" name="Availability" />
</tabs>

In the example, three tabs are defined. Each <tab> element is configured via its attributes as follows:

Attributes of the <tab> node
element

Name of the first <xsd:element> placed in the tab.

collapse

If only one element (typically a nested content with sub-elements) should appear in one tab, the element's name can be hidden. Therefor, set collapse="true". Otherwise, omit it, or set it to false.

name

Define the name shown in the tab. This attribute supports %(key.) macro to insert localized messages. If the attribute is not given, the element's name is used as tab name.

When configuring tabs explicitely, the first tab should always start with the first schema element of your content. Otherwise OpenCms will add an additional first tab automatically.