---
url: https://docs.juniper.bot/message-templates/components/radio-group.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

# Группа радиокнопок

Группа радиокнопок — компонент ввода данных, позволяющий участнику выбрать один из предложенных вариантов выбора в виде радиокнопок.

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

![radio_group_settings_ru](radio_group_settings_ru.png)

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

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

  Таким образом, в [действии] можно определить какие именно галочки были отмечены.
  :::
* **Обязательно для заполнения** — если включено, то компонент будет обязателен для заполнения;
* **Радиокнопки** — список радиокнопок в группе (от 2 до 10).

## Радиокнопки { #options }

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

![radio_settings_ru](radio_settings_ru.png)

* **Наименование** — название радиокнопки, которое будет отображаться как заголовок;
* **Значение** — значение радиокнопки, должно быть уникальным среди других радиокнопок группы;
  ::: info Информация
  Именно это значение будет передано в переменную-карту [`modal.values`].

  Таким образом, в [Действии] можно определить какой именно вариант был выбран.
  :::
* **Описание** — описание радиокнопки, которое будет отображаться шрифтом поменьше;
* **Выбрана по-умолчанию** — если включено, данная радиокнопка будет выбрана по-умолчанию.

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

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