MujicaUI/docs/components/487-masked-input.md

487 MaskedInput 掩码输入

用途

按格式掩码输入电话、卡号等：9 数字、a 字母、* 二者皆可，其余字符原样显示。值只保存填入的字符。

最小示例

phone := ""
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	input.MaskedInput(c, &phone, input.MaskedInputOptions{Mask: "(999) 999-9999", Label: "Phone"})
}

签名：func MaskedInput(c *ui.Context, value *string, opts MaskedInputOptions) InputResult

参数

字段	类型	默认值	含义
Mask	string	必填	掩码；没有可填位 panic。
value	*string	必填	已填字符；超长或不符掩码 panic。
Label	string	""	无障碍名称。
Disabled	bool	false	不可编辑。
Error	string	""	错误信息。

状态

未填位置显示下划线；输入法组合期间显示带下划线的组合文字，不提交、不跳格，只有提交的文字进入掩码。

事件

Changed()：值变化；Submitted()：Enter。另有 MaskFormat(mask, raw) 生成带格式文字。

键盘操作

左右方向键、Home/End 移动光标；Backspace/Delete 删除；粘贴只取符合掩码的字符；Enter 提交。

限制

自绘编辑器：没有文字选择与撤销，复制得到未格式化的值。