用途:numeral-roller 用于把数字显示替换为老虎机式滚动效果。每位数字像印在旋转鼓上一样垂直擦入:旧数字底边短暂出现在画面上方,随后新数字完整显示,接着下一位数字顶边从下方露出。它与 count-up 不同,后者是平滑数值插值,而它是逐位离散切换。
主要能力:支持 digits_sequence 指定数字序列,per_digit_hold_frames 控制每位停留帧数,per_digit_wipe_frames 控制擦入帧数(3-5 为推荐区间),wipe_direction 可选 bottom-to-top(最常见)或 top-to-bottom。还可设置 font_family、font_weight、font_size_px、color、letter_spacing、per_digit_layout_balance 和 easing。
行为:先居中渲染当前数字(含逐字形 x 平衡);在擦入窗口内,当前数字向上平移 font_height,同时新数字从下方平移进入相同距离;新数字保持 per_digit_hold_frames;对下一位重复。擦入过程会产生“两位数字同时可见”的瞬间。
风格包覆盖:SP-A(marshmallow)适配秒表模式,覆盖为黑底白字;其他风格包未使用。
质量检查:使用线性缓动(无弹簧、无贝塞尔过冲);启用逐位布局平衡,使“1”与“8”位置不同以维持视觉重心;擦入窗口为 3-5 帧;擦入期间两位数字均可见,不做瞬间切换。
失败模式:若滚动感觉像动画而非机械运动,将缓动改为 linear;若数字像瞬移,说明擦入帧数过短(≤2),应提高到 4;若视觉重心偏移,说明逐位平衡关闭,需预先测量每个数字的 bbox 并应用 x 偏移。
限制:资料未提供安装方式、平台支持、收费或价格信息。