Browse the documentation

Reference

Style settings reference

Every setting in the Style and Layout tabs, its choices, and the CSS it becomes.

Every managed style setting Thallo has: the name it carries in the inspector, its path in an entry's data, the values it takes, whether it can differ by screen width, the class it compiles to and the CSS that class declares. This page is for theme authors, and for anyone who wants to know exactly what a setting does to a page. To use the settings rather than look them up, read the Design view.

The vocabulary

A token setting never holds a CSS value. It holds a name from one of six domains, and the theme maps every name to a value in theme.json. The names are ordinal scales, not promises about pixels.

Domain Names
spacing none xs sm md lg xl 2xl 3xl
width narrow content container full
radius none sm md lg full
color background surface surface-2 text muted line accent accent-contrast transparent white black, and brand-N brand-N-contrast for each brand colour the site configures
shadow none xs sm md lg xl
typography.size xs sm md lg xl 2xl 3xl

The compiler turns each mapping into one custom property on :root, the token's name with its dots replaced by hyphens and --t- in front: spacing.lg becomes --t-spacing-lg, typography.size.2xl becomes --t-typography-size-2xl, color.accent becomes --t-color-accent. Those are the variables the utilities below read, so a theme that re-maps a token re-skins every block that used it.

color.white and color.black fill themselves in as #ffffff and #000000 when a theme omits them, and are the same in light and dark mode; every other name but the brand colours has to be mapped, or the theme fails validation. There are no extra tokens: a document may reference baseline names only.

The brand names — brand-N and its -contrast text colour, for any number N from 1 to 9999 — are the site's, not the theme's: their values come from Appearance › Colours › Brand colours, where each colour keeps a permanent number that is never reused, and a theme that maps them has the mapping ignored (the Doctor warns). Their utilities come from the site's own colours stylesheet, not the theme's compiled one. Colour pickers list them as their own Brand colours group, in the site's order, with the text colours under Text colours.

A brand colour the site has not configured — cleared, never set up on this site, or any brand colour while the host's limit is 0 — is unavailable: a block, part, hover state, page, layout frame or region style naming it renders as if it never set that colour — the style class's value or the theme's shows through, and a hover colour leaves the resting colour in place. The editor shows such a value as Unavailable colour: Teal (removed) (a cleared colour, by the name it had) or Unavailable colour: Brand 7 (a number never used on this site, as in imported content), with No colour applied.

The breakpoints

There are three, and they are mobile-first.

Breakpoint From Stage preset
base 0px Mobile
md 768px Tablet
lg 1024px Desktop

A responsive setting holds a sparse map: a value at any of the three, or none. To resolve one at a target breakpoint, Thallo walks down from it — lg, then md, then base — and takes the first declaration it finds, so a value set at base reaches every width. A setting the tables below mark "no" is not responsive: it resolves at base only, holds one value for every screen width, and its row in the inspector offers no breakpoints to choose between.

How a setting becomes CSS

Settings live on the block, in settings.style, as typed values under the property's path. A responsive property nests its values under breakpoint keys; a non-responsive one carries the typed value directly.

json
{
  "style": {
    "spacing": { "padding": { "top": { "base": { "type": "token", "value": "spacing.md" },
                                        "lg": { "type": "token", "value": "spacing.2xl" } } } },
    "radius": { "type": "token", "value": "radius.lg" },
    "typography": { "weight": { "base": { "type": "choice", "value": "bold" } } }
  }
}

The four value kinds are token, choice, font and reset. A token must be a baseline name of the property's own domain; a choice must be one of the property's listed values. A font names a typeface by its ID — {"type": "font", "value": "serif"} — and only Typeface takes it: one of the built-ins theme, serif, humanist, geometric, slab, mono and system, or the 12-character ID of a family in the site's font library. Only the ID's shape is checked, never that the family exists, so a page stays valid after a family is removed or when it comes from another site.

The renderer resolves each property through the cascade — the block's style classes in list order, then the block's own settings — and emits one utility class per breakpoint where the result is declared exactly. An inherited value emits nothing, because the compiled artifact is already mobile-first. The layout properties and Distribute are the exception: they emit at every breakpoint they resolve to anything, because the rules for grid spans and for a mode's dormant settings have to read the parent's state at each width.

A class is t- plus the property's stem plus the value's last segment, with a breakpoint prefix above base: t-pt-lg, md:t-pt-lg, lg:t-radius-full. A slash in a value becomes a hyphen, so layout.basis 1/3 emits t-basis-1-3. In the stylesheet the colon is escaped — .md\:t-pt-lg.

Up to four stylesheets deliver all of it, in this order:

