Skip to content

Statistic 统计数值 ​

统计数值展示,Intl.NumberFormat 千分位与精度(locale 感知),支持前后缀与骨架屏加载占位。

基础用法 ​

基础数值

千分位与精度 ​

千分位 + 精度

前缀 / 后缀 ​

prefix / suffix

关闭千分位 ​

group-separator=false

加载态 ​

loading(复用 skeleton)

标题与额外区 ​

title 属性(或 slot="title")在数值上方渲染标题;extra 属性(或 slot="extra")在数值行下方渲染额外内容(如趋势脚注)。title 是原生全局属性,组件渲染后即从宿主吸收,避免悬停弹出浏览器原生提示。

title + extra(数据看板卡)

完成率环比 -1.2%

趋势指示 ​

trend="up" | "down" 在数值前渲染涨跌箭头,颜色走语义 token(涨 --oas-color-success-text / 跌 --oas-color-danger-text,暗色自动切换),可用 --oas-statistic-trend-up-color / --oas-statistic-trend-down-color 覆盖。

trend 涨跌

数值动画(组合 number-animation) ​

组件不内建 value 动画,通过 slot="value" 组合 oas-number-animation 实现滚动进入效果:

slot=value + oas-number-animation

字号定制 ​

字号默认固定为 --oas-font-size-lg(16px,不随外层变化),可用 CSS 变量 --oas-statistic-font 显式定制(如 32px)。

复杂前后缀(slot 分发) ​

slot=prefix / slot=suffix

总收入完成率

简单文本用 prefix-text / suffix-text 属性;复杂内容(图标/标签/徽标等)用同名 slot="prefix" / slot="suffix" 分发,slot 有内容时原生替换属性文本。prefix / suffix 为兼容别名(规范名 prefix-text / suffix-text),attribute 与 property(React / Vue 绑定)两条通道均可用。

API ​

oas-statistic ​

属性 ​

属性说明类型默认值
extra数值行下方额外内容(趋势脚注等)string—
group-separator千分位分组("false" 关闭)stringtrue
loading加载态(骨架占位)boolean—
precision小数位(四舍五入)string0
prefix-text前后缀文案——
suffix-text前后缀文案——
title数值上方标题(原生全局属性,渲染后吸收移除)string—
trend趋势指示:up(涨,success 语义色)/ down(跌,danger 语义色)+ 箭头string—
value数值(数字字符串)string0

插槽 ​

名称说明
extra数值行下方额外内容(趋势脚注等,分发时优先于 extra 属性文本)
prefix前置内容(图标/标签等复杂内容,分发时优先于 prefix 属性文本);简单文本用 prefix 属性即可
suffix后置内容(图标/标签等复杂内容,分发时优先于 suffix 属性文本);简单文本用 suffix 属性即可
title数值上方标题(分发时优先于 title 属性文本)
value自定义数值呈现(如组合 oas-number-animation 动画值;分发时不渲染 Intl 格式化文本)

CSS 变量 ​

CSS 变量默认值
--oas-statistic-fontvar(--oas-font-size-lg)
--oas-statistic-trend-down-colorvar(--oas-color-danger-text)
--oas-statistic-trend-up-colorvar(--oas-color-success-text)

无事件(纯展示)。

基于 MIT OR Apache-2.0 双许可发布