Meter
ディスク使用量やバッテリー残量など、既知の範囲内の値です。
MeterはMeter WAI-ARIAデザインパターンに準拠しています。タスクの進行状況にはProgressを使用してください。
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;
}
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
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/core構造#
import { Meter } from '@leve-ui/meter'; // or '@leve-ui/core'
<Meter.Root>
<Meter.Label />
<Meter.ValueText />
<Meter.Track>
<Meter.Indicator />
</Meter.Track>
</Meter.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
Meter.Root | <div> | role="meter"を持つメーターです。値と範囲を保持します。 |
Meter.Label | <span> | ラベルです。Rootの名前を指定します。 |
Meter.ValueText | <span> | 値のテキスト(デフォルトではパーセンテージ)を表示します。 |
Meter.Track | <div> | 範囲全体です。Indicatorを含みます。 |
Meter.Indicator | <div> | 現在の値です。パーセンテージをCSS変数として公開します。 |
例#
Controlled#
valueはシグナルに従います。ボタンによって値が変更されると、メーターが更新されます。
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;
}値テキスト付き#
valueTextはパーセンテージを人間が読めるテキストに置き換えます(ここではmax={200}とともに使用)。Meter.ValueTextによって表示され、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リファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| value (必須) | – | number 現在の値。 |
| min | 0 | number 最小値。 |
| max | 100 | number 最大値。 |
| valueText | – | string 値の人間が読めるテキスト(例: |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-meter | 常に存在 |
data-value | minとmaxの間に固定された値 |
data-min | minの値 |
data-max | maxの値 |
valueはminとmaxの間に固定されます。
Label#
独自のpropはありません。 すべての<span>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-meter-label | 常に存在 |
data-value | 固定された値 |
data-min | minの値 |
data-max | maxの値 |
Labelは生成されたidを取得し、Rootはそれをaria-labelledbyで参照します。独自のidを渡す場合は、Rootにも同じ値をaria-labelledbyとして渡してください。
ValueText#
独自のpropはありません。 すべての<span>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-meter-value-text | 常に存在 |
data-value | 固定された値 |
data-min | minの値 |
data-max | maxの値 |
RootのvalueTextを描画し、設定されていない場合は四捨五入されたパーセンテージ(例:"25%")を描画します。子要素は持ちません。
Track#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-meter-track | 常に存在 |
data-value | 固定された値 |
data-min | minの値 |
data-max | maxの値 |
Indicator#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-meter-indicator | 常に存在 |
data-value | 固定された値 |
data-min | minの値 |
data-max | maxの値 |
| CSS変数 | 値 |
|---|---|
--leve-meter-percent | 範囲のパーセンテージとしての値(例:25%) |
ライブラリは幅を設定しません。width: var(--leve-meter-percent)のように、ご自身で変数を使用してください。
アクセシビリティ#
MeterのWAI-ARIAデザインパターンに準拠しています。
Meter.Rootはrole="meter"をaria-valuenow、aria-valuemin、aria-valuemaxとともに描画し、valueTextが設定されている場合はaria-valuetextも描画します。- Rootは
aria-labelledbyを通じてMeter.Labelによって名前付けされます。Rootにaria-labelまたはaria-labelledbyを渡した場合は、代わりにそれが使用されます。 - パーセンテージだけでは値を説明できない場合(例:「200 GB中50 GB」)、
valueTextを設定してください。 - Meterにはキーボード操作はありません。