---
url: https://docs.juniper.bot/message-templates/components/text-input.md
description: >-
  В данной статье описывается компонент "Поле ввода", используемый в диалоговых
  окнах.
---

[действие]: ../../../cmd/custom/actions/index

[действия]: ../../../cmd/custom/actions/index

[действии]: ../../../cmd/custom/actions/index

[действий]: ../../../cmd/custom/actions/index

[действиях]: ../../../cmd/custom/actions/index

[`modal.values`]: ../../types/custom-commands/modal

# Поле ввода

Поле ввода — компонент ввода данных, позволяющий ввести какие-либо текстовые данные.

Настройки этого компонента представлены так:

![text_input_settings_ru](text_input_settings_ru.png)

* **Наименование** — название поля ввода, которое будет отображаться как заголовок;
* **Описание** — описание поля ввода, которое будет отображаться шрифтом поменьше;
* **Идентификатор** — идентификатор компонента, задаётся пользователем (придумываете сами);
  ::: info Информация
  Идентификатор должен быть уникальным среди других компонентов.

  Шаблон запускаемого диалоговым окном [действия] получает значения введённых полей в переменную-карту
  [`modal.values`], ключами которого являются данные идентификаторы.

  Таким образом, в [действии] можно определить что именно было введено.
  :::
* **Стиль** — стиль поля ввода. Либо многострочный, либо однострочный;
* **Минимально/максимально допустимая длина значения** — ограничения поля ввода по длине;
* **Текст-заглушка если ничего не указано** — текст, который будет отображаться внутри поля ввода если ничего не введено;
* **Значение по-умолчанию** — значение, которым будет заполнено поле по-умолчанию;
  ::: info Информация
  В данном поле работает [шаблонный движок](../../advanced/index) для возможности заполнить значение какими-либо данными.
  :::
* **Обязательно для заполнения** — если отметить, данное поле будет обязательно для заполнения.

## Доступность { #availability }

Данный компонент доступен только для действий [диалоговых окон](../../../cmd/custom/actions/modal-form).