Meter
A value within a known range, such as disk usage or battery level.
Meter follows the Meter WAI-ARIA design pattern. Use Progress for the progress of a task.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Meter } from '@leve-ui/meter';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Meter.Root value={25} class="meter-default">
<Meter.Label class="meter-default-label">Storage</Meter.Label>
<Meter.ValueText class="meter-default-value" />
<Meter.Track class="meter-default-track">
<Meter.Indicator class="meter-default-indicator" />
</Meter.Track>
</Meter.Root>
);
});.meter-default {
display: grid;
grid-template-columns: 1fr auto;
row-gap: 8px;
align-items: center;
width: 240px;
font-family: inherit;
}
.meter-default-label {
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
}
.meter-default-value {
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
text-align: right;
}
.meter-default-track {
grid-column: 1 / -1;
height: 8px;
border-radius: 9999px;
background: light-dark(#e2e8f0, #ffffff1f);
overflow: hidden;
}
.meter-default-indicator {
height: 100%;
/* Percentage of the Root value, set by the library */
width: var(--leve-meter-percent);
border-radius: 9999px;
background: #009dfd;
transition: width 200ms ease;
}
@media (prefers-reduced-motion: reduce) {
.meter-default-indicator {
transition: none;
}
}Installation#
Install the individual package, or use @leve-ui/core to get every component at once:
pnpm add @leve-ui/meternpm install @leve-ui/meteryarn add @leve-ui/meterbun add @leve-ui/meterpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/coreAnatomy#
import { Meter } from '@leve-ui/meter'; // or '@leve-ui/core'
<Meter.Root>
<Meter.Label />
<Meter.ValueText />
<Meter.Track>
<Meter.Indicator />
</Meter.Track>
</Meter.Root>
| Part | Element | Description |
|---|---|---|
Meter.Root | <div> | The meter, with role="meter". Holds the value and the range. |
Meter.Label | <span> | The label. Names the Root. |
Meter.ValueText | <span> | Shows the value text (by default, the percentage). |
Meter.Track | <div> | The whole range. Contains the Indicator. |
Meter.Indicator | <div> | The current value. Exposes the percentage as a CSS variable. |
Examples#
Controlled#
The value follows a signal. The meter updates when the buttons change it.
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Meter } from '@leve-ui/meter';
import styles from './controlled.css?inline';
export default component$(() => {
useStyles$(styles);
const value = useSignal(50);
return (
<div class="meter-controlled-wrapper">
<Meter.Root value={value.value} class="meter-controlled">
<Meter.Label class="meter-controlled-label">Storage</Meter.Label>
<Meter.ValueText class="meter-controlled-value" />
<Meter.Track class="meter-controlled-track">
<Meter.Indicator class="meter-controlled-indicator" />
</Meter.Track>
</Meter.Root>
<div class="meter-controlled-buttons">
<button
type="button"
class="meter-controlled-button"
onClick$={() => (value.value = Math.max(value.value - 10, 0))}
>
Decrease
</button>
<button
type="button"
class="meter-controlled-button"
onClick$={() => (value.value = Math.min(value.value + 10, 100))}
>
Increase
</button>
</div>
</div>
);
});.meter-controlled {
display: grid;
grid-template-columns: 1fr auto;
row-gap: 8px;
align-items: center;
width: 240px;
font-family: inherit;
}
.meter-controlled-label {
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
}
.meter-controlled-value {
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
text-align: right;
}
.meter-controlled-track {
grid-column: 1 / -1;
height: 8px;
border-radius: 9999px;
background: light-dark(#e2e8f0, #ffffff1f);
overflow: hidden;
}
.meter-controlled-indicator {
height: 100%;
/* Percentage of the Root value, set by the library */
width: var(--leve-meter-percent);
border-radius: 9999px;
background: #009dfd;
transition: width 200ms ease;
}
@media (prefers-reduced-motion: reduce) {
.meter-controlled-indicator {
transition: none;
}
}
.meter-controlled-wrapper {
display: flex;
flex-direction: column;
gap: 12px;
font-family: inherit;
}
.meter-controlled-buttons {
display: flex;
gap: 8px;
}
.meter-controlled-button {
height: 32px;
padding: 0 12px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
color: light-dark(#0f172a, #ffffff);
font: inherit;
font-size: 13px;
font-weight: 500;
cursor: pointer;
}
.meter-controlled-button:hover {
background: light-dark(#f1f5f9, #ffffff14);
}
.meter-controlled-button:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}With Value Text#
valueText replaces the percentage with a human-readable text, here with max={200}. It is shown by Meter.ValueText and used as aria-valuetext.
import { component$, useStyles$ } from '@builder.io/qwik';
import { Meter } from '@leve-ui/meter';
import styles from './with-value-text.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Meter.Root value={50} max={200} valueText="50 GB of 200 GB" class="meter-with-value-text">
<Meter.Label class="meter-with-value-text-label">Storage</Meter.Label>
<Meter.ValueText class="meter-with-value-text-value" />
<Meter.Track class="meter-with-value-text-track">
<Meter.Indicator class="meter-with-value-text-indicator" />
</Meter.Track>
</Meter.Root>
);
});.meter-with-value-text {
display: grid;
grid-template-columns: 1fr auto;
row-gap: 8px;
align-items: center;
width: 240px;
font-family: inherit;
}
.meter-with-value-text-label {
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
}
.meter-with-value-text-value {
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
text-align: right;
}
.meter-with-value-text-track {
grid-column: 1 / -1;
height: 8px;
border-radius: 9999px;
background: light-dark(#e2e8f0, #ffffff1f);
overflow: hidden;
}
.meter-with-value-text-indicator {
height: 100%;
/* Percentage of the Root value, set by the library */
width: var(--leve-meter-percent);
border-radius: 9999px;
background: #009dfd;
transition: width 200ms ease;
}
@media (prefers-reduced-motion: reduce) {
.meter-with-value-text-indicator {
transition: none;
}
}API Reference#
Root#
| Prop | Default | Type |
|---|---|---|
| value (required) | – | number The current value. It is clamped between |
| min | 0 | number The minimum value. |
| max | 100 | number The maximum value. |
| valueText | – | string A human-readable text for the value (e.g. |
Also accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-meter | Always present |
data-value | The value, clamped between min and max |
data-min | The min value |
data-max | The max value |
value is clamped between min and max.
Label#
No props of its own. Accepts all <span> attributes.
| Data attribute | Value |
|---|---|
data-leve-meter-label | Always present |
data-value | The clamped value |
data-min | The min value |
data-max | The max value |
The Label gets a generated id that the Root references with aria-labelledby. If you pass your own id, also pass the same value as aria-labelledby to the Root.
ValueText#
No props of its own. Accepts all <span> attributes.
| Data attribute | Value |
|---|---|
data-leve-meter-value-text | Always present |
data-value | The clamped value |
data-min | The min value |
data-max | The max value |
Renders the Root's valueText, or the rounded percentage (for example "25%") when it is not set. It has no children.
Track#
No props of its own. Accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-meter-track | Always present |
data-value | The clamped value |
data-min | The min value |
data-max | The max value |
Indicator#
No props of its own. Accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-meter-indicator | Always present |
data-value | The clamped value |
data-min | The min value |
data-max | The max value |
| CSS variable | Value |
|---|---|
--leve-meter-percent | The value as a percentage of the range, for example 25% |
The library does not set a width. Use the variable yourself, for example width: var(--leve-meter-percent).
Accessibility#
Complies with the Meter WAI-ARIA design pattern.
Meter.Rootrendersrole="meter"witharia-valuenow,aria-valueminandaria-valuemax, andaria-valuetextwhenvalueTextis set.- The Root is named by
Meter.Labelthrougharia-labelledby. If you passaria-labeloraria-labelledbyto the Root, that is used instead. - When the percentage alone does not describe the value (for example, "50 GB of 200 GB"), set
valueText. - Meter has no keyboard interaction.