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

# YMaps.ControlPosition

Объект, задающий расположение элемента управления на карте.

Объект YMaps.ControlPosition может передаваться в качестве параметра в метод onAddToMap элемента управления.
# Конструктор

Имя | Описание
----- | -----
[YMaps.ControlPosition](controlposition.md#constructor)(anchor, offsets) | Задает расположение элемента управления на карте.


## Поля

Имя | Статическое | Описание
----- | ----- | -----
[BOTTOM_LEFT](controlposition.md#.BOTTOM_LEFT) | ![](../_images/check.png) | Константа, задающая привязку к левому нижнему углу.
[BOTTOM_RIGHT](controlposition.md#.BOTTOM_RIGHT) | ![](../_images/check.png) | Константа, задающая привязку к правому нижнему углу.
[TOP_LEFT](controlposition.md#.TOP_LEFT) | ![](../_images/check.png) | Константа, задающая привязку к левому верхнему углу.
[TOP_RIGHT](controlposition.md#.TOP_RIGHT) | ![](../_images/check.png) | Константа, задающая привязку к правому верхнему углу.

# Методы

Имя | Описание
----- | -----
[apply](controlposition.md#apply)(element) | Помещает элемент управления в заданную позицию на карте.

## Подробное описание конструктора {#constructor}

```javascript
YMaps.ControlPosition(anchor, offsets)
```

Задает расположение элемента управления на карте.

Необходимо указать угол карты, в котором будет располагаться элемент управления, а также отступы от границ карты.

**Пример:**

```javascript
// Помещает элемент управления в верхний левый угол карты. Отступ от левой границы карты 10, от верхней - 30 пикселов.
map.addControl(control, new YMaps.ControlPosition(YMaps.ControlPosition.TOP_LEFT, new YMaps.Point(10, 30)));
```

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`anchor` | Const | ![](../_images/check.png) | YMaps.ControlPosition.TOP_LEFT | Угол карты, в котором будет располагаться элемент.
`offsets` | [YMaps.Point](point.md) | ![](../_images/check.png) | new YMaps.Point(0, 0) | Отступы относительно заданного угла карты (в пикселах).

## Подробное описание полей {#field_detail}
### BOTTOM_LEFT {#BOTTOM_LEFT}

```javascript
BOTTOM_LEFT
```

Константа, задающая привязку к левому нижнему углу.
### BOTTOM_RIGHT {#BOTTOM_RIGHT}

```javascript
BOTTOM_RIGHT
```

Константа, задающая привязку к правому нижнему углу.
### TOP_LEFT {#TOP_LEFT}

```javascript
TOP_LEFT
```

Константа, задающая привязку к левому верхнему углу.
### TOP_RIGHT {#TOP_RIGHT}

```javascript
TOP_RIGHT
```

Константа, задающая привязку к правому верхнему углу.
## Подробное описание методов {#method_detail}

### apply {#apply}

```javascript
apply(element)
```

Помещает элемент управления в заданную позицию на карте.

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

Имя | Тип | Описание
----- | ----- | -----
`element` | HTMLElement | Указатель на HTML-элемент.