money-data は何をしますか?
お金に関するデータを、ユーザーが初めて見た瞬間に正しく理解できるように表示する方法。これらのルールは、コンシューマー向けアプリから高密度なB2Bツールまで同様に適用されます。タイポグラフィとデータ可視化の標準を厳格に金融データに適用し、Wise、Monzo、Stripe、Coinbase、Robinhood、Apple、IBM Carbonでの実践に基づいています。
このスキルは critical-core(リスク、感情、ビジュアルランゲージ)および money-flows(お金を動かすアクション)と組み合わせて使用してください。
このスキルの使い方
- すべての数値の役割を明確にします。 残高、支払い金額、差分、レート、予測、参照番号のいずれですか? 役割によって、形式、精度、色、配置が決まります。
- 必要なリファレンスを読み込んでからコードを書いたりコンポーネントを指定したりします。正確な値を使用し、形式をその場で考え出さないでください。
- ハッピーパスだけでなく、すべての状態を記述します。 すべてのマネー表示には、ローディング、古いデータ、保留中、失敗、空、非表示の状態があります。
- 引き渡す前に最後のチェックリストを実行します。
| リファレンス | これに使用 |
|---|---|
references/numbers-and-identifiers.md | 通貨フォーマット、補助通貨単位、丸め、コンパクト表記、負の数、タブラーフィギュア、口座番号のマスキング、単位と用量 |
references/color-and-gain-loss.md | ロケール別の増減色、色覚異常セーフな組み合わせ、マークのコントラスト、セマンティックトークン |
references/charts.md | グラフ選択、ベースライン、時間範囲、予測と不確実性、スパークライン、スクラブ、グラフのアクセシビリティ、ゲーミフィケーションの制限 |
references/progress-and-status.md | ローディングのしきい値、支払いと送金の状態マップ、カード、異議申立て、KYCステータス、貯蓄目標、クレジットメーター |
references/records-and-dashboards.md | 取引行、加盟店名のクレンジング、領収書、明細書、B2Bダッシュボード、財務データグリッド、監査ログ、照合 |
上記すべてのオリジナルデザイントークンは、リポジトリルートの /tokens にあります。
最も重要なルール
各ルールにはソースタイプが付いています: [REG] 法律または標準、[RES] 公開された研究、[PRAC] 文書化された企業の実践、[INF] criticalUXの統合。
- 手動ではなく、プラットフォームのAPIでフォーマットします。
Intl.NumberFormat(Web)、NumberFormatter/FormatStyle(Apple)、NumberFormat/DecimalFormat(Android)を使用します。これらは通貨記号の位置、区切り文字、各通貨の補助通貨単位(日本円はなし、KWDは3つ)を処理します。[PRAC] - すべての金額には通貨を表示します。 マルチカレンシー製品では数値だけを表示しないでください。記号が曖昧な場合($だけではUSD、CAD、AUD、MXNなどを意味し得る)はISOコード(USD)を使用します。[INF]
- 変化する数値や列に表示される数値にはタブラーフィギュアを使用します(
font-variant-numeric: tabular-nums)。プロポーショナルフィギュアは値が変動すると揺れて見えます。[PRAC] - コンパクト表記は軸やサマリータイルのみに使用します。 残高、支払い金額、手数料など、ユーザーがアクションを起こす可能性のある数値には決して使用しません。[INF]
- 部分の合計が全体と一致するか、または丸めが適用されていることを画面に表示します。 [INF]
- 正と負は、ハードコードされた緑と赤ではなく、ロケールまたは設定によって解決されるセマンティックトークンです。 中国本土、日本、台湾の市場では、赤は 増加 を意味します。常に色を記号(+/−)とグリフと組み合わせます。[RES/PRAC]
- グラフのマークは隣接する色に対して3:1のコントラスト比を達成し(WCAG 1.4.11)、色だけに意味を依存させません(WCAG 1.4.1)。[REG]
- 棒グラフはゼロから開始します。線グラフは開始しなくても構いません。 切り詰められた棒グラフは差を誇張します。[RES]
- 不確実な将来を単一の線で示してはいけません。 貯蓄、退職、ローン返済、または予測の予測には、ファンチャートまたはバンドチャートを使用します。2026年のイングランド銀行の調査(n≈1,600)では、ファンチャートが期待値と不確実性を最もよく伝え、予測が外れた後の信頼を守ることがわかりました。[RES]
- すべてのグラフにはテーブルビューと1行の見出しサマリーがあります。 スクラブにはキーボードとスクリーンリーダーでの代替手段があります。[PRAC]
- すべての差分のベースラインを明示します。 「+2.4% 本日(昨日の終値からの変化)」。[PRAC]
- 進捗は正直に表示します。 バックエンドの状態を、タイムスタンプ付きの3〜5つの平易な段階にマッピングします。「送信済み」は「到着済み」ではありません。到着予定時刻は推定値としてラベル付けされます。返金されたお金には、それ自体の非最終状態があります。[PRAC]
- タップが即座に登録されたことを示します。 「2回押さないでください」という警告は機能しません。「処理中」状態を即座に表示し、ボタンを無効にします。[RES]
- 識別子はデフォルトでマスクします(•••• 4421)、完全な番号を表示するには、要求に応じて再認証が必要です。[PRAC]
- 保留中はラベル付けして説明し、 利用可能残高に静かに追加または削除してはいけません。[INF]
- 投資、クレジット、支出チャートに報酬メカニズムを導入しないでください(トレードでの紙吹雪、スクラッチカードの表示、人気ランキング)。Robinhoodはこれらに関して2024年にマサチューセッツ州に750万ドルを支払いました。[REG]
クイックスペック
金額の階層。 残高や支払い画面では、金額は最大のテキストで、タブラーフィギュアで表示し、通貨記号は同じ視覚的な重みか一段階薄く表示します。小数点以下の桁は小さくてもかまいませんが、4.5:1以上のコントラストを維持します。
差分ラベル。 +£12.40 (+0.8%) today → 符号、絶対値、相対値、期間。色トークン + 矢印グリフ + 符号。ゼロの場合は、符号なし、ニュートラルカラーで £0.00 (0.0%) と表示します(signDisplay: "exceptZero")。
ステータスチップ。 アイコン + 言葉 + 色。色だけに依存しないでください。ユーザーが理解できる動詞を使用します:保留中、支払い済み、失敗、返金済み、返却済み。内部コード(AUTHORISED、SETTLED)は避けてください。
引き渡す前のチェックリスト
- すべての金額が、ユーザーのロケールと通貨に基づいてプラットフォームAPIでフォーマットされている
- 変化する数値や列内の数値にタブラーフィギュアが使用されている
- アクション可能な金額にコンパクト表記が使用されていない
- 増減にセマンティックトークン + 符号 + グリフが使用されている;色覚異常シミュレーターでテスト済み
- 棒グラフはゼロから開始;予測はバンドチャート;ベースラインが明示されている
- 各グラフに見出し、テーブルビュー、キーボードアクセスがある
- すべてのステータスに、ローディング、保留中、失敗、返却済み、古いデータの状態とタイムスタンプがある
- 識別子がマスクされている;表示は意図的な操作である
- すべてのマネー表示面で残高非表示(プライバシー)モードが機能する
- テキストが200%に拡大されても金額が切り詰められない
出荷製品の規制ポイントに依存する前に、各リファレンス内のソースリンクを読んでください。