MujicaUI/docs/components/200-currency-converter.md

200 CurrencyConverter

用途

货币换算。

最小示例

state := mujica.CurrencyConverterState{Amount: 100, From: "USD", To: "JPY"}
currencies := []mujica.Currency{{Code: "USD", Name: "Dollar", Decimals: 2}, {Code: "JPY", Name: "Yen", Decimals: 0}}
rate := 149.37
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	r := mujica.CurrencyConverter(c, &state, currencies, mujica.CurrencyConverterOptions{Rate: rate})
	if r.PairChanged {
		rate = 0
		fmt.Println(state.From, state.To)
	}
}
ui.Render(view, 960, 440, 1)

参数

RateFrom/RateTo 指定汇率所属货币对，支持数值相同的刷新结果；货币小数位范围 0—12。

s 保存金额及货币对；currencies 至少两种，Decimals 为最小单位精度。Rate 默认 0 表示待提供；RateTime 零值隐藏；Disabled 默认 false。

状态

默认；交互区域支持聚焦与选中，Disabled 参数控制禁用。

事件

if r.PairChanged { rate = 0; 调用方回调(state.From, state.To) }

键盘操作

Tab 到达金额、币种和互换；方向键步进、选择；Enter/Space 互换。

限制

币种切换产生 PairChanged，调用方立即将 Rate 置 0 并获取新汇率；结果按目标货币精度取整。