text
/_thallo/layers.css                  @layer theme, settings;
/theme-assets/theme-{hash}.css       @layer theme    — the theme's own CSS
/theme-assets/settings-{hash}.css    @layer settings — :root {--t-*}, then the utilities
/theme-assets/fonts-{hash}.css       @layer settings — the font library's faces and utilities

The fourth is linked only when the site's font library holds a family. It is the site's own: each workspace has its own, named by the hash of what it holds, and a version once written is never rewritten — a page that links an older one keeps getting the faces it was rendered with.

The utilities are emitted base first, then inside @media (min-width: 768px), then inside @media (min-width: 1024px). Because settings is the later layer, a setting always beats the theme, whatever the selectors say — which is why the theme build refuses !important on a managed property in any rule that names .thallo-block. The site's own custom CSS is unlayered, so it still wins over both.

The artifacts are served by content hash, so changing a theme's CSS, its vocabulary or the font library re-keys every cached page.

How a reset works

Reset to theme writes {"type": "reset"} at the breakpoint you are on. Two things follow.

In the data, resolution stops there: nothing from a narrower breakpoint and nothing from a style class shows through, and the property falls to the theme.

In the CSS, the block gets t-{stem}-reset — t-radius-reset, md:t-pt-reset — whose rule sets every CSS property that setting writes to revert-layer, handing the property back to @layer theme from that breakpoint up.

Some settings have an empty reset rule, and nothing to revert. Border sides, Rounded corners and Background opacity modify what another setting declares and share its CSS properties, so reverting would undo that setting too; Entrance, Repeat and Stagger children carry no declaration of their own on the element. Their reset still stops resolution.

Clear, beside it, is different: it removes the declaration entirely and lets whatever is underneath — a narrower breakpoint, a style class, the theme — show through.

For Typeface the reset is labelled Use theme default, and it returns the element to its contextual default rather than to one particular face: a heading may take the Headings face Appearance assigns, and an element the theme sets no font on inherits its parent's. To ask for the theme's own face whatever surrounds it, choose Theme.

The Style tab

The tab shows a group only where the block declares at least one of its settings; a block that declares none says This block declares no styling. Padding and margin are each drawn as one row of cells, labelled Padding and Margin.

Spacing

Setting Path Responsive Class Declaration
Padding top spacing.padding.top yes t-pt-{name} padding-top: var(--t-spacing-{name})
Padding right spacing.padding.right yes t-pr-{name} padding-right: var(--t-spacing-{name})
Padding bottom spacing.padding.bottom yes t-pb-{name} padding-bottom: var(--t-spacing-{name})
Padding left spacing.padding.left yes t-pl-{name} padding-left: var(--t-spacing-{name})
Margin top spacing.margin.top yes t-mt-{name} margin-top: var(--t-spacing-{name})
Margin bottom spacing.margin.bottom yes t-mb-{name} margin-bottom: var(--t-spacing-{name})

All six take a spacing token. There is no left or right margin: horizontal placement is Placement, on the Layout tab.

Text

Setting Path Responsive Class Declaration
Text alignment alignment.text yes t-text-{start,center,end} text-align: start / center / end

Typography

Setting Path Responsive Class Declaration
Typeface typography.family no t-font-{id} font-family: the family's stack, and font-synthesis
Size typography.size yes t-size-{name} font-size: var(--t-typography-size-{name})
Weight typography.weight yes t-weight-{value} font-weight: regular 400, medium 500, semibold 600, bold 700
Line height typography.line_height yes t-leading-{value} line-height: tight 1.1, snug 1.25, normal 1.5, relaxed 1.75, loose 1.9
Letter spacing typography.letter_spacing no t-tracking-{value} letter-spacing: tight -0.025em, normal normal, wide 0.05em, wider 0.1em
Text transform typography.transform no t-case-{value} text-transform: none, uppercase, lowercase, capitalize
Text decoration typography.decoration no t-decor-{value} text-decoration-line: none, underline, line-through
Font style typography.style no t-fstyle-{value} font-style: normal, italic

The line height is unitless, so it follows whatever the Size setting beside it resolves to.

Letter spacing, Text transform and Text decoration are set once for every width, and the Style tab says Applies at all sizes beside them. They are independent: choosing Uppercase adds no letter spacing, and changing the spacing leaves the casing alone. Letter spacing is in em, so it scales with the size. Normal is a value of its own: it writes letter-spacing: normal over whatever tracking the theme gives the element (the default theme tightens headings to -0.02em), where Use theme default gives the theme's tracking back.

