Электронная почта — email

Определение

Компонент используется для ввода электронной почты. От обычного текстового поля он отличается возможностью верификации формата email.

Тип компонента в конфигураторе: email.

Внешний вид

JSON-схема для компонента электронной почты в конфигураторе:

"executor-email": {
                    "type": "email",
                    "title": "Электронная почта исполнителя",
                    "description": "Введите электронную почту специалиста..."
}

Как пользователь видит компонент:

Реакция компонента на неверную форму email:

Свойства

{
    "type": "email",
    "title": "Электронная почта",
    "description": "Введите электронную почту ответственного лица...",
    "helperText": "Введите адрес почты",
    "hidden": false
}

Свойство	Определение	Тип данных
type	Тип элемента. Для электронной почты — это всегда email.	string
title	Название поля, отображаемое в форме.	string
description	Описание поля. Отображается как заглушка поля в форме.	string
hidden	Это стандартное свойство для всех компонентов. При установке значения true для этого свойства, компонент будет скрыт из формы. Это свойство помогает выстраивать логику для работы с полями. То есть с помощью хуков есть возможность изменить значение этого свойства в определённых ситуациях. Либо использовать данные из этого поля в других местах, но так, чтобы конечный пользователь не видел этого.	boolean
helperText	Описание поля. Это стандартное свойство и отображается как текст под полем компонента.	string

Модель данных

Данные сохраняются в FormInstances в поле Data в виде JSON.

Заполненное поле электронной почты в пользовательском приложении:

После сохранения данные попадают в FromInstances в конфигураторе:

{
  "executor-email": "test@plotpad.ru"
}

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

Ниже компонент используется без description и с helperText. Также явно проставлено свойство "hidden": false.

"email": {
  "type": "email",
  "title": "E-mail поле",
  "hidden": false,
  "helperText": "Введите адрес почты"
}