Поле ввода

Основы

Поле ввода на странице приложения настраивается с помощью компонента Input. Внешний вид поля ввода представлен на рисунке ниже.

Тип поля ввода 

Настраивается с помощью свойства inputType.

text

Тип поля ввода — текст. Устанавливается по умолчанию.

"values": {
    ....
    "inputType": "text"
}
password

Тип поля ввода — текст, который отображается символами *. Есть кнопка просмотра введенного текста.

"values": {
    ....
    "inputType": "password"
}

Внешний вид поля ввода 

Настраивается с помощью свойства appearance.

legacy

Отображается только нижняя граница поля ввода. Устанавливается по умолчанию.

"values": {
    ....
    "appearance": "legacy"
}
outline

Отображаются все границы поля ввода.

"values": {
    ....
    "appearance": "outline"
}

Текст подсказки 

Текст подсказки, который отображается в поле до начала ввода текста в него, определяет свойство placeholder.

"values": {
    ....
    "placeholder": "placeholder"
}

Заголовок поля ввода 

Текст заголовка поля ввода определяет свойство label. Расположение заголовка можно настроить с помощью свойства labelPosition.

auto

Автоматический перенос заголовка поля ввода при изменении доступного места для элемента ввода на экране. По умолчанию — слева, при сжатии — сверху.

"values": {
    ....
    "label": "auto",
    "labelPosition": "auto"
}
left

Заголовок отображается слева от поля ввода.

"values": {
    ....
    "label": "left",
    "labelPosition": "left"
}
hidden

Заголовок поля ввода скрыт.

"values": {
    ....
    "label": "hidden",
    "labelPosition": "hidden"
}
above

Заголовок отображается сверху поля ввода.

"values": {
    ....
    "label": "above",
    "labelPosition": "above"
}

Доступность поля ввода 

Доступностью поля ввода управляют свойства disabled и readonly.

disabled

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

"values": {
    ....
    "disabled": true
}
readonly

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

"values": {
    ....
    "readonly": true
}
Компонент Input
Основы

Input — компонент, который позволяет настроить поле ввода на странице приложения. Компонент Input использует собственные элементы <input> и <label> для доступности поля по умолчанию. Атрибут aria-label генерируется автоматически и указывает на родительский элемент <input>.

Cвойства 

id string

Уникальный идентификатор. Служебное поле.

control FormControl

Элемент управления.

label string

Заголовок поля ввода.

inputType string

Тип поля ввода. По умолчанию — text.

Возможные значения
text Тип поля ввода — текст.
password Тип поля ввода — текст, который отображается символами *. Есть кнопка просмотра введенного текста.
placeholder string

Текст подсказки, который отображаемый в поле до начала ввода текста в него.

appearance enum

Внешний вид поля ввода. По умолчанию — legacy.

Возможные значения
legacy Отображается только нижняя граница поля ввода.
outline Отображаются все границы поля ввода.
value string

Значение поля ввода.

disabled boolean

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

readonly boolean

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

autocomplete string

Устанавливает разрешение для браузера на автоматическое заполнение поля ввода. По умолчанию — off.

rowModeSizePx number

Ширина поля ввода — число, при котором компоненты Input и Checkbox перестраиваются с вертикального в горизонтальный вид при установленном режиме auto. По умолчанию — 320.

labelPosition string

Устанавливает место отображения заголовка поля ввода. По умолчанию — auto.

Возможные значения
auto Автоматический перенос заголовка поля ввода при изменении доступного места для элемента ввода на экране. По умолчанию — слева, при сжатии — сверху.
left Заголовок отображается слева от поля ввода.
right Заголовок отображается справа от поля ввода.
hidden Заголовок поля ввода скрыт.
above Заголовок отображается сверху поля ввода.