MaskedField

MaskedField – это текстовое поле TextField, которое позволяет ограничивать и форматировать значения, которые могут быть в него введены.

XML-имя компонента: maskedField.

Основы

MaskedField повторяет функциональность TextField, но MaskedField удобно использовать, например, для ввода дат, телефонных номеров и т.д., например:

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

Атрибуты

mask

Атрибут mask задает маску для поля. Чтобы задать маску, используются следующие символы:

  • # – цифра

  • U – буква верхнего регистра

  • L – буква нижнего регистра

  • ? – буква

  • А – буква или цифра

  • * – любой символ

  • H – hex символ в верхнем регистре

  • h – hex символ в нижнем регистре

  • ~ – знак + или -

valueMode

Атрибут valueMode определяет формат возвращаемого значения (с маской или без). Принимает следующие два значения:

  • clear - по умолчанию. В примере выше будет возвращено значение 9967467927.

  • masked - в примере выше будет возвращено значение 996-746-79-27.

События и слушатели

Чтобы сгенерировать заглушку слушателя в Jmix Studio, выберите компонент в XML-дескрипторе экрана или на панели иерархии Jmix UI и используйте вкладку Handlers на панели инспектора Jmix UI.

В качестве альтернативы вы можете воспользоваться кнопкой Generate Handler на верхней панели контроллера экрана.

ContextHelpIconClickEvent

EnterPressEvent

Validator

См. Validator.

ValueChangeEvent

XML-атрибуты MaskedField

Просматривать и редактировать атрибуты, применимые к компоненту, можно с помощью панели инспектора Jmix UI в конструкторе экранов Studio.

XML-элемент MaskedField