组件/Context Indicator

Context Indicator

显示对话上下文用量的环形指示器

Verified自 0.3.9

用法

基础

占比超过 80% 进入 warning,超过 95% 进入 danger;档位写在 data-level 上,可据此覆盖样式。

Loading demo...

最佳实践

  • maxTokens 用模型的真实窗口值,不要写死常量。
  • 本地化数字用 formatter,不要在外面另包文字,否则会与 title 中的值脱节。
  • 从 warning 档起才提示用户;常态下它只是背景信息。
  • 放进可点击区域时,在外层补充可访问名称:role="meter" 不表达可点击。

API 参考

属性

属性名类型默认值说明
usedTokensnumber—已用的 token 数,必填。
maxTokensnumber—上下文窗口上限,必填;≤ 0 时占比按 0 处理。
labelstring'Context usage'可访问名称,写入 aria-label。
formatter(used: number, max: number) => string—自定义环旁文字;缺省为「已用 / 上限」的紧凑记数,如 12.3K / 200.0K。

插槽

插槽名作用域参数说明
detail{ ratio: number, used: number, max: number }追加在文字之后,放百分比、剩余量或「清空上下文」入口。

概述

  • 占比为 usedTokens / maxTokens,夹在 0~1 之间:超发不会画出超过整圈的弧。
  • title 恒为「文字 (百分比)」,自定义 formatter 后悬停仍能看到百分比。
  • 根节点为 role="meter",同步 aria-valuemin / aria-valuemax / aria-valuenow;SVG 为 aria-hidden。