Числовое поле — number#

Определение#

Компонент используется для ввода числовых значений. Подходит для описания количества, качества и прочих числовых значений

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

Внешний вид#

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

"workers-amount": {
                "type": "number",
                "title": "Количество рабочих на этаже",
                "description": "Введите точное число рабочих..."
}

Как оно выглядит в пользовательском приложении:

Пример компонента

Свойства#

{
    "type": "number",
    "title": "Количество рабочих на этаже",
    "description": "Введите точное число рабочих...",
    "helperText": "Введите адрес почты",
    "hidden": false
}

Свойство

Определение

Тип данных

type

Тип элемента. Для числового поля — это всегда number.

string

title

Название поля, отображаемое в форме.

string

description

Описание поля. Отображается как заглушка поля в форме.

string

hidden

Это стандартное свойство для всех компонентов. При установке значения true для этого свойства, компонент будет скрыт из формы. Это свойство помогает выстраивать логику для работы с полями. То есть с помощью хуков есть возможность изменить значение этого свойства в определённых ситуациях. Либо использовать данные из этого поля в других местах, но так, чтобы конечный пользователь не видел этого.

boolean

helperText

Описание поля. Это стандартное свойство и отображается как текст под полем компонента.

string

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

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

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

Пример компонента

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

{
   "workers-amount": 31
}

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

В примере ниже компонент прописан с description. Также явно проставлено свойство "hidden": false.

"amount": {
  "type": "number",
  "title": "Количество",
  "hidden": false,
  "description": "Укажите количество"
}