MujicaUI/docs/components/476-usage-quota.md

476 UsageQuota

用量配额。

用途

每项资源的用量与上限进度条；接近与超出上限以图标与文字提示；显示重置时间。

最小示例

items := []mujica.QuotaItem{{Label: "API calls", Used: 4200, Limit: 10000}, {Label: "Storage", Used: 9, Limit: 10, Unit: "GB"}}
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	mujica.UsageQuota(c, items, mujica.UsageQuotaOptions{ResetAt: time.Now().Add(72 * time.Hour)})
}
ui.Render(view, 400, 300, 1)

参数

字段	类型	默认值	含义
items	[]QuotaItem	必填	Label、Used、Limit（>0）、Unit。
ResetAt	time.Time	零值	重置时间；一天内显示小时，否则显示日期。
Warn	float64	0.8	达到该比例即提示接近上限。

状态

正常、接近上限、已达上限。

事件

无。

键盘操作

不获取焦点；每项以计量角色读出。

限制

• 无。