Context Indicator
显示对话上下文用量的环形指示器
用法
基础
占比超过 80% 进入 warning,超过 95% 进入 danger;档位写在 data-level 上,可据此覆盖样式。
Loading demo...
最佳实践
maxTokens用模型的真实窗口值,不要写死常量。- 本地化数字用
formatter,不要在外面另包文字,否则会与title中的值脱节。 - 从
warning档起才提示用户;常态下它只是背景信息。 - 放进可点击区域时,在外层补充可访问名称:
role="meter"不表达可点击。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
usedTokens | number | — | 已用的 token 数,必填。 |
maxTokens | number | — | 上下文窗口上限,必填;≤ 0 时占比按 0 处理。 |
label | string | '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。