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] 關鍵用戶體驗綜合。
- 使用平台 API 格式化,切勿手動處理。 使用
Intl.NumberFormat(Web)、NumberFormatter/FormatStyle(Apple)、NumberFormat/DecimalFormat(Android)。它們會處理符號位置、分隔符號以及每種貨幣的小數單位 (JPY 沒有,KWD 有三個)。 [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]
- 每個圖表都應提供一個表格檢視和一行標題摘要。 觸控探索功能需有鍵盤和螢幕閱讀器對應的操作方式。 [PRAC]
- 說明每個變動值的基準線。 "+2.4% 今日 (自昨日收盤起)"。 [PRAC]
- 進度顯示必須誠實。 將後端狀態對應到 3-5 個帶有時間戳記的明確階段。「已發送」不等於「已送達」。預計送達時間應標示為估計值。退回的款項有自己非最終的狀態。 [PRAC]
- 立即顯示點擊已註冊。 「請勿按兩次」的警告效果不佳;立即顯示「處理中」狀態並停用按鈕則有效。 [RES]
- 預設情況下遮罩識別碼 (•••• 4421),按需顯示時需重新驗證才能查看完整號碼。 [PRAC]
- 「處理中」狀態需標明並解釋原因,且絕不能在不告知的情況下,將其添加到可用餘額或從中扣除。 [INF]
- 投資、信貸或支出圖表上禁止使用獎勵機制 (交易成功噴彩帶、刮刮樂揭示、人氣排名)。Robinhood 在 2024 年為此向麻薩諸塞州支付了 750 萬美元罰款。 [REG]
快速規格
金額層級。 在餘額或付款畫面上,金額是最大的文字,使用表格數字,貨幣符號使用相同或輕一級的視覺粗細。小數位數可以較小,但對比度不得低於 4.5:1。
變動值標籤。 +£12.40 (+0.8%) 今日 → 符號、絕對值、相對值、期間。顏色代碼 + 箭頭字形 + 符號。零值顯示為 £0.00 (0.0%),無符號且使用中性顏色 (signDisplay: "exceptZero")。
狀態標籤。 圖示 + 文字 + 顏色,絕不能只有顏色。使用人們理解的動詞:處理中 (Pending)、已付款 (Paid)、失敗 (Failed)、已退款 (Refunded)、已退回 (Returned)。避免使用內部代碼 (AUTHORISED、SETTLED)。
交付前請檢查
- 每個金額都由平台 API 根據使用者的地區設定格式化,並帶有貨幣
- 所有變動中或欄位化的數字都使用表格數字
- 可操作的金額上沒有使用精簡表示法
- 漲跌使用語義代碼 + 符號 + 字形;已使用色盲模擬器測試
- 長條圖從零開始;預測值以區帶圖顯示;已說明基準線
- 每個圖表都有標題、表格檢視和鍵盤操作功能
- 每個狀態都有載入中、處理中、失敗、已退回和過時狀態,並附帶時間戳記
- 識別碼已遮罩;顯示是刻意行為
- 隱藏餘額 (隱私) 模式在所有金錢相關畫面上都能作用
- 文字可縮放至 200% 而不截斷金額
在將法規要點用於正式產品之前,請閱讀每個參考文件中的來源連結。