emailField

emailField — это стандартный textField, который принимает в качестве входных данных только адреса электронной почты.

XML-элемент

emailField

Java-класс

JmixEmailField

Основы

ДЕМО

Компонент emailField — специализированное поле для ввода и проверки адресов электронной почты. Он расширяет базовый textField функциями и проверками для адресов электронной почты.

Пример использования emailField:

<emailField id="emailField" label="EmailField"/>

emailField связанный с данными

ДЕМО

Привязка данных означает связывание визуального компонента с контейнером данных. Изменения в визуальном компоненте или соответствующем контейнере данных могут вызывать обновления друг друга. Смотрите Использование компонентов данных для получения дополнительной информации.

Следующий пример создаёт emailField, связанный с данными.

<data>
    <instance id="customerDc"
              class="io.jmix.uisamples.entity.Customer"
              fetchPlan="_local"/>
</data>
<layout>
    <emailField id="emailField" label="Field connected to a container" width="15em"
                     dataContainer="customerDc" property="email"/>
    <hbox>
        <span text="Value in the container:"/>
        <span id="spanValue"/>
    </hbox>
</layout>

Контейнер экземпляра customerDc хранит сущность Customer. Атрибуты dataContainer и property связывают компонент с её атрибутом email.

Валидация

Чтобы проверять значения, введённые в emailField, добавьте валидатор во вложенный элемент validators.

Для emailField доступны следующие стандартные валидаторы:

XML-элемент

validators

Предопределённые валидаторы

custom - email - notBlank - notEmpty - notNull - regexp - size

Варианты темы

ДЕМО

Используйте атрибут themeNames, чтобы применить один или несколько вариантов темы.

Вариант Описание Поддерживается в

small

Уменьшает размер компонента.

Aura, Lumo

align-left

Выравнивает значение поля по левому краю.

Aura, Lumo

align-center

Выравнивает значение поля по центру.

Aura, Lumo

align-right

Выравнивает значение поля по правому краю.

Aura, Lumo

helper-above-field

Размещает вспомогательный текст над полем, под меткой.

Aura, Lumo

Атрибуты

emailField имеет следующие уникальные атрибуты:

Имя Описание По умолчанию

autoselect

Определяет, выделяется ли текст автоматически при получении полем фокуса.

—

clearButtonVisible

Определяет, отображается ли в поле кнопка очистки.

false

emailField имеет следующие общие атрибуты:

id - alignSelf - allowedCharPattern - ariaLabel - ariaLabelledBy - autocapitalize - autocomplete - autocorrect - autofocus - classNames - colspan - css - dataContainer - enabled - errorMessage - focusShortcut - height - helperText - label - maxHeight - maxLength - maxWidth - minHeight - minLength - minWidth - pattern - placeholder - property - readOnly - required - requiredMessage - tabIndex - themeNames - title - value - valueChangeMode - valueChangeTimeout - visible - width

Обработчики

emailField имеет следующие уникальные обработчики:

Имя Описание

validator

Проверяет значение компонента.

emailField имеет следующие общие обработчики:

AttachEvent - BlurEvent - ClientValidatedEvent - ComponentValueChangeEvent - CompositionEndEvent - CompositionStartEvent - CompositionUpdateEvent - DetachEvent - FocusEvent - InputEvent - KeyDownEvent - KeyPressEvent - KeyUpEvent - statusChangeHandler

Элементы

Компонент emailField может содержать следующие вложенные элементы: prefix, suffix, tooltip, и validator.

Смотрите также