ドキュメントを検索

Meter

ディスク使用量やバッテリー残量など、既知の範囲内の値です。

MeterはMeter WAI-ARIAデザインパターンに準拠しています。タスクの進行状況にはProgressを使用してください。

Storage25%
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>
  );
});

インストール#

個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。

pnpm add @leve-ui/meter

構造#

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はシグナルに従います。ボタンによって値が変更されると、メーターが更新されます。

Storage50%

値テキスト付き#

valueTextはパーセンテージを人間が読めるテキストに置き換えます(ここではmax={200}とともに使用)。Meter.ValueTextによって表示され、aria-valuetextとして使用されます。

Storage50 GB of 200 GB

APIリファレンス#

Root#

Propデフォルト型
value (必須)–number

現在の値。minとmaxの間にクランプされます。

min0number

最小値。

max100number

最大値。

valueText–string

値の人間が読めるテキスト(例:"50 GB / 200 GB")。aria-valuetextに使用され、ValueTextによって表示されます。デフォルトはパーセンテージ(例:"25%")です。

すべての<div>属性も受け入れます。

データ属性値
data-leve-meter常に存在
data-valueminとmaxの間に固定された値
data-minminの値
data-maxmaxの値

valueはminとmaxの間に固定されます。

Label#

独自のpropはありません。 すべての<span>属性を受け入れます。

データ属性値
data-leve-meter-label常に存在
data-value固定された値
data-minminの値
data-maxmaxの値

Labelは生成されたidを取得し、Rootはそれをaria-labelledbyで参照します。独自のidを渡す場合は、Rootにも同じ値をaria-labelledbyとして渡してください。

ValueText#

独自のpropはありません。 すべての<span>属性を受け入れます。

データ属性値
data-leve-meter-value-text常に存在
data-value固定された値
data-minminの値
data-maxmaxの値

RootのvalueTextを描画し、設定されていない場合は四捨五入されたパーセンテージ(例:"25%")を描画します。子要素は持ちません。

Track#

独自のpropはありません。 すべての<div>属性を受け入れます。

データ属性値
data-leve-meter-track常に存在
data-value固定された値
data-minminの値
data-maxmaxの値

Indicator#

独自のpropはありません。 すべての<div>属性を受け入れます。

データ属性値
data-leve-meter-indicator常に存在
data-value固定された値
data-minminの値
data-maxmaxの値
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にはキーボード操作はありません。