Widget
Stack
A container that auto-arranges other widgets in a single row or column. Its members are real widgets from the page — any kind, fully interactive — that render inside the stack instead of on the canvas, sharing the space equally and reflowing the moment you flip the direction.
What it does
A stack adopts widgets that already live on the page and lays them out in one line — horizontal (a row) or vertical (a column). Each member keeps its own entity, styling, icons, and controls; a control widget inside a stack still toggles, a thermostat still dials. Members share the stack's space equally along its direction, so two members each take half, three each take a third, and so on. Flip the direction or change the spacing and everything reflows instantly — there's no rebuild and no layout to hand-edit.
Members are full widgets A stack doesn't hold a special "stack item" type. It holds ordinary page widgets by reference. Tap a member in the stack's settings and you get that widget's complete inspector — entity, label, icon, colors, everything a standalone widget has.
Add it
- Enter edit mode, tap Add Widget, choose Stack.
- Open the stack's inspector (tap the widget while editing).
- Add members — pick existing page widgets, select several entities at once, or create a brand-new widget straight into the stack.
- Set the direction and spacing, and drag members into the order you want.
An empty stack is invisible While editing, an empty stack shows a placeholder card so you can find and tap it. At runtime an empty stack draws nothing — it won't blot out whatever sits beneath it on the page.
Members
The stack's settings list every member with its icon and name. Three ways to add members, plus reorder and remove:
- Add entities — pick several — choose multiple entities at once; Flux creates a control widget for each one and drops them all into the stack.
- Add widgets from this page — adopt widgets that already exist on the page. The picker only offers widgets that aren't already in a stack (and never another stack).
- New widget in stack… — create a brand-new widget of any kind and place it directly into the stack, without a detour through the canvas.
- Reorder — drag members in the list; the order is the layout order along the stack's direction.
- Remove — tap the red minus. The widget isn't deleted — it returns to the canvas where it was.
Edit any member in place Tap a member's row to open its own full settings sheet — the same inspector it would have as a standalone widget. Changes apply immediately inside the stack.
No stacks inside stacks A stack can't be a member of another stack. The "new widget" and "add from page" pickers both exclude stacks, and a nested stack reference simply won't render. This keeps the layout finite and easy to reason about.
Settings
| Setting | What it does |
|---|
| Direction | Horizontal arranges members in a row; Vertical arranges them in a column. Switching reflows the layout instantly. |
| Spacing | Gap between members, 0–24 (steps of 2). The same value is also used as the stack's inner padding. |
| Items | The ordered list of member widgets. Add, reorder by drag, or remove. The header shows the current count. |
| Show Name | The stack's own label switch is authoritative for its members: turned off, it silences every member's name; turned on, it shows each member's name at the stack's label position. |
Equal sizing, not fixed sizing There's no per-member size or distribution control. Members always split the stack's space equally along its direction; to give one member more room, give it its own stack or place it on the canvas.
On Apple TV Interactive members stay interactive inside a stack — taps reach the individual member's controls. The stack's "Show Name" toggle drives whether member names appear.