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

# Группа чекбоксов

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

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

![checkbox_group_settings_ru](checkbox_group_settings_ru.png)

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

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

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

## Чекбоксы { #options }

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

![checkbox_settings_ru](checkbox_settings_ru.png)

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

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

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

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