silverstripe-framework/docs/en/02_Developer_Guides/03_Forms/06_Tabbed_Forms.md

title	summary
Tabbed Forms	Find out how CMS interfaces use jQuery UI tabs to provide nested FormFields.

Tabbed Forms

SilverStripe's FormScaffolder can automatically generate Form instances for certain database models. In the CMS and other scaffolded interfaces, it will output TabSet and Tab objects and use jQuery Tabs to split parts of the data model.

[notice] All interfaces within the CMS such as ModelAdmin and LeftAndMain use tabbed interfaces by default. [/notice]

When dealing with tabbed forms, modifying the fields in the form has a few differences. Each Tab will be given a name, and normally they all exist under the Root TabSet.

[notice] TabSet instances can contain child Tab and further TabSet instances, however the CMS UI will only display up to two levels of tabs in the interface. [/notice]

Adding a field to a tab

$fields->addFieldToTab('Root.Main', new TextField(..));

Removing a field from a tab

$fields->removeFieldFromTab('Root.Main', 'Content');

Creating a new tab

$fields->addFieldToTab('Root.MyNewTab', new TextField(..));

Moving a field between tabs

$content = $fields->dataFieldByName('Content');

$fields->removeFieldFromTab('Root.Main', 'Content');
$fields->addFieldToTab('Root.MyContent', $content);

Add multiple fields at once

$fields->addFieldsToTab('Root.Content', [
    TextField::create('Name'),
    TextField::create('Email')
]);

API Documentation

• FormScaffolder