Skip to content
Version 2026.25

Breakpoint Container ​

A container that shows one of several layouts, chosen by how wide the container is, so one screen can serve a phone, a tablet and a desktop.

In Studio ​

In Studio, double-click Breakpoint Container in the Containers category of the Components panel. It is added to the open view, where you can drag it into place.

When to use ​

Use a Breakpoint Container when the same screen has to work at very different widths — an operator view that must be readable on a phone and use the room on a wide monitor. Build a separate layout for each width range instead of squeezing one layout into all of them.

Properties ​

PropertyTypeDefaultDescription
Quality Markstandard, dimstandardHow a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way.

Binding ​

This component has no single value binding.

Layouts ​

A Breakpoint Container holds one or more layouts. Each layout has a Name (for you, such as Phone, Tablet or Desktop) and a Minimum Width in pixels, and holds its own set of components. A new container starts with two layouts: Phone (0) and Desktop (800). You can have as many layouts as you need.

The container shows the layout with the largest Minimum Width that is not wider than the container itself. With layouts at 0, 600 and 1024, a container 320 px wide shows the 0 layout, one 700 px wide shows the 600 layout, and one 1200 px wide shows the 1024 layout. A layout whose Minimum Width equals the container width counts as fitting.

  • The width that matters is the container's own width, not the browser window's. A Breakpoint Container inside a dock, a popup or an Embedded View follows the space it has there.
  • Only the layout being shown is drawn. The components of the other layouts are not created until their width range applies.
  • If two layouts have the same Minimum Width, the one higher in the list is used.
  • Until the container has been measured it shows the layout with the largest Minimum Width, so a desktop screen never flashes the phone layout while it loads.
  • If the container is narrower than every layout, it shows the layout with the smallest Minimum Width. Keep one layout at 0 so a very narrow screen always has its own layout.
  • The width compared against is the container's content width, inside any padding.
  • Give the container a definite width. A Breakpoint Container whose width depends on its own content (an automatic width inside a parent that shrinks to fit) can flip back and forth between layouts, because changing layout changes its width.
  • The container draws nothing of its own: no background, border or padding unless you set one in the Style section.

Edit layouts ​

Select the Breakpoint Container on the canvas. A strip along its top lists the layouts, each with its Minimum Width, for example Tablet · ≥600 px. Click a layout to show it, then add components to it like any other container. Each layout holds one component that fills it, normally a Coordinate or Flex container; add your other components inside that.

  • + adds a layout. It gets a unique name and a Minimum Width wider than the others.
  • Double-click a layout to rename it. A name cannot be empty or the same as another layout's (capitals are ignored).
  • Min width sets the selected layout's Minimum Width. It must be a whole number of pixels, 0 or more.
  • ‹ and › move the selected layout earlier or later in the list. The order only matters when two layouts have the same Minimum Width.
  • × deletes the selected layout. If it contains components, you are asked to confirm first, and its components are deleted with it. The last remaining layout cannot be deleted.

The Layouts list in the Properties panel shows each layout's Name and Minimum Width and accepts the same rules. Adding, deleting and reordering layouts is done on the canvas.

To check how the screen behaves at different widths, use Preview. In Preview the container picks its layout from its width exactly as it does at run time, and the layout strip is hidden.