Popups | MapGL | 2GIS Documentation
MapGL JS API

Popups

Popup is a custom HTML element that is bound to a specific location on the map. To add a popup to the map, use the HtmlMarker() method and specify the coordinates and HTML markup:

const popup = new mapgl.HtmlMarker(map, {
    coordinates: [55.31878, 25.23584],
    html: `<div class="popup">
        <div class="popup-content">
            This is a text of the popup
        </div>
        <div class="popup-tip"></div>
    </div>`,
});

HTML element inside the popup can be customized with CSS as usual.

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>2GIS Map API</title>
        <meta name="description" content="Popup simple example" />
        <style>
            html,
            body,
            #container {
                margin: 0;
                width: 100%;
                height: 100%;
                overflow: hidden;
            }
            .popup {
                position: absolute;
                transform: translate(-50%, -100%);
                display: flex;
                flex-direction: column;
                min-width: 200px;
            }
            .popup-content {
                padding: 5px;
                border-radius: 4px;
                background: #fff;
                box-shadow: 0 1px 2px 0 rgba(38, 38, 38, 0.2);
            }
            .popup-tip {
                width: 0;
                height: 0;
                align-self: center;
                border-left: 10px solid transparent;
                border-right: 10px solid transparent;
                border-top: 10px solid #fff;
            }
        </style>
    </head>
    <body>
        <div id="container"></div>
        <script src="https://mapgl.2gis.com/api/js/v1"></script>
        <script>
            const map = new mapgl.Map('container', {
                center: [55.31878, 25.23584],
                zoom: 13,
                key: 'Your API access key',
            });

            const popup = new mapgl.HtmlMarker(map, {
                coordinates: [55.31878, 25.23584],
                html: `<div class="popup">
                    <div class="popup-content">
                        This is a text of the popup
                    </div>
                    <div class="popup-tip"></div>
                </div> `,
            });
        </script>
    </body>
</html>

You can add interactive elements inside the popup. To add a listener, use the getContent() method to get the HTML element inside the popup and then add the listener as usual:

const popup = new mapgl.HtmlMarker(map, {
    coordinates: [55.31878, 25.23584],
    html: `<div class="popup">
        <div class="popup-content">
            This is a text of the popup
            <button>Click me</button>
        </div>
        <div class="popup-tip"></div>
    </div>`,
});

popup
    .getContent()
    .querySelector('button')
    .addEventListener('click', () => alert('The button has been clicked!'));
<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>2GIS Map API</title>
        <meta name="description" content="Popup with button example" />
        <style>
            html,
            body,
            #container {
                margin: 0;
                width: 100%;
                height: 100%;
                overflow: hidden;
            }
        </style>
    </head>
    <body>
        <div id="container"></div>
        <script src="https://mapgl.2gis.com/api/js/v1"></script>
        <style>
            .popup {
                position: absolute;
                transform: translate(-50%, -100%);
                display: flex;
                flex-direction: column;
                min-width: 200px;
            }
            .popup-content {
                padding: 5px;
                border-radius: 4px;
                background: #fff;
                box-shadow: 0 1px 2px 0 rgba(38, 38, 38, 0.2);
            }
            .popup-tip {
                width: 0;
                height: 0;
                align-self: center;
                border-left: 10px solid transparent;
                border-right: 10px solid transparent;
                border-top: 10px solid #fff;
            }
        </style>
        <script>
            const map = new mapgl.Map('container', {
                center: [55.31878, 25.23584],
                zoom: 13,
                key: 'Your API access key',
            });

            const popup = new mapgl.HtmlMarker(map, {
                coordinates: [55.31878, 25.23584],
                html: `<div class="popup">
                    <div class="popup-content">
                        This is a text of the popup
                        <button>Click me</button>
                    </div>
                    <div class="popup-tip"></div>
                </div> `,
            });

            popup
                .getContent()
                .querySelector('button')
                .addEventListener('click', () => alert('Button has been clicked!'));
        </script>
    </body>
</html>

To show a popup after clicking on a Marker, you need to add three listeners: one on the Marker (to show the popup), and one each on the map and popup itself (to hide the popup).

const marker = new mapgl.Marker(map, {
    coordinates: [55.31878, 25.22438],
});

const popupHtml = popup.getContent();
hidePopup();

marker.on('click', () => (popupHtml.style.display = 'block'));

