When to use it. A card with N faces that flips between them. Each face is a group (label, grid, nested children). Two faces give the classic front/back; more faces flip through in sequence and wrap. The active face index is the control value, so it syncs and fires
Type
flipCard
Also titled
Flip Card
Default size
2 rows × 2 columns
Symbol
rectangle.portrait.rotate
Docs
Docs complete
Search for it as
flip
card
reveal
two-sided
front back
flashcard
Rendered by the app
Fields
5 fields you can set on a flipCard control. Every control also takes the shared fields (id, position, span, sync, action).
Fields
Field
Type
Default
What it does
Flip byflipTrigger
choiceone of 2
tap
What makes it flip
Chooses whether a tap or a long press turns the card to its next face.
tapdefaulta quick tap flips the card
longPresspress and hold to flip, so taps reach controls on the face
Flip directionflipAxis
choiceone of 2
horizontal
Which way it turns
Turns the card left-to-right around a vertical axis or top-to-bottom around a horizontal one.
horizontaldefaultspins left to right like a page of a book
verticaltips top to bottom like a notepad
panelspanels
object
—
The faces of the card
Lists the faces the card flips through, each a group with its own controls.
containerAnimationcontainerAnimation
object
—
How the card animates when flipping
Tunes the flip motion, such as speed, bounce and 3D depth.
defaultValuedefaultValue
numberstep 1
0
Which face shows first
Picks the face shown at start, counting from 0.
Theme fields
Restyle one control by setting these in its theme object; a layout's theme sets them for every control.
Theme fields
Field
Type
Default
What it does
surfacePrimarytheme.surfacePrimary
color
#FFFFFF0F
Face background
Fills each face card with this color.
cornerRadiustheme.cornerRadius
number0–30 ptstep 1
12
How rounded the faces are
Rounds each face corner from square (0) to 30 points.
Frosted glasstheme.blurEnabled
on / off
true(on)
Outline thickness
Sets how thick the face outline is, 0 to 5 points.
Card spacingtheme.cardPadding
number0–32 ptstep 1
12
Main text color
Colors the main text on the faces.
Emits and receives
What this control sends when you use it, and what it can show or follow when data arrives.
Emits
Emits
Sends
When
Type
What it sends
When you flip itvalue
tap
number
the number of the face now showing, counting from 0
Faces flip in order and wrap round to the first
Example: 1
Receives
Receives
Takes
From
Type
What it does
valuefollow
hub, mqtt, http, store, default
number
the number of the face to show, counting from 0
the card flips to that face, turning once for each face it passes
Example: 1
Sample
The placeholder value the editor shows before real data arrives.
0 then 1
Examples
3 examples, each one a control you can paste into a layout.
actions, and a jump of several faces chains a flip per step.
3D Flip
The card rotates with perspective and back-face culling — the incoming face stays hidden
until the half-way point, so it never renders mirrored. Customize via containerAnimation:
Field
Type
Default
Description
profile
string
bouncy
Base spring profile
duration
number
—
Override flip seconds
bounce
number
—
Spring bounce 0–1
multiStep
bool
true
Chain a flip per step on a multi-face jump
stepInterval
number
0.12
Seconds between chained flips
flipPerspective
number
0.5
3D perspective amount
Theming
Faces are glass cards from the active theme. Set hideBackground on a face for a
transparent card.