---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/default_controls.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/default_controls.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt

# Стандартный набор элементов управления

<iframe id="LIVE-EXAMPLE" style="width:100%;height: 400px;border-radius: 8px;border: 1px solid rgba(92, 94, 102, 0.14);" frameBorder="0" src="https://yastatic.net/s3/front-maps-static/maps-front-jsapi-v2-1/examples/2/out/s3-cases/ru/default_controls/index.html" allow="fullscreen"></iframe>

<a target="_blank" rel="noopener noreferrer" style="display: inline-block;margin-top: 10px;cursor: pointer;border-radius: 4px;padding: 9px 12px;background: #151515;color: white;text-decoration: none;font-weight: 500" href="https://codesandbox.io/p/sandbox/3fg4d2?file=index.html">Open in CodeSandbox</a>

<div id="references">
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ready">ready</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map">Map</a>
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.Manager">control.Manager</a>
</div>
<p>
    Каждый элемент управления реализуется отдельным классом из пространства имен control
    (например, <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.TrafficControl">control.TrafficControl</a>). Ссылка на элементы управления содержится в поле
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.Manager">controls</a> карты. Для добавления или удаления элемента управления используются методы add и remove соответственно.
</p>
<p>
    В API 2.1 добавлять элементы управления на карту можно также через ее <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map#constructor-summary">параметры</a>.
    Это означает, что при инициализации карты в поле controls можно указать ключ соответствующего элемента управления.
</p>
 <p>
     Добавлять можно как отдельные элементы управления, так и сразу их набор. В API 2.1 встроено три стандартных набора элементов управления, доступные
     по следующим ключам:
    <ul>
        <li>'smallMapDefaultSet';</li>
        <li>'mediumMapDefaultSet' (по умолчанию);</li>
        <li>'largeMapDefaultSet'.</li>
    </ul>
 </p>
<p>
    Наборы отличаются количеством входящих в них элементов управления, а также размером соответствующих кнопок. В зависимости от размеров карты может быть добавлен тот или иной набор.
При создании карты автоматически добавляется набор 'mediumMapDefault'. Однако, если карта достаточно больших размеров,
то целесообразно добавить 'largeMapDefaultSet'. Если при изменении размеров карты элементы управления
не будут помещаться на карте, API автоматически уменьшит их иконки.
</p>
<p>
    Подробнее о доступных наборах элементов управления см. в <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.Button">справочнике</a>.
</p>

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>
    <html>
        <head>
            <title>Стандартный набор элементов управления</title>
            <meta
                http-equiv="Content-Type"
                content="text/html; charset=utf-8"
            />
            <!--
            Укажите свой API-ключ. Тестовый ключ НЕ БУДЕТ работать на других сайтах.
            Получить ключ можно в Кабинете разработчика: https://developer.tech.yandex.ru/keys/
        -->
            
            
            
        </head>
        <body>
            <div id="map"></div>
        </body>
    </html>
    ```

-   default_controls.js

    ```js
    ymaps.ready(function () {
        var myMap = new ymaps.Map(
            "map",
            {
                center: [55.751574, 37.573856],
                zoom: 9,
                // Также доступны наборы 'default' и 'largeMapDefaultSet'
                // Элементы управления в наборах подобраны оптимальным образом
                // для карт маленького, среднего и крупного размеров.
                controls: ["smallMapDefaultSet"],
            },
            {
                searchControlProvider: "yandex#search",
            }
        );
    });
    ```

{% endlist %}
