Angular 进度条、计量表与环形指标 | ng-hub-ui-metrics

只读的 Angular 指标基元——一个线性进度条、一个分级计量表和一个圆环形仪表——由设计系统令牌驱动,并具备完整的 ARIA 语义。

API 参考

这里是 metrics 的完整契约:你可以绑定、监听、投影和设置主题的一切,都集中在一处。接入你需要的部分,自定义你想要的样式——它是 standalone 的,且对 signal 友好。

输入

通过 19 个输入项精细调校 metrics。像绑定任意 Angular @Input 一样绑定它们。

名称类型默认值描述
hub-progress · valuenumber0当前进度值,以 [0, max] 刻度表示。
hub-progress · maxnumber100进度刻度的上限。
hub-progress · indeterminatebooleanfalse为时长未知的工作呈现一个循环滚动的进度条;会去掉 aria-valuenow。
hub-progress · colorHubMetricsColor'primary'驱动指示器颜色的语义强调色,映射到 --hub-sys-color-* 令牌族。
hub-progress · sizeHubProgressSize'md'控制进度条粗细的尺寸令牌(sm、md 或 lg)。
hub-progress · showValuebooleanfalse是否在进度条旁边呈现取整后的百分比。
hub-progress · labelstring''描述进度条所测量内容的无障碍标签。
hub-meter · valuenumber0当前测量值,以 [min, max] 刻度表示。
hub-meter · minnumber0刻度的下限。
hub-meter · maxnumber1刻度的上限。
hub-meter · lownumber | undefinedundefined“low”区域的上限;省略时默认为 min。
hub-meter · highnumber | undefinedundefined“high”区域的下限;省略时默认为 max。
hub-meter · optimumnumber | undefinedundefined范围内的首选点;省略时默认为中点。
hub-ring · valuenumber0分数值,以 0..1 的比率或 0..max 的数字表示。
hub-ring · maxnumber1用于对数值进行归一化的上限。
hub-ring · sizenumber | string'4rem'环的外径(数字按 px 处理,或任意 CSS 长度字符串)。
hub-ring · thicknessnumber | string'0.5rem'环的描边宽度(数字按 px 处理,或任意 CSS 长度字符串)。
hub-ring · thresholdsHubRingThresholds | undefinedundefined可选的颜色阈值,按区段(low/high)为指示器重新着色。
hub-ring · showValuebooleantrue是否在中心呈现取整后的百分比。

输出

尚未记录任何输出项。

模板

打造你自己的样式——1 个模板插槽让你可以投影自定义标记。

名称描述示例
hub-ring · <ng-content>作为说明文字投影到环中心的内容,与内置百分比一并(或替代其)呈现。<hub-ring [value]="0.82" [thresholds]="{ low: 0.4, high: 0.75 }">Score</hub-ring>