A Button Bar is a row of options, each running its own list of actions. It is the simplest way to put several related choices in one place - a set of filters, a row of page links, the steps of a process across the top of a form.


Settings

Options - The buttons on the bar. Each has a Name shown to the user, an optional Description, an Icon, a Show When condition deciding whether it appears at all, and its own list of Actions. Options can be dragged to reorder them, copied and deleted.


Navigation Mode - Changes what the bar is for.

  • On - The bar behaves as a navigation bar. It keeps track of which option is active and re-runs that option's actions when the bar comes back into focus, so returning to the form leaves the user where they were. This is the setting for a bar that moves between pages, panels or tabs.
  • Off - The bar is a plain row of buttons. Nothing is marked active and nothing is re-run.


Default Option - Which option is active when the form opens. Choose No Default Option to start with none selected.


Display

Option Display - How the options are drawn:

  • Options as Tabs - Drawn as a row of tabs, which reads as navigation.
  • Options as Buttons - Drawn as buttons.
  • Options as Links (stacked) - Plain links, one under another, which suits a bar in a narrow column beside the main content.
  • Options as Links (inline) - Plain links in a row.


Fill entire width - Stretches the options to fill the bar's width rather than sitting at their natural size.


Active Button Color / Active Link Text and their inactive counterparts set the colors for the selected and unselected options. The inactive settings only apply in Navigation Mode, since without it nothing is marked active. Leave them blank to follow the site's theme.


Building the buttons from data

Custom Buttons replaces the typed list of options with buttons built from data, so a bar can offer one button per record rather than a list maintained by hand - one per open task, one per department, one per document type.

Dynamic Source - The variable or function returning the data. The usual choice is a [DMGETOPTIONS()] variable that reads records from the system.


Row Delimiter and Value Delimiter - How a plain text source is split into buttons and into each button's parts. The defaults are a semicolon between rows and a caret between the parts of a row. These do not apply when the source returns JSON.


Notes

A Button Bar in Navigation Mode pairs naturally with a Modal Window, a Tab Container or a set of panels: each option shows one and hides the others, and the bar remembers which one the user was on.


Because each option carries its own Show When condition, one bar can serve several audiences - an Approve option that only appears for the team that approves, or an internal option hidden from a public form.