MujicaUI

Essentials · #486

CurrencyInput 浅色主题渲染快照
浅色 · 渲染快照
CurrencyInput 深色主题渲染快照
深色 · 渲染快照

486 CurrencyInput 货币输入

用途

以最小单位(分)的整数保存金额,避免浮点误差;显示币种符号,未聚焦时按千分位分组,聚焦后显示纯数字便于编辑。

最小示例

cents := int64(123450)
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	input.CurrencyInput(c, &cents, input.CurrencyInputOptions{Symbol: "$", Label: "Price"})
}

签名:func CurrencyInput(c *ui.Context, value *int64, opts CurrencyInputOptions) InputResult

参数

字段类型默认值含义
value*int64必填金额的最小单位数。
Symbolstring""前缀符号,如 $、¥。
Decimalsint2小数位,0–6,越界 panic。
NoFractionboolfalse无小数(如日元);与 Decimals 同设 panic。
Labelstring""无障碍名称。
Disabledboolfalse不可编辑。
Errorstring""调用方错误信息。

状态

非法输入或小数位过多时保留输入并显示具体错误,值不变。

事件

Changed():合法输入改变了值。

键盘操作

Tab 聚焦;文本编辑、选择、剪贴板与撤销由 MyGo 编辑器提供。

限制

千分位与小数点固定为 , 与 .。