Buttons doesn't make you choose between a clean layout and having everything available: a Popover keeps rarely-used controls one tap away without cluttering the canvas the rest of the time. This page covers creating a Popover, customizing how it opens and where it appears, and controlling it from elsewhere in the position.
Select the cell where you want the Popover's trigger button.
Click and drag to also select the cells the unfolded Popover should occupy.
Right-click the selection, then choose Create... → Popover.
Even though you selected multiple cells, only the trigger button occupies space until the Popover opens: the rest of the selected area stays free for other controls.
Select the Popover and use the Design tab to set the trigger button's own Layout, Icon, Text, and colors under Button Styling, plus the expanded section's own colors under Section Styling. When the inspector is narrow, its tabs show only their icons: the Design tab is the first one, with a brush icon.
The Popover tab, the last tab, controls the Popover itself:
Dimensions: the width and height of the unfolded section.
Snap to: where the unfolded section anchors. Button (the default) anchors it to the trigger button itself, and unlocks the Placement and Fit Surface options below. Absolute Position anchors it to a fixed spot on the canvas instead: turn on Position Offset and its X/Y become the section's exact canvas coordinates, so it always opens in the same place no matter where the trigger button sits. Choosing one of the Surface 1–8 options anchors it to a corner of that specific attached surface instead, and replaces Placement with a Corner picker (Top Left/Top Right/Bottom Left/Bottom Right).
Placement: (Snap to: Button only) which direction the section unfolds from the trigger button, chosen from a compass of eight directions.
Fit Surface: (Snap to: Button only, and only while Position Offset is off) whether the section is allowed to reposition itself to stay fully visible. Auto Fit Position flips the unfold direction away from Placement when the configured direction would run off the edge of the canvas. Force Placement always unfolds in the exact configured direction, even if that clips part of the section off the edge.
Position Offset: move the unfolded section away from the trigger button to any position on the canvas, instead of unfolding right next to it. For Snap to: Absolute Position, this is the only way to set where the section appears.
Animation: (Snap to: Button only) turn the open/close animation on or off.
Dismiss on click: automatically close the Popover after a button inside it is pressed.
Momentary: instead of toggling open and closed on separate presses, the trigger opens the section on press and closes it again as soon as it's released, like a hold-to-show control.
A Popover can also scroll its own content: on the Navigation tab, turn Scroll on to let the section's contents scroll vertically when they don't fit, with a Scrollbar option to show it automatically, hide it, or pin it to the left or right edge.
The Popover's Actions tab (the lightning-bolt icon) starts with the usual Press and Release handlers. Under Add Action Handler you can also add two Popover-specific ones:
Handler
Runs its actions
Press
When the trigger button goes down, as on any button.
Release
When the trigger button comes back up.
Open
Each time the Popover opens.
Close
Each time the Popover closes.
Open and Close are useful for setting something up while the Popover is in use and putting it back afterwards. For example, a Popover that holds camera shading controls can show the switcher's preview on the operator's monitor while it's open:
On the Popover's Actions tab, select Open and Close under Add Action Handler.
Under Open, add the ATEM Aux/Output: Set source action, with Aux/Output set to the monitor's aux (here Aux 1) and Input set to Preview.
Under Close, add the same action with Input set to Program.
Select Apply.
Opening the Popover on the surface now switches Aux 1 to Preview, and closing it switches Aux 1 back to Program. Other uses follow the same pattern: close another Popover with Set Popover State under Open so only one is open at a time, or reset a variable under Close.
Note
Open and Close only run when the Popover opens or closes on a surface. Holding Shift and clicking the trigger in the editor runs its Press and Release actions and opens or closes the Popover, but doesn't run Open or Close, so you can open and close the Popover while editing without changing anything on your devices. To try one of those actions on its own, use the lightning-bolt icon on that action's row.
To control a Popover from a different button, use the internal action Set Popover State:
On the button that should control it, add the Set Popover State action.
Under Popover, select which Popover it targets.
Under Command, choose Open, Closed, or Toggle.
This lets one button open a Popover, a different button close it, or a single button toggle it: useful when the trigger you want people to use isn't the Popover's own button.
