---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/placemark_balloon_layout.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/placemark_balloon_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/placemark_balloon_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/ztgpkl?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/Placemark">Placemark</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/ref/reference/templateLayoutFactory">templateLayoutFactory</a>,
    используя текстовые шаблоны.
</p>
<p>
    В данном примере создается пользовательский макет балуна <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject">геообъекта</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>
    ```

-   placemark_balloon_layout.js

    ```js
    ymaps.ready(init);

    function init() {
        var map = new ymaps.Map(
                "map",
                {
                    center: [55.650625, 37.62708],
                    zoom: 10,
                },
                {
                    searchControlProvider: "yandex#search",
                }
            ),
            counter = 0,
            // Создание макета содержимого балуна.
            // Макет создается с помощью фабрики макетов с помощью текстового шаблона.
            BalloonContentLayout = ymaps.templateLayoutFactory.createClass(
                '<div style="margin: 10px;">' +
                    "<b>{{properties.name}}</b><br />" +
                    '<i id="count"></i> ' +
                    '<button id="counter-button"> +1 </button>' +
                    "</div>",
                {
                    // Переопределяем функцию build, чтобы при создании макета начинать
                    // слушать событие click на кнопке-счетчике.
                    build: function () {
                        // Сначала вызываем метод build родительского класса.
                        BalloonContentLayout.superclass.build.call(this);
                        // А затем выполняем дополнительные действия.
                        $("#counter-button").bind("click", this.onCounterClick);
                        $("#count").html(counter);
                    },

                    // Аналогично переопределяем функцию clear, чтобы снять
                    // прослушивание клика при удалении макета с карты.
                    clear: function () {
                        // Выполняем действия в обратном порядке - сначала снимаем слушателя,
                        // а потом вызываем метод clear родительского класса.
                        $("#counter-button").unbind(
                            "click",
                            this.onCounterClick
                        );
                        BalloonContentLayout.superclass.clear.call(this);
                    },

                    onCounterClick: function () {
                        $("#count").html(++counter);
                        if (counter == 5) {
                            alert("Вы славно потрудились.");
                            counter = 0;
                            $("#count").html(counter);
                        }
                    },
                }
            );

        var placemark = new ymaps.Placemark(
            [55.650625, 37.62708],
            {
                name: "Считаем",
            },
            {
                balloonContentLayout: BalloonContentLayout,
                // Запретим замену обычного балуна на балун-панель.
                // Если не указывать эту опцию, на картах маленького размера откроется балун-панель.
                balloonPanelMaxMapArea: 0,
            }
        );

        map.geoObjects.add(placemark);
    }
    ```

{% endlist %}