Each row offers three different things that can look alike:

  • None (Text transform and Text decoration) writes an explicit none.
  • Use theme default writes a reset, so the element shows what the theme draws for it. Over a Button in its link style, which the theme underlines, that is the underline again.
  • Remove deletes the declaration, so a style class or the theme shows through.

Text decoration compiles to the text-decoration-line longhand only. The colour, thickness, style and underline offset a theme gives the decoration, including its hover thickness, stay as they are.

A decoration's None removes decoration set on the element itself. It cannot remove one drawn from an ancestor: in CSS an ancestor's underline is painted across its descendants and cannot be taken off them. Nor does it reach links styled on their own inside a Rich text block. To change a link's decoration, set it on the link: a Links block's Link part carries its own Text decoration.

Typeface takes a font value and is set once for every width. What its utility declares depends on what the ID names:

Value font-family font-synthesis Where the rule lives
serif humanist geometric slab mono system the named stack, ending with its generic weight style the settings stylesheet
theme the theme's own face, then the system stack weight style the settings stylesheet
a family in the font library "thallo-font-{id}", then its fallback's stack style the fonts stylesheet
a removed or unknown family inherit — the class is t-font-inherit inherit the settings stylesheet

The named stacks are serif "Iowan Old Style","Palatino Linotype","Book Antiqua",Georgia,serif; humanist Seravek,"Gill Sans Nova",Ubuntu,Calibri,"DejaVu Sans",source-sans-pro,sans-serif; geometric Avenir,Montserrat,Corbel,"URW Gothic",source-sans-pro,sans-serif; slab Rockwell,"Rockwell Nova","Roboto Slab","DejaVu Serif","Sitka Small",serif; mono ui-monospace,"Cascadia Code","Source Code Pro",Menlo,Consolas,"DejaVu Sans Mono",monospace; and system system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif.

An uploaded family is never given a faked bold: a weight its files do not supply is drawn from the nearest face the family has, and only italic may be slanted by the browser when there is no italic face. The stored ID is kept whatever happens to the family: a removed one renders as if nothing were set here — the element inherits — and comes back when the family is restored.

A block's parts carry their own Typography (settings.parts.{part}.typography.family, and the same for every Typography setting), so a card's title and its text can be set in different families; a block's style classes never reach a part.

Colours

Setting Path Responsive Class Declaration
Background colors.surface no t-bg-{name} --t-surface: var(--t-color-{name}); background: var(--t-color-{name})
Text colour colors.text no t-fg-{name} color: var(--t-color-{name})
Border colour colors.border no t-bc-{name} border-color: var(--t-color-{name})
Background opacity colors.surface_opacity no t-bgo-{100,90,80,70,60,50} background: color-mix(in srgb, var(--t-surface, var(--t-surface-default, transparent)) {n}%, transparent)
Backdrop blur backdrop.blur no t-blur-{value} backdrop-filter and -webkit-backdrop-filter: none, blur(4px), blur(12px), blur(24px)

Background compiles to the background shorthand, so it owns the whole background: a theme rule that paints the block with a gradient or an image yields to it, color.transparent clears it, and a reset gives the theme's background back. It also names its own colour in --t-surface so that Background opacity has something to mix; failing that, the opacity mixes whatever the theme named in --t-surface-default on the element, and failing that it changes nothing. Neither variable inherits, so a child given only an opacity never mixes its parent's colour.

A blur only shows through a background that is not opaque. Background opacity and Backdrop blur are the backdrop group, which a block type opts into separately from colors.

Effects

Setting Path Responsive Class Declaration
Shadow shadow yes t-shadow-{name} box-shadow: var(--t-shadow-{name})
Corners radius no t-radius-{name} border-radius: var(--t-radius-{name})
Rounded corners corners no t-corners-{value} all declares nothing; a set (tl-bl) sets border-{corner}-radius: 0 on the corners not in it
Border width border.width no t-bw-{value} border-width: none 0, thin 1px, thick 2px
Border style border.style no t-bs-{solid,dashed} border-style: solid / dashed
Border sides border.sides no t-bsides-{value} all declares nothing; a set (top-bottom) sets border-{side}-width: 0 on the sides not in it
Opacity opacity no t-opacity-{100,90,80,70,60,50} opacity: 1 … 0.5

Border sides and Rounded corners each name any set of sides or corners: all, or one, two or three of them, joined by - in clockwise order — sides top, right, bottom, left; corners tl, tr, br, bl. So left, top-bottom and tl-bl (both left corners) are values. In the Style tab they are toggles, every one on until set; the last one on cannot be turned off (no border is Border width None, square corners are Corners None). Both follow the setting they modify in the contract's table, so at equal specificity their rule wins. Rounded corners exists wherever Corners does: a block type that declares radius offers corners with it, on the same element, and corners cannot be declared alone.

