44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# 487 MaskedInput 掩码输入
|
||
|
||
## 用途
|
||
|
||
按格式掩码输入电话、卡号等：`9` 数字、`a` 字母、`*` 二者皆可，其余字符原样显示。值只保存填入的字符。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
phone := ""
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
mujica.MaskedInput(c, &phone, mujica.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 提交。
|
||
|
||
## 限制
|
||
|
||
自绘编辑器：没有文字选择与撤销，复制得到未格式化的值。
|