layout.choices

The options for one setting, side by side in one track with the chosen one filled: theme, view, units

Component

Renders

<div>

Role

group

Profile

Example

Preview

One

Two

Three

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

Choosing between neighbours

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

  • If it is

    Use

  • The options for one setting, side by side in one track with the chosen one filled: theme, view, units

    layout.choices this page
  • Controls that act on the content below them

    layout.toolbar

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.choices 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.row

    Children in a wrapping row

    flex flex-row flex-wrap items-center
  • layout.choices

    The options for one setting, side by side in one track with the chosen one filled: theme, view, units

    w-fit flex-nowrap gap-0.5 rounded-full bg-foreground/5 p-1
    [&>button]:size-8 [&>button]:rounded-full [&>button]:border-0
    [&>button]:bg-transparent [&>button]:p-0
    [&>button]:text-surface-muted [&>button:hover]:text-foreground
    [&>button[aria-pressed=true]]:bg-foreground/10
    [&>button[aria-pressed=true]]:text-foreground
Final classes
flex flex-row items-center w-fit flex-nowrap gap-0.5
rounded-full bg-foreground/5 p-1 [&>button]:size-8
[&>button]:rounded-full [&>button]:border-0
[&>button]:bg-transparent [&>button]:p-0
[&>button]:text-surface-muted [&>button:hover]:text-foreground
[&>button[aria-pressed=true]]:bg-foreground/10
[&>button[aria-pressed=true]]:text-foreground
Definition
TS
'layout.choices': {
kind: 'semantic',
description: 'The options for one setting, side by side in one track with the chosen one filled: theme, view, units',
refs: ['arrange.row'],
binding: {
ariaRole: 'group',
classes: 'w-fit flex-nowrap gap-0.5 rounded-full bg-foreground/5 p-1 [&>button]:size-8 [&>button]:rounded-full [&>button]:border-0 [&>button]:bg-transparent [&>button]:p-0 [&>button]:text-surface-muted [&>button:hover]:text-foreground [&>button[aria-pressed=true]]:bg-foreground/10 [&>button[aria-pressed=true]]:text-foreground',
},
notFor: [
{
context: 'controls that act on the content below them',
instead: 'layout.toolbar',
},
],
},