Opacity fades the whole element, text and icon included. Background opacity, in Colours, fades only the background.

Hover

A link or button can say what it looks like under the pointer and under keyboard focus. On a section that has any of these settings, the Style tab shows a Normal / Hover switch: Hover shows the hover version of the section's settings and hides the rest. The switch is one state for the whole tab, and a dot on Hover marks a section with hover values set.

Setting Path Responsive Class Declaration
Text colour hover.colors.text no t-hover-fg-{name} as Text colour
Background hover.colors.surface no t-hover-bg-{name} as Background
Border colour hover.colors.border no t-hover-bc-{name} as Border colour
Opacity hover.opacity no t-hover-opacity-{100,…,50} as Opacity
Weight hover.typography.weight no t-hover-weight-{regular,medium,semibold,bold} as Weight
Text decoration hover.typography.decoration no t-hover-decor-{none,underline,line-through} as Text decoration

Weight and Text decoration are in Hover wherever the target or part also has them at rest: the switch shows on Typography too. On hover, Text decoration None takes away an underline the theme draws, such as a linked Heading's. A bolder weight makes the text a little wider, so the links beside it shift a little.

Each hover utility is compiled twice:

css
@media (hover: hover) {
  .t-hover-bg-accent:hover { --t-surface: var(--t-color-accent); background: var(--t-color-accent); }
}
.t-hover-bg-accent:focus-visible,
.t-hover-bg-accent[data-thallo-hover] { --t-surface: var(--t-color-accent); background: var(--t-color-accent); }
  • The pointer branch applies only where the device's primary input can hover, so a tap on a phone or tablet leaves nothing behind. On a touch-screen laptop, whose primary input can hover, a finger tap may still leave the hover look until the next tap elsewhere.
  • Keyboard focus shows the same look, so a keyboard user sees what a mouse user sees.
  • [data-thallo-hover] is the editor stage's preview of the hover look. It never appears on a published page.

A block covered by a link (a Rich text block with a Link: <a class="thallo-block-link"> over the text) cannot take focus itself; its cover does. So each hover utility has one more rule, which shows the block's hover look while its cover has keyboard focus:

css
.t-hover-fg-accent:has(> .thallo-block-link:focus-visible) { color: var(--t-color-accent); }

A Rich text block's hover values apply only while it has a Link: without one, its text keeps its colour under the pointer.

What beats what:

  • A hover value beats the resting value of the same property, at every width. Setting a hover background needs no resting one, and resetting one leaves the other.
  • A hover value beats the theme's hover rule for that property; the theme's other hover effects (a button's lift, a link's thicker underline) stay.
  • A hover background paints at full strength, even over a Background opacity.
  • Reset on a hover value compiles to an empty rule: it takes away a hover value a style class or a Social links row gave, and keeps the resting look.

Hover rules in a theme

The default theme writes each hover rule of these elements in three branches, so the stage's Hover preview shows exactly what the pointer would, and a tap on a phone does not leave it behind:

css
@media (hover: hover) {
  .thallo-block-file__link:hover { background: var(--surface); }
}
.thallo-block-file__link:focus-visible,
.thallo-block-file__link[data-thallo-hover] { background: var(--surface); }

Keep :focus-visible only where the rule already had it. A custom theme's hover rules keep working on a pointer unchanged. Until they take this form, the stage previews only the hover values set in the Style tab, and the theme's hover look may stay on a phone after a tap. Transitions are the theme's to set: the compiled utilities set none. The default theme fades every property a hover value can change on these elements, and turns the fades off under prefers-reduced-motion: reduce.

Marker

The Feature block's icon chip or number badge is a target of its own, so it has its own corners, shadow, colour, background, size and padding beside the card's.

Setting Path Responsive Class Declaration
Corners marker.radius no t-mradius-{name} border-radius: var(--t-radius-{name})
Shadow marker.shadow yes t-mshadow-{name} box-shadow: var(--t-shadow-{name})
Colour marker.color no t-mcolor-{name} color: var(--t-color-{name})
Background marker.background no t-mbg-{name} background: var(--t-color-{name})
Size marker.size yes t-msize-{name} font-size: var(--t-typography-size-{name})
Padding marker.padding yes t-mpad-{name} padding: var(--t-spacing-{name})

Colour colours the icon, or the number; Size scales the icon (it is 1em) or the number's text. An icon on a background is drawn as a chip, with room around the glyph. These beat the Block tab's Marker colour, background and size where both are set.

Padding is the room inside the marker, one value for all four sides (settings version 20). It replaces the chip's own room around an icon. A number badge given a Padding is no longer a fixed box: in the default theme it is its number with that padding all round.

