---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/zoom_layout.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/zoom_layout.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/zoom_layout/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/wh55cn?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.ZoomControl">control.ZoomControl</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/templateLayoutFactory">templateLayoutFactory</a>
</div>
<p>
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/layouts">Макеты</a> объектов можно создавать с помощью фабрики <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/templateLayoutFactory">templateLayoutFactory</a>, используя текстовые шаблоны.
</p>
<p>
    В данном примере создается пользовательский макет <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.ZoomControl">элемента управления масштабом карты</a>. Макет элемента управления строится на основе его данных, состояния и опций. Макет автоматически перестраивается при изменении значений полей, состояния или опций, которые используются в его текстовом шаблоне.
</p>
<p>
    В ответ на действия пользователя (клик мышкой по кнопке) макет может генерировать специальные события, описанные в его интерфейсе. Элемент управления слушает эти события на макете и пытается изменить свое состояние, данные или опции. После того, как элемент управления осуществил изменения, макет перестраивается на основе обновленных данных.
</p>
<p>
    Список событий, на которые реагирует ползунок маштаба, описан в интерфейсе <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IZoomControlLayout">IZoomControlLayout</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/
        -->
            
            <link
                href="https://yandex.st/bootstrap/2.2.2/css/bootstrap.min.css"
                rel="stylesheet"
            />
            
            
            
        </head>
        <body>
            <div id="map"></div>
        </body>
    </html>
    ```

-   zoom_layout.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map("map", {
                center: [55.751574, 37.573856],
                zoom: 9,
                controls: [],
            }),
            // Создадим пользовательский макет ползунка масштаба.
            ZoomLayout = ymaps.templateLayoutFactory.createClass(
                "<div>" +
                    "<div id='zoom-in' class='btn'><i class='icon-plus'></i></div><br>" +
                    "<div id='zoom-out' class='btn'><i class='icon-minus'></i></div>" +
                    "</div>",
                {
                    // Переопределяем методы макета, чтобы выполнять дополнительные действия
                    // при построении и очистке макета.
                    build: function () {
                        // Вызываем родительский метод build.
                        ZoomLayout.superclass.build.call(this);

                        // Привязываем функции-обработчики к контексту и сохраняем ссылки
                        // на них, чтобы потом отписаться от событий.
                        this.zoomInCallback = ymaps.util.bind(
                            this.zoomIn,
                            this
                        );
                        this.zoomOutCallback = ymaps.util.bind(
                            this.zoomOut,
                            this
                        );

                        // Начинаем слушать клики на кнопках макета.
                        $("#zoom-in").bind("click", this.zoomInCallback);
                        $("#zoom-out").bind("click", this.zoomOutCallback);
                    },

                    clear: function () {
                        // Снимаем обработчики кликов.
                        $("#zoom-in").unbind("click", this.zoomInCallback);
                        $("#zoom-out").unbind("click", this.zoomOutCallback);

                        // Вызываем родительский метод clear.
                        ZoomLayout.superclass.clear.call(this);
                    },

                    zoomIn: function () {
                        var map = this.getData().control.getMap();
                        map.setZoom(map.getZoom() + 1, {
                            checkZoomRange: true,
                        });
                    },

                    zoomOut: function () {
                        var map = this.getData().control.getMap();
                        map.setZoom(map.getZoom() - 1, {
                            checkZoomRange: true,
                        });
                    },
                }
            ),
            zoomControl = new ymaps.control.ZoomControl({
                options: { layout: ZoomLayout },
            });

        myMap.controls.add(zoomControl);
    }
    ```

{% endlist %}
