MaskedField 掩码输入

MaskedField - 掩码字段 是一个 TextField 文本框,支持对数据的内容做限制和格式化。

组件的 XML 名称:maskedField

基本用法

MaskedField 功能与 TextField 文本框 一样,但是对日期、社保号码、税号、电话号码等有格式的字符串输入更加方便,示例:

<layout spacing="true">
    <maskedField id="maskedField"
                 caption="Phone number"
                 mask="(###) ###-##-##"/>
</layout>
masked field

属性

mask

mask 属性为字段设置掩码,可以用下列字符:

  • # - 数字

  • U - 大写字母

  • L - 小写字母

  • ? - 字母

  • A - 字母或数字

  • * - 任何字符

  • H - 大写十六进制字符

  • h - 小写十六进制字符

  • ~ - 加号(+)或减号(-)字符

valueMode

valueMode 属性定义返回值的格式(带掩码或不带掩码),该属性可以有两个值:

  • clear - 默认值,上面示例中会返回 9967467927

  • masked - 上面示例中会返回 996-746-79-27.

事件和处理器

如需使用 Jmix Studio 生成处理器的桩代码,需要在界面 XML 描述或者 Jmix UI 层级结构面板选中该组件,然后用 Jmix UI 组件面板的 Handlers 标签页生成。

或者可以使用界面控制器顶部面板的 Generate Handler 按钮。

ContextHelpIconClickEvent

EnterPressEvent

参阅 EnterPressEvent

Validator

参阅 Validator

ValueChangeEvent

参阅 ValueChangeEvent

MaskedField XML 属性

MaskedField XML 元素