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

# Layout for cluster balloon "Two columns"

<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/en/cluster_balloon_twoColumns/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/vslk9x?file=index.html">Open in CodeSandbox</a>

<div id="references">
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ready">ready</a>, <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Map">Map</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Clusterer">Clusterer</a>, <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ClusterPlacemark">ClusterPlacemark</a>, <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/templateLayoutFactory">templateLayoutFactory</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Placemark">Placemark</a>
</div>
    This examples uses the cluster balloon layout "cluster#balloonTwoColumns".<br/>
    This layout consists of two columns: a list of all geo objects, and information about the selected geo object.<br/>
    The information about the selected geo object is set by a separate layout <br/>
    and can be configured using the 'clusterBalloonItemContentLayout' option.<br/>
    This example sets a custom layout with information about a geo object.<br/>
<br/>
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/dg/concepts/layouts">Layouts</a><br/>
    for objects can be created using the <a href="https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/templateLayoutFactory">templateLayoutFactory</a> factory and text templates. <br/>
    Text templates generate the HTML content of the layout from the data hash passed to the layout constructor. <br/>
    In this example, the data provider is the geo object selected in the left column.

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>
    <html xmlns="http://www.w3.org/1999/xhtml">
        <html>
            <head>
                <title>
                    Examples. Customization of the "Two columns" cluster balloon
                    layout.
                </title>
                <meta
                    http-equiv="Content-Type"
                    content="text/html; charset=UTF-8"
                />
                <!--
            Set your own API-key. Testing key is not valid for other web-sites and services.
            Get your API-key on the Developer Dashboard: https://developer.tech.yandex.ru/keys/
        -->
                
                
                
            </head>
            <body>
                <div id="map"></div>
            </body>
        </html>
    </html>
    ```

-   cluster_balloon_twoColumns.js

    ```js
    ymaps.ready(function () {
        var mapCenter = [55.755381, 37.619044],
            map = new ymaps.Map("map", {
                center: mapCenter,
                zoom: 9,
                controls: [],
            });

        // Creating a custom layout with information about the selected geo object.
        var customItemContentLayout = ymaps.templateLayoutFactory.createClass(
            // The "raw" flag means that data is inserted "as is" without escaping HTML.
            "<h2 class=ballon_header>{{ properties.balloonContentHeader|raw }}</h2>" +
                "<div class=ballon_body>{{ properties.balloonContentBody|raw }}</div>" +
                "<div class=ballon_footer>{{ properties.balloonContentFooter|raw }}</div>"
        );

        var clusterer = new ymaps.Clusterer({
            clusterDisableClickZoom: true,
            clusterOpenBalloonOnClick: true,
            /**
             * Setting the mode for opening the balloon.
             * In this example, the balloon will never open in the panel mode.
             */
            clusterBalloonPanelMaxMapArea: 0,
            // Setting the size of the balloon content layout (in pixels).
            clusterBalloonContentLayoutWidth: 350,
            // Setting a custom layout.
            clusterBalloonItemContentLayout: customItemContentLayout,
            // Setting the width of the left column, which contains a list of all geo objects in the cluster.
            clusterBalloonLeftColumnWidth: 120,
        });

        // Populating the cluster with geo objects with random positions.
        var placemarks = [];
        for (var i = 0, l = 100; i < l; i++) {
            var placemark = new ymaps.Placemark(getRandomPosition(), {
                // Defining the data that will be displayed in the balloon.
                balloonContentHeader: "Placemark #" + (i + 1),
                balloonContentBody: getContentBody(i),
                balloonContentFooter: "Matsuo Bashō",
            });
            placemarks.push(placemark);
        }

        clusterer.add(placemarks);
        map.geoObjects.add(clusterer);

        function getRandomPosition() {
            return [
                mapCenter[0] + (Math.random() * 0.3 - 0.15),
                mapCenter[1] + (Math.random() * 0.5 - 0.25),
            ];
        }

        var placemarkBodies;
        function getContentBody(num) {
            if (!placemarkBodies) {
                placemarkBodies = [
                    [
                        "Lonely stillness",
                        "A single cicada’s cry",
                        "Sinking into stone",
                    ].join("<br/>"),
                    [
                        "Moonlight slanting",
                        "Through all this long bamboo grove ",
                        "And nightingale song.",
                    ].join("<br/>"),
                    [
                        "It is deep autumn",
                        "My neighbor",
                        "How does he live, I wonder.",
                    ].join("<br/>"),
                ];
            }
            return (
                "<strong>Body of the placemark #" +
                (num + 1) +
                "</strong><br/>" +
                placemarkBodies[num % placemarkBodies.length]
            );
        }
        clusterer.balloon.open(clusterer.getClusters()[0]);
    });
    ```

{% endlist %}