The space between the marker and the text, beside it or above it, and where the marker sits against the text, are the Feature's own settings, in Spacing:

Setting Path Responsive Class Declaration
Space after icon feature.gap yes t-fgap-{name} gap: var(--t-spacing-{name})
Align icon feature.align yes t-falign-{start,center,end} align-items: flex-start / center / flex-end

Align icon places the marker against the title and description: Start, Center or End — top, middle or bottom beside the text, left, centre or right above it. Unset, the marker is level with the top of the text.

The headline, the optional short line above the title, is the Feature's Headline part: its own Typography, Text colour, and the space below it (Margin bottom). The default theme sets it small, uppercase and spaced out in the accent; Transform None and Letter spacing Normal undo that.

The description is the Feature's Description part: its own Typography, Text colour, and the space above it (Margin top). The block's Typography is the title's.

A number badge's lettering is the Feature's Number part: Typeface, Font style, Weight and Transform. The Style tab shows it only while the marker is a number. Its size is the marker's Size. A part declares this with when ({"field": "marker", "equals": "number"}): the section is shown only while that content field has that value.

A Navigation block's Menu button section styles the button a phone shows: Text colour (the icon), Background, Border colour, the border, Corners, its icon size (settings version 21), and Padding, the same per-side, per-width padding as any block's (t-pt-*, t-pr-*, t-pb-*, t-pl-* on the button).

Setting Path Responsive Class Declaration
Icon size menu_button.size no t-mbsize-{sm,md,lg} --thallo-menu-icon: sm 1rem, md 1.375rem, lg 1.75rem

The default theme draws the icon at 1.125rem until a size is set; the bars and the gaps between them grow with it. The button stays at least 44px square. Its padding is the theme's (--space-2 above and below, --space-3 at the sides) on any side not set.

Overlay

A Container's Overlay section: the layer over its background image or video, per screen size (settings version 22), and the colour it takes when set to Colour (settings version 23). Dark on Mobile and None on Desktop darkens a photo behind text on a phone only.

Setting Path Responsive Class Declaration
Overlay overlay.tone yes t-ovtone-{none,light,dark,color} --thallo-overlay-bg: none transparent, light #fff, dark #000, color the Overlay colour
Overlay opacity overlay.opacity yes t-ovopacity-{25,50,75} --thallo-overlay-opacity: 0.25, 0.5, 0.75
Overlay colour overlay.color no t-ovcolor-{color} --thallo-overlay-color: the palette colour

The layer covers the whole container, its padding included. The block's own Overlay and Overlay opacity fields (Content tab, Background) still apply, at every size: where a size has a value here, this one wins. With an Overlay and no opacity, the strength is 50%. A container never takes the overlay of the one around it.

Overlay colour is any colour of the site's palette, your Brand colours included: for a colour the palette does not have, add it as a Brand colour in Appearance, with its hex value. It is one colour for every size, like every colour setting, and shows at the sizes where Overlay is Colour. Overlay set to Colour with no colour chosen draws nothing.

Tabs

The Tabs block's strip, beside the panels area, which the block's own Corners setting governs.

Setting Path Responsive Class Declaration
Bar corners tabs.bar_radius no t-barradius-{name} border-radius: var(--t-radius-{name})
Active tab corners tabs.tab_radius no t-tabradius-{name} border-radius: var(--t-radius-{name})

Aside

The Hero block's aside — the blocks in its media column — is a target of its own, so it can be padded and filled as a panel beside the band's own spacing and background. Its corners and shadow are the block's Corners and Shadow, which already land on the aside.

Setting Path Responsive Class Declaration
Padding top aside.padding.top yes t-apadt-{name} padding-top: var(--t-spacing-{name})
Padding right aside.padding.right yes t-apadr-{name} padding-right: var(--t-spacing-{name})
Padding bottom aside.padding.bottom yes t-apadb-{name} padding-bottom: var(--t-spacing-{name})
Padding left aside.padding.left yes t-apadl-{name} padding-left: var(--t-spacing-{name})
Background aside.surface no t-abg-{name} background: var(--t-color-{name})

The padding is set a side at a time, in the same four-cell box as the block's own Padding. 1.0.0-beta.56 and 57 stored it as one value, aside.padding; that path is retired, so a stored value has no effect and is dropped the next time the page is saved.

Divider

The Footer block's divider: the line under its top section, which the theme draws as that section's bottom border. These settings style that edge alone, so they never draw a box around the section. Width none hides the line.

