---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/control.RouteButton.md
  - https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.RouteButton.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt

# control.RouteButton

Расширяет [IControl](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md), [ICustomizable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md).

Кнопка для построения маршрутов. При нажатии на кнопку появляется всплывающее окно, которое содержит поля ввода начальной и конечной точек маршрута. Элемент управления доступен в хранилище [control.storage](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.storage.md) по ключу "routeButtonControl".

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

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

```javascript
control.RouteButton([parameters])
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`parameters`](#param-parameters) | — | Тип: Object

Параметры элемента управления. ||
|| [`parameters.lazy`](#param-parameters.lazy) | true | Тип: Boolean

Если значение выставлено в true, будет включен режим ленивой загрузки – модули, которые необходимы для работы с маршрутизацией, начнут загружаться только тогда, когда пользователь впервые откроет панель. ||
|| [`parameters.options`](#param-parameters.options) | — | Тип: Object

Опции элемента управления. Используйте префикс 'routePanel', чтобы задать опции интерфейса [IRoutePanel](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IRoutePanel.md). ||
|| [`parameters.options.adjustMapMargin`](#param-parameters.options.adjustMapMargin) | false | Тип: Boolean

Регистрирует ли элемент управления свои размеры в менеджере отступов карты [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|| [`parameters.options.autofocus`](#param-parameters.options.autofocus) | true | Тип: Boolean

Указывает, должна ли панель маршрутизации автоматически получать фокус при открытии всплывающего окна. ||
|| [`parameters.options.collapseOnBlur`](#param-parameters.options.collapseOnBlur) | true | Тип: Boolean

Флаг, разрешающий сворачиваение панели при потере фокуса на элементе управления. ||
|| [`parameters.options.float`](#param-parameters.options.float) | "right" | Тип: String

Сторона, по которой нужно выравнивать элемент управления. Может принимать три значения: "left", "right" или "none". При значении "left" или "right" элементы управления выстраиваются друг за другом, начиная от левого или правого края карты соответственно. При значении "none" элементы управления позиционируется только по значениям опций left, right, bottom, top относительно границ карты. Также смотрите описание опции position. ||
|| [`parameters.options.floatIndex`](#param-parameters.options.floatIndex) | 0 | Тип: Number

Приоритет расположения элемента управления. Элемент с максимальным приоритетом находится ближе к указанному в свойстве float краю карты. Не работает при float = "none". ||
|| [`parameters.options.popupAnimate`](#param-parameters.options.popupAnimate) | true | Тип: Boolean

Флаг, указыващий, использовать ли анимацию при раскрытии/сворачивании всплывающего окна. ||
|| [`parameters.options.popupFloat`](#param-parameters.options.popupFloat) | 'auto' | Тип: Boolean

Определяет, по какому краю кнопки будет выравниваться всплывающее окно. Может принимать значения:
- 'auto' - всплывающее окно выравнивается в зависимости от своих размеров и размеров карты;
- 'right' – всплывающее окно выравнивается по правому краю кнопки;
- 'right' – всплывающее окно выравнивается по левому краю кнопки; ||
|| [`parameters.options.popupWidth`](#param-parameters.options.popupWidth) | '210px' | Тип: String

CSS-ширина всплывающего окна. Может задаваться как в пикселях, так и в процентах. Обратите внимание, что если указывать в процентах, ширина будет определяться относительно размеров кнопки, а не карты. Минимальное значение 176px, максимальное – 400px. ||
|| [`parameters.options.position`](#param-parameters.options.position) | — | Тип: Object

Объект, описывающий позицию элемента управления. ||
|| [`parameters.options.position.bottom`](#param-parameters.options.position.bottom) | 'auto' | Тип: Number\|String

Положение относительно нижнего края карты. ||
|| [`parameters.options.position.left`](#param-parameters.options.position.left) | 10 | Тип: Number\|String

Положение относительно левого края карты. ||
|| [`parameters.options.position.right`](#param-parameters.options.position.right) | 'auto' | Тип: Number\|String

Положение относительно правого края карты. ||
|| [`parameters.options.position.top`](#param-parameters.options.position.top) | 108 | Тип: Number\|String

Положение относительно верхнего края карты. ||
|| [`parameters.options.size`](#param-parameters.options.size) | 'auto' | Тип: String

Параметр, отвечающий за внешний вид элемента управления. Может принимать значения:
- 'auto' — макет автоматически изменяет свой внешний вид в зависимости от размеров карты и от количества добавленных элементов управления;
- 'small' – всегда показывается только иконка элемента управления, независимо от размеров карты;
- 'medium' – всегда отображается только подпись элемента управления;
- 'large' – отображаются и иконка, и подпись. ||
|| [`parameters.options.visible`](#param-parameters.options.visible) | true | Тип: Boolean

Признак того, что элемент управления отображается. ||
|| [`parameters.state`](#param-parameters.state) | — | Тип: Object

Объект, описывающий состояние элемента управления. ||
|| [`parameters.state.expanded`](#param-parameters.state.expanded) | false | Тип: Boolean

Показывается ли панель маршрута в данный момент. ||
|#


**Примеры:** 

**1.**

```javascript
// Пример 1.
// Создадим элемент управления "Маршруты" и добавим его на карту.
var routeButton = new ymaps.control.RouteButton({
    options: {
        size: "small"
    }
});
myMap.controls.add(routeButton);
```

**2.**

```javascript
// Пример 2
// Добавим элемент управления в левый угол карты
// и зададим начальную и конечную точки маршрута.
myMap.controls.add('routeButtonControl', {
    size: "large",
    float: "left",
    floatIndex: 1000,
});
myMap.controls.get('routeButtonControl').routePanel.state.set({
    fromEnabled: false,
    from: "moscow",
    to: "saint petersburg",
    type: "auto"
});
```

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

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

Унаследовано от [IControl](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#options). ||
|| [routePanel](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.RouteButton.md#routePanel) | [IRoutePanel](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IRoutePanel.md) ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [optionschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

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

Поля данных:

- oldParent - старый родитель;
- newParent - новый родитель.

Унаследовано от [IChild](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange). ||
|#

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getParent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#getParent)() | [IControlParent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControlParent.md)\|null | Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен.

Унаследован от [IControl](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#getParent). ||
|| [setParent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#setParent)([parent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта.

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

## Описание полей {#field_detail}

### routePanel {#routePanel}

```javascript
{IRoutePanel} routePanel
```

<!-- XLIFF_FARM_NjFjOGZi_CACHING -->