popupHtml.querySelector('.popup-close').addEventListener('click', hidePopup);
map.on('click', hidePopup);

function hidePopup() {
    popupHtml.style.display = 'none';
}
<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>2GIS Map API</title>
        <meta name="description" content="Marker with popup example" />
        <style>
            html,
            body,
            #container {
                margin: 0;
                width: 100%;
                height: 100%;
                overflow: hidden;
            }
        </style>
        <style>
            .popup {
                position: absolute;
                transform: translate(-50%, -150%);
                display: flex;
                flex-direction: column;
                min-width: 200px;
            }
            .popup-content {
                padding: 10px;
                border-radius: 4px;
                background: #fff;
                box-shadow: 0 1px 2px 0 rgba(38, 38, 38, 0.2);
            }
            .popup-close {
                position: absolute;
                top: 0;
                right: 0;
                padding: 0 5px;
                font-size: 12px;
                cursor: pointer;
            }
            .popup-tip {
                width: 0;
                height: 0;
                align-self: center;
                border-left: 10px solid transparent;
                border-right: 10px solid transparent;
                border-top: 10px solid #fff;
            }
        </style>
    </head>
    <body>
        <div id="container"></div>
        <script src="https://mapgl.2gis.com/api/js/v1"></script>
        <script>
            const map = new mapgl.Map('container', {
                center: [55.31878, 25.23584],
                zoom: 13,
                key: 'Your API access key',
            });

            const marker = new mapgl.Marker(map, {
                coordinates: [55.31878, 25.22438],
            });

            const popup = new mapgl.HtmlMarker(map, {
                coordinates: marker.getCoordinates(),
                html: `<div class="popup">
                    <div class="popup-content">
                        The click at the marker will open this popup again
                    </div>
                    <div class="popup-close">x</div>
                    <div class="popup-tip"></div>
                </div>`,
            });

            const popupHtml = popup.getContent();
            hidePopup();

            marker.on('click', () => (popupHtml.style.display = 'block'));

            popupHtml.querySelector('.popup-close').addEventListener('click', hidePopup);
            map.on('click', hidePopup);

            function hidePopup() {
                popupHtml.style.display = 'none';
            }
        </script>
    </body>
</html>

You can also pass an HTML element as the html parameter. For example, you can use a canvas with animation inside a popup:

const canvas = document.createElement('canvas');
canvas.width = 70;
canvas.height = 70;
canvas.style.position = 'absolute';
canvas.style.transform = 'translate(-50%, -50%)';
canvas.style.border = '1px solid';
canvas.style.background = '#fff';
const ctx = canvas.getContext('2d');

function render() {
    requestAnimationFrame(render);
    ctx.clearRect(0, 0, 70, 70);
    ctx.beginPath();
    const radius = (Date.now() / 70) % 35;
    ctx.arc(35, 35, radius, 0, Math.PI * 2);
    ctx.stroke();
}
requestAnimationFrame(render);

const popup = new mapgl.HtmlMarker(map, {
    coordinates: [55.31878, 25.23584],
    html: canvas,
});
<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>2GIS Map API</title>
        <meta name="description" content="HtmlMarker HTMLElement example" />
        <style>
            html,
            body,
            #container {
                margin: 0;
                width: 100%;
                height: 100%;
                overflow: hidden;
            }
        </style>
    </head>
    <body>
        <div id="container"></div>
        <script src="https://mapgl.2gis.com/api/js/v1"></script>
        <script>
            const map = new mapgl.Map('container', {
                center: [55.31878, 25.23584],
                zoom: 13,
                key: 'Your API access key',
            });

            const canvas = document.createElement('canvas');
            canvas.width = 70;
            canvas.height = 70;
            canvas.style.position = 'absolute';
            canvas.style.transform = 'translate(-50%, -50%)';
            canvas.style.border = '1px solid';
            canvas.style.background = '#fff';
            const ctx = canvas.getContext('2d');
            function render() {
                requestAnimationFrame(render);
                ctx.clearRect(0, 0, 70, 70);
                ctx.beginPath();
                const radius = (Date.now() / 70) % 35;
                ctx.arc(35, 35, radius, 0, Math.PI * 2);
                ctx.stroke();
            }
            requestAnimationFrame(render);

            const popup = new mapgl.HtmlMarker(map, {
                coordinates: [55.31878, 25.23584],
                html: canvas,
            });
        </script>
    </body>
</html>