Setting Path Responsive Class Declaration
Colour footer.divider_color no t-fdivc-{name} border-bottom-color: var(--t-color-{name})
Width footer.divider_width no t-fdivw-{value} border-bottom-width: none 0, thin 1px, medium 2px, thick 4px
Style footer.divider_style no t-fdivs-{value} border-bottom-style: solid, dashed, dotted

The top section only renders while it holds blocks, so a footer with an empty top has no divider.

Logos

The Logos block's logos, each drawn at the height set for the width and no wider than its max width. Each logo keeps its own proportions, and every logo of a scrolling strip takes both settings, the copied run included.

Setting Path Responsive Class Declaration
Logo size logos.height yes t-logoh-{value} height: sm 1.75rem, md 2.5rem (the theme's own), lg 3.5rem, xl 5rem
Logo max width logos.max_width yes t-logow-{value} max-width: sm 6rem, md 8rem, lg 10rem, xl 12rem

Logo max width is a cap, not a width. A logo narrower than it is unchanged. A wider one, such as a long wordmark, scales down whole inside the cap, because the theme draws logos with object-fit: contain. Unset, nothing caps a logo's width.

The space between the logos is the Layout tab's Gap, Column and Row, which lands on the row of logos. Unset, the theme's own logo gaps apply: 2xl between logos and lg between wrapped rows.

Product grid

The Product grid's block settings (Spacing, Width, Visibility, As an item) land on the grid. Each card's pieces are parts, each a section of its own in the Style tab, and a part's settings reach that piece on every card:

Part What it styles Settings
Card the card Colours (background, border), Border, Corners, Shadow, Padding, Opacity; Hover: background, border colour, opacity
Image the image frame Corners
Title the product name's link Typography, Text colour; Hover: text colour, weight, text decoration
Price the price line Typography, Text colour
Meta the categories and tags Typography, Text colour
Button add to cart, or choose options Colours, Border, Corners, Typography, Padding, Opacity; Hover: text colour, background, border colour, opacity, weight, text decoration
Badge the sale and new badges Colours (background, text), Corners, Typography

The Title part is on the link inside the heading, where the pointer and keyboard focus land, so its Hover look shows on focus too. The heading's level is the Block tab's Title tag.

The card's hover effect, the image's ratio, fit and zoom are not style settings: they are the Block tab's Card fields, drawn by the shop stylesheet. They show only on devices that can hover, and on keyboard focus within a card; with reduced motion the card does not rise and the image does not zoom. The Shadow hover effect draws the theme's shadow, so a Shadow set on the Card part wins over it, at rest and on hover. With the Card part's Hover switch on, the stage previews the effects with the card's hover look.

Motion

None of these is responsive: an entrance is one event, not a layout. See animate blocks as they scroll into view for what they look like.

Setting Path Class Declaration
Entrance motion.entrance t-enter-{value} --t-enter-transform: fade none, fade-up translateY(1.5rem), fade-down translateY(-1.5rem), slide-left translateX(2rem), slide-right translateX(-2rem), zoom-in scale(0.92); none declares nothing
Duration motion.duration t-enterdur-{value} --t-enter-duration: fast 300ms, normal 600ms, slow 1000ms
Delay motion.delay t-enterdelay-{value} --t-enter-delay: none 0ms, short 150ms, medium 300ms, long 600ms
Repeat motion.repeat t-enterrepeat-{once,always} none; the page's script reads the class
Stagger children motion.stagger t-stagger-{value} none on the element; it sets --t-enter-stagger on the children
Ken Burns motion.ken_burns t-kenburns-{value} overflow: clip on the frame; none declares nothing

What makes an entrance move is one shared rule, which applies only where the visitor has not asked for reduced motion, the page's script has set data-thallo-motion on <html>, and the block has not entered yet. Without JavaScript nothing is ever hidden.

Stagger sets --t-enter-stagger on each child after the first, in steps of 80ms (short), 150ms (medium) or 250ms (long), and stops growing at the twelfth child. A <script> among the children is not counted. The delay a block waits is its own Delay plus its stagger.

Ken Burns drifts the img, picture or video that is the direct child of the element carrying the frame: zoom-in runs scale(1) to scale(1.15), zoom-out the reverse, pan-left and pan-right a scale(1.12) with a 3% translation each way, over a 20-second alternating loop.

Visibility

Setting Path Responsive Class Declaration
Visibility visibility yes t-vis-{visible,hidden} display: revert-layer / display: none

Visibility is the only setting that writes display on a block. Minimum height deliberately does not, so a hidden band stays hidden however tall it is told to be.

The Layout tab

Three sections, all driven by what the block declares: Container, how it arranges its children; Box, its own size and place; and As an item, how it sits inside its parent. A block that declares none of them says This block declares no layout.

Container

The mode's own controls sit under Layout, and the tab shows only the ones that mode uses. A mode switch deletes nothing: the tab lists what is being kept and ignored.

Setting Path Responsive Class Declaration
Layout layout.display yes t-display-{flex,grid} display: flex / grid
Content width layout.content_width yes t-cw-{name} max-width: var(--t-width-{name}); margin-inline: auto; --thallo-default-gutter: var(--t-spacing-lg) — for full, max-width: none and a 0px gutter
Gutter layout.gutter yes t-gutter-{name} padding-inline: var(--t-spacing-{name})
Columns layout.columns yes t-cols-{value} grid-template-columns
Direction layout.direction yes t-dir-{value} flex-direction: row / column / row-reverse / column-reverse
Wrap layout.wrap yes t-wrap-{nowrap,wrap} flex-wrap: nowrap / wrap
Distribute alignment.content yes t-content-{value} justify-content: start flex-start, center, end flex-end, between space-between, around space-around, evenly space-evenly
Align layout.align_items yes t-items-{value} align-items: start flex-start, center, end flex-end, stretch, baseline
Gap, column layout.gap.column yes t-gapx-{name} column-gap: var(--t-spacing-{name})
Gap, row layout.gap.row yes t-gapy-{name} row-gap: var(--t-spacing-{name})

There are two modes and no third: a container's children are block-level boxes, so the theme's default — a flex column with a spacing.xl gap — is what block flow used to be.

The column presets and the tracks each compiles to:

Value grid-template-columns
1 minmax(0, 1fr)
2 3 4 6 12 repeat(n, minmax(0, 1fr))
1-2 2-1 1-3 3-1 the two ratios, as minmax(0, {n}fr) each
1-2-1 1-1-2 2-1-1 the three ratios, the same way
auto grid-template-columns: none

auto is not a choice in the tab. It is the default track state, and a container that declares no column count still emits it at every breakpoint so that a child's Span has something to pair with.

Content width also carries the gutter's default, on the element itself, so a boxed ancestor's gutter never reaches a full-width container nested inside it.

Box

Setting Path Responsive Class Declaration
Width width yes t-w-{name} max-width: var(--t-width-{name}); width: 100% — for full, max-width: none
Placement alignment.self yes t-self-{value} margin-inline: start 0 auto, center auto, end auto 0
Minimum height layout.min_height yes t-minh-{value} min-height: auto auto, half 50vh, screen 100vh, with --thallo-root-layout: block for auto and flex otherwise
Overflow layout.overflow no t-overflow-{visible,hidden,auto} overflow: visible / hidden / auto
Content alignment alignment.content yes t-content-{value} as above

Width means "fill the available space, up to this maximum", which is why it asks for width: 100% as well. That renders as auto did in block flow only under box-sizing: border-box, which is the theme's to provide. In a flex row the width is the item's starting size, so it sizes items and can wrap them.

Overflow is the one layout setting that is not responsive: an overflow that changed with the viewport would hide content at one width and not another. The tab says Applies at all sizes.

Content alignment is the same property as Distribute, shown here instead for a block that distributes its own content without arranging children: the Navigation, Button, Color mode and Social links blocks.

As an item

These resolve against the parent's mode at the same breakpoint, so a grid parent offers Span, Align self and Order, and a flex parent offers Basis, Grow, Shrink, Align self, Order and Push.

Setting Path Responsive Class Declaration
Span layout.span yes t-span-{1..12,full} grid-column, paired with the parent's track class
Basis layout.basis yes t-basis-{value} flex-basis: auto, 1-4 25%, 1-3 33.333%, 1-2 50%, 2-3 66.667%, 3-4 75%, full 100%
Grow layout.grow yes t-grow-{0,1} flex-grow: 0 / 1
Shrink layout.shrink yes t-shrink-{0,1} flex-shrink: 0 / 1
Align self layout.align_self yes t-aself-{value} align-self: start flex-start, center, end flex-end, stretch
Order layout.order yes t-order-{value} order: first -1, default 0, last 1
Push layout.push yes t-push-{value} margin-inline: none 0, before auto 0, after 0 auto, both auto

Order and Push came with settings version 21. Order moves an item to the front or the back of its row at one size and not another: a header's menu button before the logo on phones, back in place on wider screens. Push gives the row's free space to one side of the item or both, which moves it and everything after it. It writes the property Placement (alignment.self) writes, and is emitted after it, so on a block with both the push wins. None also takes away the theme's own push: in the default theme the free space of a phone's header row goes after the logo.

Span never has a rule of its own. The compiler writes one rule for every pairing of a track count with a span, at each breakpoint, so exactly one rule matches and the later one wins:

css
.t-cols-3 > .t-span-2 { grid-column: span 2; }
.t-cols-3 > .t-span-4 { grid-column: 1 / -1; }
.t-cols-3 > .t-span-full { grid-column: 1 / -1; }
.t-cols-3 > .t-span-reset { grid-column: revert-layer; }

A span wider than the parent's tracks is clamped to the whole row. Each rule is written twice, the second reaching through the .thallo-preview-block wrapper the stage puts around every block.

Which settings a block offers

A block type declares two things. style_capabilities is the list of property paths it supports, written as exact paths or as group names that expand to them; undeclared means the setting is not offered, and there is no wildcard. style_targets names the parts of the block's template that can take settings, gives each part a kind, and maps each capability to one of them.

The group names a capability list may use are the contract's own: spacing, width, alignment, typography, visibility, shadow, radius, colors, border, layout, layout.item, marker, tabs, backdrop, motion, motion.children, motion.media, opacity, hover, feature.

hover gives a target the hover version of each colour and of opacity it already has, and no other: the Links block's links, which have a text colour only, get a hover text colour only. The rule is per target: on a block with several targets, a hover setting exists only where hover and its resting setting land on the same target. Mapping the hover group to a target skips what that target cannot have; mapping one hover path ('hover.colors.text' => 'root') to a target that lacks its resting path is refused. The admin reads what each block and part offers, already expanded, from the block type's style_paths.

A target's kind decides what may land on it, and the declaration is refused otherwise.

Kind What it is Settings only it may take
text a run of text Text alignment
row a line of items the block itself arranges Distribute
stack a content area that arranges child blocks Layout, Direction, Wrap, Align, Columns, both Gaps, Content width, Gutter
box any other element Minimum height, Overflow

Placement needs a box or a text target; the item settings need a box, row or text target; Distribute needs a row or a stack. Everything else may land on any kind.

A template styles a target by putting {{ style_classes('name') }} inside that element's class attribute and {{ style_attrs('name') }} on its tag. The template lint holds it to the declaration: every declared target is styled, no undeclared target is used, and no template writes a style attribute or a <style> element. Which blocks declare what is in the block library.

A block may also declare parts under style_targets: repeated elements styled on their own, such as a Links block's links. A part is not a target: none of the block's settings land on it. It has its own capability list and its own record, in the block's settings under parts.<name>, and the Style tab shows it as a section of its own under the block's settings, named by the part's label. A template styles a part with {{ style_classes('name') }} on every element the part names, and the lint requires each declared part to be styled. The block's style classes never reach a part.

php
'style_targets' => StyleTargets::root('box', ['spacing'], [/* the block's targets */])
    + ['parts' => ['link' => ['label' => 'Link', 'capabilities' => [
        'typography', 'colors.text', 'spacing.padding.top', /* … */
    ]]]],

The Advanced tab's four values go through the same map, each owned by exactly one target: the anchor becomes that element's id, data-* attributes are copied to it, and the accessibility label becomes its aria-label. Your own CSS class names are appended to the same element's classes. A data-thallo- prefix is reserved.

A block type made in the admin

A block type created under Settings › Block Types has one target — root, a box: its outermost element — because nobody is there to say which element each setting should land on. Its editor has a Style settings card, and the groups it may tick are these fourteen, in this order: Spacing, Width, Placement, Typography, Colours, Backdrop, Corners, Border, Shadow, Visibility, Minimum height, Overflow, Sizing in a parent layout, Motion.

Text alignment is not offered, because it needs a text target, and neither are the groups that arrange a container's children. A block that needs those, or more than one target, is declared in code. A block type Thallo or a pack declares shows its groups read-only: they are set in code and re-synced on every upgrade. See make your own block type.

Regions and pages

The header and footer take a smaller set: spacing, shadow, radius, colors and border, plus the backdrop pair. Not visibility, not layout, not typography. They have two targets — the bar itself, and the content inside it held to the container's measure — and padding lands on the content, everything else on the bar. See the header and the footer.

A page's own style frame, on the Page tab, takes spacing and colors.surface only.

Style classes declare the same things

A style class holds a style object in exactly the schema above, sparse breakpoints and resets included, and it is validated against the whole contract rather than against any block's capabilities. Applied to a block, each declaration lands where the block has the capability and lies dormant everywhere else, so a theme never sees classes as such — only the utilities the cascade resolves to.

The cascade resolves per property, not per group. A class that sets Grid and a direction contributes that direction to a block whose effective mode is Flex, because the block itself or a later class set it so.

What the browser must support

The public site needs cascade layers, revert-layer and color-mix(): Chrome 111, Firefox 113 and Safari 16.2 or newer.