Experience States and Print Layout
Scope: Shared state model for Experience blocks
State Model
Block states entries are optional and support three id classes:
- Pseudo-state IDs:
hover,active,focus,enabled,readonly,visited,selected,disabled - Media state IDs:
media-below-576,media-above-576,media-above-768,media-above-992,media-above-1200,media-above-1400,media-print - Generated custom IDs:
sxxxxxxmatching^s[a-f0-9]{6}$
State entry shape:
idname?activation?.when?for datum-driven states. A datum reference'spath(ondatumReference, or ondatumCondition.datum) selects the value the state is evaluated against. Paths in themeta.*namespace (for examplemeta.isDirty) resolve from the datum's runtime metadata rather than the entity value.overridesas partial block props
Media states do not require activation expressions.
The disabled pseudo-state can also take an activation. While it holds, a Button or Input is disabled (it can't be clicked or typed into) as well as taking the state's overrides.
Data States
A data state applies its overrides while a datum value is set, or while it matches a condition. Use one to restyle, show or hide a block from data, for example colouring a task chip by its status.
- Add one from the block's add-state menu with Data Condition. It is available for every block type, and a block can have any number of them.
- Each data state gets a generated id (
sxxxxxx), and you can rename it from its state menu. - With the data state selected, its activation editor sets the datum the state watches and an optional condition on it. With no condition, the state is active while the datum value is truthy. For a rich-text field, missing or null values, empty content, and content containing only empty or whitespace-only text are inactive. Text anywhere in nested content, media, and configured variables make the state active. Explicit conditions such as
isNotNullstill test presence, not whether rich text contains visible content. Remove condition clears the activation, so the state never applies at runtime. - In the designer, selecting any state previews its overrides, whatever its activation.
- When several active states set the same property, the state listed later wins.
Media States
State ID | Label | Emitted CSS |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Only media-below-576 is a max-width query: it applies below 576px. Every media-above-* state is a min-width query, so it applies at that width and up, and several can be active at once. When more than one active media state sets the same property, the state lower in the table wins, whatever order the states are added to the block. For example, on a 1300px-wide screen media-above-1200 overrides media-above-768.
Availability:
- Media states are available for all block types (Box, Link, Text, Image, Video, Audio, Button, Input, and Visualisation blocks).
- Pseudo-state availability depends on block type.
Page-Break Properties
Shared block props include print/page break controls.
Property | Type | CSS property |
|---|---|---|
|
|
|
|
|
|
|
|
|
These properties can be set directly on a block or through state overrides (including print-only media states).
Display and Hidden Blocks
display accepts:
noneinline-flexflexinline-gridgrid
When display: none is set through a media state (for example media-print), the block is excluded for that media context and layout reflows naturally.