The Sidepanel Controls (Sidepanel Control - Start, and Sidepanel Control - End) are paired Controls that need to be placed around a group of Fields on a Page. Any Fields contained between the Sidepanel Control - Start and Sidepanel Control - End will be displayed arranged against the specified edge of the agent's screen, commonly referred to as a "Sidepanel", rather than as part of the normal centred structure.
This feature is particularly useful for adding content you want to pin to remain visible to the agent at all times (e.g., a set of navigation Fields at the top of the Page), or easily use more of the screen space by including extra columns of content. A Control with similar capabilities are the
Floating Controls.
The Sidepanel Controls themselves aren't visible to agent by default, but can be styled with a background or border so that the contained Fields are visually grouped as in the example below:
These Controls are part of the Basic Control pack, and will always be available.
Place any Fields to be contained within the Sidepanel on the Page, and then place a Sidepanel Control - Start immediately above and a Sidepanel Control - End immediately below the group:
The Sidepanel is configured via the options for the Sidepanel Control - Start Field. The options and style can be configured in the
Options tab and
Styling tab of the Field Properties.
Sidepanel Control - Start Fields can be styled in a Stylesheet by referencing the control-side-panel-control-start class.
The Sidepanel Control - Start Control has two unique options available in its Options tab:
Option
|
Description
|
Resizable
|
If enabled, then the agent will be able to drag on the border of the Sidepanel to stretch or shrink it on the page.
|
Position
|
Controls which edge of the screen the Sidepanel will be placed on.
|
If multiple Sidepanels are configured with a Position against the same edge of the screen, then the Sidepanel placed closest to the top of the Page in the Designer will be the outermost, and the Sidepanel placed closest to the bottom of the Page in the Designer will be the innermost.
If using multiple Sidepanels on the same Page and configured as both Left/Right and Top/Bottom, then the Left/Right Sidepanels will always take the full height of the Page. The remaining Top/Bottom Sidepanels will then fill the remaining horizontal screen width between the Left/Right Sidepanels.
A Sidepanel cannot contain a
Table Break; including a Table Break within a Sidepanel will effectively end the Sidepanel and lead to the subsequent contained Fields of the Sidepanel being dropped into the main body of the Page during the record.