WIP essentials 16

docs/components/487-masked-input.md

@@ -0,0 +1,43 @@
+# 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 提交。
+
+## 限制
+
+自绘编辑器：没有文字选择与撤销，复制得到未格式化的值。