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.
{
"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:
/_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
linkstyle, 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:
@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:
.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:
@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.
Menu button
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:
.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.
'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.