layout.meter

An amount within a known range, shown as a filled track: battery, storage used, a quota. Give it aria-label, aria-valuenow, aria-valuemin and aria-valuemax, and one layout.meter.fill inside

Component

<Layout>

Renders

<div>

Role

meter

Profile

View as Markdown

Example

Preview

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

Choosing between neighbours

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

If it is
Use
An amount within a known range, shown as a filled track: battery, storage used, a quota. Give it aria-label, aria-valuenow, aria-valuemin and aria-valuemax, and one layout.meter.fill inside
layout.meter this page
Progress while something loads
layout.loading
A number on its own
text.stat
A smooth amount where small differences matter
rather than layout.blocks
layout.meter this page
One amount within a range, like a battery level
rather than layout.chart
layout.meter 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.

Built from
arrange.stack

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.meter 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.meter
An amount within a known range, shown as a filled track: battery, storage used, a quota. Give it aria-label, aria-valuenow, aria-valuemin and aria-valuemax, and one layout.meter.fill inside
```
relative h-2.5 w-full overflow-hidden rounded-full
bg-surface-active
```

Final classes

flex min-w-0 flex-col relative h-2.5 w-full overflow-hidden
rounded-full bg-surface-active

Definition

'layout.meter': {
  kind: 'semantic',
  description: 'An amount within a known range, shown as a filled track: battery, storage used, a quota. Give it aria-label, aria-valuenow, aria-valuemin and aria-valuemax, and one layout.meter.fill inside',
  refs: ['arrange.stack'],
  binding: {
    ariaRole: 'meter',
    classes: 'relative h-2.5 w-full overflow-hidden rounded-full bg-surface-active',
  },
  notFor: [
    { context: 'progress while something loads', instead: 'layout.loading' },
    { context: 'a number on its own', instead: 'text.stat' },
  ],
},