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

# Собственный html-контент балуна метки

<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/balloon_html/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/7jwv27?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>
</div>
<p>
    Через <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject#constructor-summary">свойства и опции</a> геообъектов можно задавать содержимое для балуна и всплывающей подсказки, а также изменять их внешний вид.
</p>
<p>
    Содержимое балуна/всплывающей подсказки задается через свойства геообъекта:
<ul>
    <li>hintContent - содержимое всплывающей подсказки геообъекта;</li>
    <li>balloonContent - содержимое балуна геообъекта;</li>
    <li>balloonContentHeader - содержимое заголовка балуна геообъекта;</li>
    <li>balloonContentBody - содержимое основой части балуна геообъекта;</li>
    <li>balloonContentFooter - содержимое нижней части балуна геообъекта.</li>
</ul>
При задании содержимого можно использовать HTML-разметку.
</p>
<p>
Обратите внимание, через HTML-разметку можно задать только внутреннюю структуру балуна/всплывающей подсказки. Если нужно изменить их внешний вид, вам потребуется переопределить их макет с помощью фабрики <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/templateLayoutFactory">templateLayoutFactory</a>. Макет задается через опции геообъекта.
</p>
<p>
Фабрика макетов позволяет решить задачи:
<ul>
    <li>поменять форму балуна и всплывающей подсказки;</li>
    <li>сдвинуть относительно метки;</li>
    <li>изменить внешний вид крестика закрытия балуна;</li>
    <li>изменить внешний вид ножки балуна и др.</li>
</ul>
Чтобы понять, как работать с фабрикой макетов, посмотрите пример <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/balloon_autopan">Пользовательский макет балуна с поддержкой автопозиционирования</a>.
</p>

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>
    <html>
        <head>
            <title>Собственный html-контент балуна метки</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>
    ```

-   balloon_html.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map(
            "map",
            {
                center: [55.751574, 37.573856],
                zoom: 9,
                controls: [],
            },
            {
                searchControlProvider: "yandex#search",
            }
        );

        var placemark = new ymaps.Placemark(myMap.getCenter(), {
            // Зададим содержимое заголовка балуна.
            balloonContentHeader:
                '<a href = "#">Рога и копыта</a><br>' +
                '<span class="description">Сеть кинотеатров</span>',
            // Зададим содержимое основной части балуна.
            balloonContentBody:
                '<div class="emoji">🎬</div><br/>' +
                '<a href="tel:+7-123-456-78-90">+7 (123) 456-78-90</a><br/>' +
                "<b>Ближайшие сеансы</b> <br/> Сеансов нет.",
            // Зададим содержимое нижней части балуна.
            balloonContentFooter:
                'Информация предоставлена:<br/>OOO "Рога и копыта"',
            // Зададим содержимое всплывающей подсказки.
            hintContent: "Рога и копыта",
        });
        // Добавим метку на карту.
        myMap.geoObjects.add(placemark);
        // Откроем балун на метке.
        placemark.balloon.open();
    }
    ```

{% endlist %}
