{formbreak:part_name1:part_name2:...}

Description

Splits a slice item-edit form into named tabs (parts). You place it in a field Input before HTML in slice field administration; at that point in the form a new tab begins. Each colon-separated argument names a tab: the first names the new tab that starts here, and any further arguments pre-name the tabs that follow (handy for naming the last tab, which has no formbreak of its own). The command prints nothing - it only marks the split and registers the tab labels. By default the tab bar appears both above and below the form. Variants set the position: formbreaktop puts the tab bar only at the top, formbreakbottom only at the bottom. The companion command formpart prints the number of the current part. Tabs render only inside the item editor; the expression has no visible output on a public page.

Parameters

part_name1:part_name2:... optional default (none - tab shows as Part N)

One or more tab labels, separated by colons. The first label names the tab that starts at this point in the form; each further label pre-names a following tab. A label may be empty to leave a tab unnamed (it then shows as Part N). Labels are plain text. There is no fixed limit on how many you pass.

Examples

testBefore{formbreak:Contacts}After
ExpectedBeforeAfter
ActualBeforeAfter
Even with a tab label, formbreak emits an empty string. The surrounding text stays put: Before and After run together because nothing is inserted.
test[{formbreak:Details}]
Expected[]
Actual[]
The expression itself has no visible output. The brackets show that nothing is printed between them - formbreak only marks a tab split in the item editor.
virtual{formbreak:Body:Media:Notes}
Expected(empty output; names this tab Body and the next two tabs Media and Notes)
The first label, Body, names the tab that starts here. Media and Notes pre-name the next two tabs - useful for the last tab, which has no formbreak of its own to carry a name.
virtual{formbreak:One}{formbreak:Two}{formpart:}
Expected(the current part number, e.g. 2 after two splits)
Actual2
The companion command formpart prints the number of the current part. After two splits it reports the running count. The number depends on how many formbreaks ran before it in the same form, so it is not a fixed value.
virtual{formbreaktop:Basics:Media}
Expected(empty output; in the item editor the form gains a Basics and a Media tab, with the tab bar at the top)
Place this in the Before-input HTML of the first field of the Media part. Everything before it becomes the Basics tab; everything from there on becomes the Media tab, and the tab bar is drawn at the top of the editor. formbreakbottom would draw the bar only below the form; plain formbreak draws it both above and below. This is editor-only, so it is shown as illustrative.
virtual{formbreak:Related links}
Expected(empty output; in the item editor a new tab named Related links begins here)
Typical real use: put this in a slice field Input before HTML. From this field down, the item editor opens a new tab labelled Related links. On a page the output is empty.
← All expressions