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)。它们处理符号位置、分隔符和每种货币的最小单位(日元为0,科威特第纳尔为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]
- 每张图表都有一个表格视图和一行标题摘要。 擦洗功能需具备键盘和屏幕阅读器等效操作。 [PRAC]
- 说明每个变化量的基线。 “+2.4% 今日(自昨日收盘价起)”。 [PRAC]
- 进度信息要诚实。 将后端状态映射为3-5个带有时间戳的简单阶段。“已发送”不等于“已到达”。预计到达时间(ETA)需标注为估算值。退回的资金应有其独立的非最终状态。 [PRAC]
- 立即显示点击已注册。 “请勿双击”警告效果不佳;一个瞬间显示的“处理中”状态并禁用按钮效果更好。 [RES]
- 默认屏蔽标识符(•••• 4421),按需显示完整号码时需重新进行身份验证。 [PRAC]
- 待处理状态需被标记和解释, 并且绝不能在不告知用户的情况下,被静默地添加或从可用余额中扣除。 [INF]
- 不要在投资、信贷或支出图表上使用奖励机制(交易成功时的五彩纸屑、刮刮卡式揭示、人气排名)。Robinhood在2024年因此向马萨诸塞州支付了750万美元罚款。 [REG]
快速规格
金额层级。 在余额或付款屏幕上,金额是最大的文本,使用表格数字,货币的视觉权重相同或略轻一级。小数位数可以更小,但对比度绝不能低于4.5:1。
变化量标签。 +£12.40 (+0.8%) 今日 → 符号、绝对值、相对值、时间段。颜色令牌 + 箭头字形 + 符号。零表示为 £0.00 (0.0%),无符号且使用中性颜色(signDisplay: "exceptZero")。
状态标签。 图标 + 单词 + 颜色,绝不能只用颜色。使用用户能理解的动词:待处理、已支付、失败、已退款、已退回。避免使用内部代码(如 AUTHORISED、SETTLED)。
移交前检查
- 每笔金额均由平台API根据用户区域设置格式化,并带有货币
- 所有变化或列中的数字使用表格数字
- 无紧凑表示法应用于可操作金额
- 盈亏使用语义令牌 + 符号 + 字形;已用色盲模拟器测试
- 条形图从零开始;预测用带状图表示;基线已说明
- 每个图表都有标题、表格视图和键盘访问方式
- 每个状态都有加载、待处理、失败、退回和过期状态,并带有时间戳
- 标识符已屏蔽;显示是经过用户确认的
- 每个金钱界面都支持“隐藏余额”(隐私)模式
- 文本缩放至200%时不会截断金额
在将某个监管要点用于发布产品之前,请先阅读每个参考文件中的来源链接。