---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.RadioGroup.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# control.RadioGroup

Расширяет [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md).

Группа переключаемых элементов. В группе всегда выбран только один элемент.

## Конструктор {#constructor}

```javascript
control.RadioGroup([params[, options]])
```

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `params` | — | Тип: Object\|[ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md)[]

Настройки группы элементов управления. Если в качестве настроек передан массив элементов управления, он трактуется как список дочерних элементов. ||
|| `params.items` | — | Тип: [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md)[]

Список дочерних элементов. Для указания элемента, который должен быть выбран по умолчанию, нужно выставить этому элементу опцию selectedByDefault=true. ||
|| `options` | — | Тип: Object

Опции. ||
|| `options.position` | \{ top: 5, left: 5 \} | Тип: Object

Положение элемента управления над картой. Задается в виде объекта со следующими полями: 
• top - отступ от верхнего края контейнера карты в пикселах;

• right - отступ от правого края контейнера карты в пикселах;

• bottom - отступ от нижнего края контейнера карты в пикселах;

• left - отступ от левого края контейнера карты в пикселах.

Если при этом заданы одновременно и top, и bottom, то значение bottom игнорируется. Аналогично, если заданы одновременно и left, и right, то значение right игнорируется. Если элемент управления добавляется в группу элементов (например, в тулбар или раскрывающийся список), то значение position не применяется. ||
|| `options.visible` | true | Тип: Boolean

Признак того, что элемент управления отображается. ||
|#

**Пример:**

```javascript
// Создание радио-группы элементов управления.
var radioGroup = new ymaps.control.RadioGroup({
        items: [
            new ymaps.control.Button({ data: { content: 'Сохранить' } }),
            // Вторая кнопка будет выбрана, если все остальные кнопки отжаты.
            new ymaps.control.Button({ data: { content: 'Включить' } }, { selectedByDefault: true })
        ]
    });
map.controls.add(radioGroup, {left: 10, bottom: 20});
// Изначально будет нажата первая кнопка.
radioGroup.get(0).select();
```

## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [data](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#data) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Данные группы.

Унаследовано от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#data). ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options). ||
|| [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#state) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Состояние группы.

Унаследовано от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#state). ||
|#

## События {#events}

#|
|| **Имя** | **Описание** ||
|| [add](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#add) | Произошло добавление дочернего объекта.

Унаследовано от [ICollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#add). ||
|| [childcontainerchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#childcontainerchange) | Изменение дом-элемента, в который добавляются дочерние элементы группы. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• newChildContainerElement - новый дом-элемент для дочерних элементов;

• oldChildContainerElement - старый элемент для дочерних элементов.

Унаследовано от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#childcontainerchange). ||
|| [mapchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#mapchange) | Сменилась карта. Поля данных:
• oldMap - старая карта;

• newMap - новая карта.

Унаследовано от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#mapchange). ||
|| [optionschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#optionschange). ||
|| [parentchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#parentchange) | Сменился родительский объект.

Поля данных:

• oldParent - старый родитель;

• newParent - новый родитель.

Унаследовано от [IChild](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#parentchange). ||
|| [remove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#remove) | Произошло удаление дочернего объекта.

Унаследовано от [ICollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#remove). ||
|| [select](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.RadioGroup.md#select) | Выбран один из элементов группы.
Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).
Имена полей, доступных через метод Event.get:

• item - ссылка на выбранный элемент группы. ||
|#

## Методы {#method}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [add](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#add)([item](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#add-param-item)[, [positionIndex](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#add-param-positionIndex)]) | [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md) | Добавляет элемент управления в группу. Элемент можно добавлять,
передав экземпляр класса, реализующего интерфейс [IControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md), или по ключу.

Возожные значения ключей:

• "mapTools" - стандартный тулбар с кнопками "Навигация", "Выделение" и "Линейка" [control.MapTools](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.MapTools.md);

• "miniMap" - обзорная карта [control.MiniMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.MiniMap.md);

• "scaleLine" - масштабный отрезок [control.ScaleLine](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ScaleLine.md);

• "searchControl" - панель поиска [control.SearchControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.SearchControl.md);

• "trafficControl" - панель пробок [control.TrafficControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.TrafficControl.md);

• "typeSelector" - панель переключения типа карты [control.TypeSelector](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.TypeSelector.md);

• "zoomControl" - ползунок масштаба [control.ZoomControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ZoomControl.md);

• "smallZoomControl" - простой ползунок масштаба [control.SmallZoomControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.SmallZoomControl.md).

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#add). ||
|| [each](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#each)([callback](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#each-param-callback)[, [context](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#each-param-context)]) | [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md) | Перебирает все элементы коллекции, вызывая для каждого функцию-обработчик.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#each). ||
|| [filter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#filter)([callback](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#filter-param-callback)) | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md)[] | Функция для выборки дочерних элементов по условию.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#filter). ||
|| [get](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#get)() | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md) | Returns ссылку на объект контрола, добавленного по ключу или по индексу.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#get). ||
|| [getAll](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#getAll)() | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md)[] | Returns массив дочерних элементов контрола.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#getAll). ||
|| [getChildElement](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControlParent.md#getChildElement)([child](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControlParent.md#getChildElement-param-child)) | HTMLElement | Возвращает для своего дочернего объекта HTML-элемент, в котором он должен размещаться.

Унаследован от [IControlParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControlParent.md#getChildElement). ||
|| [getContainer](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#getContainer)() | HTMLElement | Returns контейнер, в который добавляются дочерние элементы контрола.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#getContainer). ||
|| [getIterator](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#getIterator)() | [IIterator](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IIterator.md) | Returns итератор по коллекции.

Унаследован от [ICollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#getIterator). ||
|| [getLength](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#getLength)() | Number | Returns количество дочерних элементов.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#getLength). ||
|| [getMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md) | Returns ссылку на карту.

Унаследован от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap). ||
|| [getParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#getParent)() | [IControlParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControlParent.md) | Returns ссылку на родительский объект.

Унаследован от [IControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#getParent). ||
|| [getSelectedIndex](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.RadioGroup.md#getSelectedIndex)() | Number | Returns индекс выбранного элемента либо -1, если ни один элемент не выбран. ||
|| [indexOf](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#indexOf)([childToFind](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#indexOf-param-childToFind)) | Integer | Returns индекс дочернего элемента в группе.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#indexOf). ||
|| [remove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#remove)([item](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#remove-param-item)) | [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md) | Удаляет элемент управления из группы.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#remove). ||
|| [removeAll](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#removeAll)() | [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md) | Удаляет все дочерние элементы из группы.

Унаследован от [control.Group](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.Group.md#removeAll). ||
|| [setParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#setParent)([parent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md) | Устанавливает родительский объект.

Унаследован от [IControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#setParent). ||
|#

## Описание событий {#description-events}

### select

Выбран один из элементов группы. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• item - ссылка на выбранный элемент группы.

## Описание методов {#description-methods}

### getSelectedIndex

```javascript
{Number} getSelectedIndex()
```

**Returns** индекс выбранного элемента либо -1, если ни один элемент не выбран.