Stat

数値データを目立たせて表示する統計情報コンポーネント。KPI、売上高、ユーザー数などのダッシュボード指標に使用します。

Basic

jui-stat の最も基本的な使用例です。

関連コンポーネント

  • Progress - 進捗状況の表示
  • Card - コンテンツのカード表示
  • Badge - ステータスバッジ의 表示

ブラウザ対応

このコンポーネントが使用しているブラウザ機能と対応状況です。

機能用途ChromeFirefoxSafariステータス
Flexboxラベルと数値、トレンド情報のレイアウト配置29+22+9+Baseline 2017
CSS 変数 (var())デザイントークンおよびアイコンサイズ適用49+31+9.1+Baseline 2017

💡 いずれの機能も主要ブラウザで広く対応済みです。

Baseline 情報

機能Baseline 達成Widely Available 予定
Flexbox2017年2020年前半 ✅
CSS 変数2017年2020年前半 ✅

アクセシビリティ

  • WAI-ARIA:
    • カード全体は role="group"(アクセシブルネームは label)として構造化され、ラベルと数値をまとめた一つのかたまり(グループ)であることが支援技術に伝わります。
    • トレンド(矢印等)を示すグラフィックスには aria-hidden="true" が付与されており、スクリーンリーダーの不要な読み上げを抑制します。代わりに、trend-value を通して具体的なテキスト情報を添えて伝えます。
  • キーボードナビゲーション:
    • 情報提示のみを行うコンポーネントであるため、フォーカス移動やキーボード操作の対象外(静的要素)となります。

CSS カスタムプロパティ

プロパティ名説明既定値
--jui-stat-icon-size統計ラベル横のアイコン(SVG)の幅および高さ16px

プロパティ

コンポーネントが受け付ける属性(Props)の一覧と詳細仕様です。

PropertyAttributeDescriptionTypeDefault
helpTexthelp-text補助テキストstring''
iconiconアイコンSVG(innerHTML)string''
labellabel統計ラベルstring''
suffixsuffix値のサフィックス(“件”等)string''
trendtrendトレンド方向"down" | "neutral" | "up"'neutral'
trendValuetrend-valueトレンド値(“+12.5%“等)string''
valuevalueメイン値(“1,234” 等の文字列)string''
valuePrefixvalue-prefix値のプレフィックス(”¥“等)string''

スロット

コンポーネント内に子要素を挿入するためのスロット一覧です。

SlotDescription
"icon"カスタムアイコン
"value"メイン値(value Prop より優先)

シャドウパーツ

CSSから直接スタイリング可能な内部要素(Parts)の一覧です。

PartDescription
"help"補助テキスト
"label"ラベル
"stat"ルート要素
"trend"トレンド表示
"value"メイン値

Built with StencilJS