GitHub

layout.group

A few closely related elements kept together, e.g. a heading and its text

Component

<Layout>

Renders

<div>

Profile

UI
View as Markdown

Layout intents

Example

Preview

One

Two

Three

<Layout intent="layout.group">
  …
</Layout>

Choosing between neighbours

Find the row that describes your element, and use the intent on the right.

  • If it is

    Use

  • A few closely related elements kept together, e.g. a heading and its text

    layout.group this page

  • Separate blocks in a region, spaced apart

    layout.section

  • A few lines that read as one thing, like a heading and its text

    rather than layout.section
    layout.group this page

  • A heading and its text, read as one

    rather than layout.headline
    layout.group this page

  • Content that fits its column

    rather than layout.scroller
    layout.group this page

  • Content that is simply there, with no entrance

    rather than layout.arrival
    layout.group this page

  • Content that has arrived

    rather than layout.loading
    layout.group this page

Connections

Declared in the registry, both directions. Where an intent is used in your own code is something check and the gallery see; this site has no app code.

For registry authors

Starter intents. These are the intents prongs add puts in your registry, shown in this site’s theme. Yours are your own registry.ts: rename, restyle and add to them, and see them with prongs add gallery.

What this intent is built from and its entry in components/prongs/registry.ts. You only need this to change how it looks or to add an intent like it.

How layout.group resolves, and its definition

Each layer adds to the one before it; a later class wins over an earlier one that sets the same thing.

  • arrange.stack

    Children in a column, free to shrink inside a row or grid

    flex min-w-0 flex-col
  • layout.group

    A few closely related elements kept together, e.g. a heading and its text

    gap-2
Final classes
flex min-w-0 flex-col gap-2
Definition
TS
'layout.group': {
  kind: 'semantic',
  description: 'A few closely related elements kept together, e.g. a heading and its text',
  refs: ['arrange.stack'],
  binding: { classes: 'gap-2' },
  notFor: [
    {
      context: 'separate blocks in a region, spaced apart',
      instead: 'layout.section',
    },
  ],
},